Event Connectors

Event Connectors

by on ‎05-06-2016 05:39 PM - edited on ‎12-14-2017 06:48 PM by Community Manager (2,419 Views)

Event connectors give you the ability to leverage Event Feeds 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 Tealium Collect tag captures events on your site/app and sends them to the Universal Data Hub (UDH). The profile you add the tag to must match 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: 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 Event 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 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 Event Connector Actions

You have set up your desired actions and now it's time to test them. With the help of the Trace tool you can monitor which streams are activated by the Tealium 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"]