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.
• We have revamped our dashboard settings UI. The Data API ID and Data API Key are available in the following navigations in the new and old UIs.
  • Revamped UI - You can access the Data API ID  in Settings -> Account -> APIs . The Data API ID is the same as the Workspace ID. The Data API Key is available in the same screen in the API Keys -> Data section.
  • Old UI -> You can access the Data API ID and Data API Key in Settings -> App Settings -> APIs -> Data API Settings.

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. Take 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.
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.

Configuration

Next, select Add Connector. You must name your connector and provide your MoEngage Data API and Data API key.

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.

Select Finish.

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

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 .