Requirements

• Tealium Customer Data Hub account

How it Works

The Tealium Collect extension for Adobe Experience Platform Launch sends all your events and corresponding data along to Tealium for use with Tealium Customer Data Hub. The Tealium Collect extension for Adobe Experience Platform Launch is a custom template that loads the Tealium Collect JavaScript file from the Tealium CDN once per page.

For each triggered event, the tag automatically flattens the digitalData object into key-value pairs and posts the data to the Tealium Collect endpoint. A custom endpoint may be specified if you use first-party data collection.

Learn how data layer variables are flattened in the data layer.

Install

Tealium Collect

To install the Tealium Collect extension:

1. Go to the Adobe Experience Platform Launch Marketplace.
2. In the Extensions menu, click on the Catalog tab and search for the “Tealium Collect” extension.
3. Click Install.
4. Set the following configuration options and then click Save to Library:
   
   • Tealium Account (required): Your Tealium account name.
   • Tealium Profile (required): Your Tealium profile name.
     
   • Data Source Key (optional): The data source key from your server-side Tealium configuration.
     
   • Endpoint (optional): Override the Tealium Collect endpoint with your first-party data collection endpoint, such as https://collect.example.co.uk/event.
     
   • Data Object (optional): The custom JavaScript variable to use instead of the global dataLayer object.

Create the rules to fire the Tealium Collect extension. The following example runs the extension for the page view event.

Data Layer Enrichment

The Tealium Data Layer Enrichment extension brings server-side attributes from Tealium AudienceStream and injects them into the data layer.

To install the Data Layer Enrichment extension:

1. Search for the “Tealium Data Enrichment” extension in the Adobe Extension Catalog.
2. Click the Install button to add the extension.
3. Add a Rule and Action for “Tealium Data Enrichment”

4. Mouse over an installed extension and click Configure, the set the following options:

   • Tealium Account (required): Your Tealium account name.
   • Tealium Profile (required): Your Tealium profile name.
     
   • Data Source Key (optional): The data source key from your server-side Tealium configuration.
     
   • Endpoint (optional): Override the Tealium Collect endpoint with your first-party data collection endpoint, such as https://collect.example.co.uk/event.
     
   • Data Object (optional): The custom JavaScript variable to use instead of the global dataLayer object.

5. Create a new data element in Adobe Launch to read the data in local storage.

The object is stored in localStorage under the key teal_adobe_enrichment_data. Fetching the key returns the DLE object. The following example retrieves the DLE object from localStorage, then stores all the audiences in an array:

var dle_object = JSON.parse(localStorage.getItem(
   "teal_adobe_enrichment_data"));

var data = {audiences: []};
if (dle_object.audiences) {
  for (var id in dle_object.audiences) {
    if (dle_object.audiences.hasOwnProperty(id)) {
     data.audiences.push(id);
    }
  }
}

Track

The direct call events from _satellite.track are processed by Tealium Collect. The first parameter is set to the variable tealium_event in the data layer. The second parameter contains the additional data layer attributes sent along to the Tealium Collect endpoint.

The following example is a direct call for the event contact_submit. We recommend a data layer of key-value pairs, but you may also pass a nested adobeDataLayer object.

_satellite.track('contact_submit', { name: 'John Doe' });

The resulting event in Tealium Collect is:

{
  "tealium_event" : "contact_submit",
  "name" : "John Doe"
}

In addition to the event parameters, the values found in _satellite.buildInfo are also included in the data layer for direct call event tracking.

turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z",
environment: "development"

If the data layer object contains nested values, it is automatically flattened before it is sent to the Tealium Collect endpoint.

Learn more about the Adobe Experience Platform Launch object reference.

Source Code

If you are a developer and require a custom implementation, download the extension code and modify it as needed.