EventStream Connectors

EventStream Connectors

by on ‎05-06-2016 05:39 PM - edited on ‎09-27-2017 09:30 AM by (1,883 Views)

EventStream Connectors give you the ability to leverage Streams for taking action on events such as product page views, add to cart actions, or newsletter signups, etc. These actions occur in a cloud-based delivery service instead of client-side (ie. in your mobile app or website).

Table of Contents Placeholder

Prerequisites

  • Tealium Collect Tag - The Collect Tag captures events on your site/app and sends them to the Universal Data Hub. Add the Tag to your Tealium iQ profile and have it load on "All Pages". Make sure the profile you are adding the Tag to matches the data collection profile in UDH. Optionally, you can use the Visitor Data Enrichment service to send data to be used with EventStream.
  • EventStream activated - Contact your Tealium account manager to activate.
  • Active Stream: Filtered Streams are enabled through Live Events. Either use the default All Events or create a Stream based on specific event attributes.
  • Supported Vendor Account - An active account with a vendor that supports cloud delivery.

Trigger Actions Using Streams

Step 1: Add an EventStream Connector

  1. From the top navigation click Act > Connectors Marketplace
  2. In the side navigation, select the filter By Enrichment: Events
  3. Select a Connector and click Add Connector

Step 2: Configure an Action

  1. On the Configure tab enter required fields and click Next
  2. From the Actions list, select the desired action and click Add Action
  3. Enter a name for the action
  4. From the Source list, select your desired Event Stream 

    "All Events" is available by default. Custom Streams appear after adding them via Live Events.

  5. Map data values to be sent to the vendor. The mapping destinations will vary depending on the Connector.
  6. Click Save

Step 3: Save/Publish your profile 

The Action will trigger as data flows into the Streams selected.

Validating EventStream Actions

You have set up your desired Actions and now it's time to put them to test. With the help of Trace tool you can monitor which Streams are activated by the Collect Tag, which Actions are triggered, and what data is collected in the process. Let's walk through a simple exercise to trigger a GET Action in Webhook and have it triggered by a sample stream.

Step1: Add a new Stream and title it 'Test Event A'.

Set up a Tealium iQ filter condition: "customer_email" is assigned. This condition is met when the Data Source is found on the page.

Test Event A.png

 

Step 2: Add the Webhook Connector and create a GET Action. Select 'Test Event A' as the trigger source.

Get Source.png

Step 3: Save/publish your profile.

Step 4: Start a new Trace in AudienceStream and navigate to your site.

Trace will start displaying all the configurations and processes that are being evaluated behind the scenes.

Step 5: In the reporting screen, check if your target Stream 'Test Event A' was picked up by the Collect Tag.

stream in trace.png

 

Step 6: Check to see if the GET Action was triggered successfully.

action in trace.png

Sending Array Data

  • Some Connectors will support a data layer Array of items in a URI-Encoded JSON format
  • The expected format for a list of items (Array) would be as follows:
    • &product_id=%5B%22prod1%22%2C%22prod2%22%2C%22prod3%22%5D
    • This sends an array of ["prod1","prod2","prod3"]
  • A product with a comma as part of the product name would need to be double-encoded in a form such as:&product_id=%5B%22pro%252Cd1%22%2C%22prod2%22%2C%22prod3%22%5D
    • Notice the %252C in prod1which double-encodes the comma which is regularly %2C
    • This sends an array of ["pro%2Cd1","prod2","prod3"]