ADOBE LAUNCH

Install

Requirements

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

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 your configuration options, and then click Save to Library

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. In Adobe Experience Platform Launch, search for “Tealium” in the Extensions catalog
  2. Install the “Tealium Data Enrichment” extension
  3. Set your configuration options, and then click Save

Configure

After adding the extension, configure the following settings. Leave optional fields blank if the value is unknown.

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

adobe-launch-configure.png

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

adobe-launch-rules.png

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.

Data Layer