Tealium EventStream (server-side)

Overview

This guide outlines the steps for integrating a retailer with Symbiosys server-side using Tealium’s EventStream (connector) product. Note that this method requires that you are using Tealium iQ as your tag manager.

Determine Endpoint and Authentication Credentials

Use one of the following endpoints:

• U.S.-based retailers:

  • Testing: https://event.symbiosys.dev

  • Production: https://event.symbiosys.ai

• Europe-based retailers:

  • Testing: https://eu.event.symbiosys.dev

  • Production: https://eu.event.symbiosys.ai

Setting Up Tealium EventStream

If you are already using Tealium EventStream to send events, skip this step. If you are only using Tealium iQ, you need to set up a server-side Customer Data Hub to enable EventStream.

As part of this process, install the Tealium Collect tag in your Tealium iQ tag set. The Collect tag sends data to EventStream, which can then be forwarded to Symbiosys using the connector described in the next step.

Configure Symbiosys Connector

To configure the connector that forwards relevant events to Symbiosys, follow the Tealium documentation to set up a webhook connector. This is a connector with an action type of “Send Customized Data via HTTP Request”. We require two separate connectors: one for Page Views and one for Orders.

1. Page View Connector listens for product_view & direct cart_add events. 

   1. Data Source: All Data Sources

   2. Event Feed: product details page views, and any product that may have been directly added to the cart.

   3. Title: “Symbiosys Page View Connector”

   4. Auth: BasicAuth (these will be unique for each Banner)

      1. Username: <obtain username from Symbiosis>

      2. Password: <obtain password from Symbiosis>

e. Action Name: Symbiosis Page View Action

f. Action Type: Send Customized Data via HTTP Request (Advanced)

g. Method: POST

h. URL: https://event.symbiosys.ai/page_view_basic_auth

i. URL Parameters: n/a

j. Headers: n/a 

k. Cookies: n/a 

l. Body Content Type: application/json

m. Details for mapping Template Variables: 

i. channel: string (default: google; supported: google, meta, pinterest)

ii. platform: string (default: website; supported: website, app) 

iii. user_agent: string 

iv. user_ip: string

v. origin_url: string (URL of the page hosting the ad) 

vi. page_view_url: string (URL of the PDP landing page the user is directed to after clicking ad)

vii. page_view_ts: integer (timestamp) 

viii. session_id: string (unique identifier scoped to a web or app session) 

ix. visitor_id: string (unique, sticky-across-web-and-app user identifier) 

x. email_hash: string (sha256-hashed, lowercased user email address)

xi. crm_id: string (unique hashed identifier that is mapped to a logged in user; can be hashed email)

xii. external_campaign_id: string (the external channel campaign ID)

xiii. product_id: string (product id that maps to the product that was clicked) 

xiv. channel_click_id: string (e.g., gclid, fbclid)

n. Template: (template variables may not match your values from your data layer). 

{ 
  "channel": "{{channel}}", 
  "platform": "{{platform}}", 
  "user_agent": "{{user_agent}}", 
  "user_ip": "{{user_ip}}", 
  "origin_url": "{{origin_url}}", 
  "page_view_url": "{{page_view_url}}", 
  "page_view_ts": "{{page_view_ts}}", 
  "session_id": "{{session_id}}", 
  "visitor_id": "{{visitor_id}}", 
  "email_hash": "{{email_hash}}", 
  "crm_id": "{{crm_id}}", 
  "external_campaign_id": "{{external_campaign_id}}", 
  "product_id": "{{product_id}}", 
  "channel_click_id": "{{channel_click_id}}" 
}

o. Example:

{
  "channel": "google",
  "platform": "website",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
  "user_ip": "127.0.0.1",
  "origin_url": "google.com",
  "page_view_url": "https://www.retailer.com/Home-Garden/4-Dracaena-Artifici al-Plant-in-Sand-Colored-Planter-Real-Touch/19532623/",
  "page_view_ts": "1712171851",
  "session_id": "1441822044558",
  "visitor_id": "014fb34a718e001ad754191d58ff1c074003a06c00c48",
  "email_hash": "73062d872926c2a556f17b36f50e328ddf9bff9d403939bd14b6c3b7 f5a33fc2",
  "crm_id": "876bbfea39cc45dead43d00e40cef147",
  "external_campaign_id": "317294",
  "product_id": "19532623",
  "channel_click_id": "zxck87hwbasduuvgaosdf_afl"
}