Event stream

Introduction

Tealium EventStream is a data collection and API hub that sits at the center of your data. EventStream handles the entire data supply chain from setup and installation to identifying, validating, and enhancing incoming user data. EventStream takes real-time action with event feeds and connectors.

Integration 

This integration forwards data from Tealium to the MoEngage's data APIs.

 

PREREQUISITES

  • Login credentials for MoEngage and Tealium account.
  • Data integration for Tealium - You must install the libraries into your app, site, or server before being able to set up a successful Tealium connector.
  • MoEngage data API and data key - You can access this from MoEngage dashboard Settings >> APIs

 

Step 1: Set up a Source

Tealium requires that you first set up a valid data source for your connector to draw from.

  1. From the left sidebar in Tealium under Server-Side, navigate to Sources > Data Sources > + Add Data Source.
  2. Locate HTTP API platform within the available categories, and name your HTTP API app, this is a required field.
  3. From the Event Specifications options, choose the event specs  you would like to include. Event specifications help you identify the event names and required attributes to track in your installation. These specifications will be applied to incoming events. event_specs.pngTake some time to think about what data is most valuable to you and which specifications seem most appropriate for your use case. Custom event specifications  are also available.
  4. The next dialogue advances to the Get Code step. The base code and event tracking code provided here serve as your installation guide. Download the provided PDF if you wish to share these instructions with your team. Select Save & Continue once finished.get_code.png
  5. You will now be able to view your saved source as well as add or remove event specs. 

Step 2: Create an event connector

A connector is an integration between Tealium and any another vendor used to transmit data. These connectors contain actions that represent their partner’s supported APIs.

  1. From the left sidebar in Tealium under Server-Side, navigate to EventStream > Event Connectors.
  2. Select the + Add Connector button to look through the connector marketplace. In the new dialogue box that appears, search for MoEngage connector.
  3. Once clicked, you can view the connection summary and a list of the required information, supported actions, and configuration instructions. Configuration comprises four steps: source, configuration, action, and summary.

Source

In the dialogue that opens, select the data source you just built, and under Event Feed, select All Events or a specific event spec, if needed. Click Continue. Screenshot_2022-02-18_at_2.06.45_PM.png

Configuration

Next, select Add Connector. You must name your connector and provide your MoEngage Data API and Data API key Screenshot_2022-02-18_at_2.06.58_PM.png

If you have created a connector before, you may optionally use an existing one from the available connector list and modify it to fit your needs with the pencil icon or delete it with the trash icon.

Action

Next, name your connector action and select an action type that will send data according to the mapping you configure. Here, you will map MoEngage attributes to Tealium attribute names. Depending on which action type you choose, there will be a varied selection of fields required by Tealium.

Screenshot_2022-02-18_at_2.09.37_PM.png

Parameters  Description 
Customer ID

The unique identifier which is set and passed on from MoEngage SDK.

Name

The name of the user you are updating.

First Name

First name of the user.

Last Name

Last name of the user.

Email

Email of the user.

Age

Age of the user.

Gender

Male or female.

Case-sensitive.

Mobile

Phone number of the user.

Geography

Location of the user, latitude and longitude (- lat,lng).
Must be an array of numbers attribute type.

Source

Acquisition source of the user.

Created Time

User created time.

Last Seen

User last seen time.

Transactions

Number of transactions by the user.

Revenue

Lifetime value of the user.

Platform

The current platform on which the user is interacting with the system, such as Android, Windows, iOS, etc.

Select Finish.

Your connector now displays in the list of connectors on your Tealium home page.

Screenshot_2022-02-18_at_2.18.19_PM.png

Step 3: Test your Tealium connector

After your connector is up and running, you should test it to ensure it’s working properly. The most simple way to test this is to use the Tealium Trace Tool.

  1. To start a new trace, select Trace on the left sidebar under Server-Side options.
  2. Examine the real-time log.
  3. Check for the action you want to validate by clicking the Actions Triggered entry to expand.
  4. Look for the action you want to validate and view the log status.

For more detailed instructions on implementing Tealium’s Trace tool, check out their trace documentation .

  Limitations

Only Connector action - Add/Modify User Information is supported by Tealium. 

Was this article helpful?
0 out of 0 found this helpful