Tealium

AIRSHIP MAINTAINED INTEGRATION

This integration is maintained by Airship. Please contact Airship for support.

Tealium is a Customer Data Platform (CDP). CDPs collect, store, and normalize large volumes of data while creating a persistent identifier that spans across data sets. You can use the inbound and source integrations together or separately.

Inbound Integration
Use Tealium to set TagsMetadata that you can associate with channels or named users for audience segmentation. Generally, they are generally descriptive terms indicating user preferences or other categorizations, e.g., wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive. , AttributesMetadata that you can use for audience segmentation. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. , and deliver Custom EventsEvents that indicate that a user performed a predefined action, such as adding an item to a shopping cart, viewing a screen, or clicking an Unsubscribe button. Custom events can trigger automation, journeys, scenes, and surveys. You can code them into your app or website, or send them to Airship from an external source using the custom event API. Custom events contain properties that you can use to personalize messages. in Airship. This data is synced between Tealium and Airship using Named UserA customer-provided identifier used for mapping multiple devices and channels to a specific individual. .

Once in Airship, customers can segment based on those tags, events, and custom event properties, as well as trigger Automations and Journeys. Personalization using attributes and custom event properties is also supported.

Source Integration
Rich user-level App, SMS, Web, Email, and Open channel data is sent from Airship to Tealium using Real-Time Data StreamingA service that delivers engagement events in real time via the Data Streaming API or an Airship partner integration. . Tealium then transforms Airship data into traits and audiences, unifying users and content across different platforms. You choose which RTDS events to send to Tealium.

Tealium integration requirements

To get started, you must have accounts with both Tealium and Airship. Your Airship account must include messaging.

 Note

Named UserA customer-provided identifier used for mapping multiple devices and channels to a specific individual. is not a requirement but is strongly recommended for mapping users between Tealium and Airship. See: Associating Channels with Named Users.

Inbound integration setup

Before you configure the Airship Connector in Tealium, you must first create an access token and the tealium-integration tag group in Airship.

Create an Airship access token for Tealium

You must provide Tealium a token with the All Access role so that it can communicate with your Airship project.

  1. In Airship, go to Settings » Project Configuration and click Manage for Tokens.
  2. Click Create Token.
  3. Enter a token Name. This is just a friendly name to help you recognize your tokens in Airship.
  4. Select the All Access role.
  5. Click Create Token.
  6. Copy the values for App Key and Access Token, then click Got it to close the window. You’ll use these values when configuring the integration in Tealium in the next section.

Add a new connector for Airship in Tealium

Follow the Tealium documentation to add a new connector for Airship and configure its settings.

Create the Tealium tag group

To assign tags to Airship using the Add Tags and Remove Tags actions in Tealium, you must create an Airship tag group with the group key tealium-integration.

Follow the steps in Creating custom tag groups using these settings:

  • Name — Choose something easily understandable and that describes the associated database, e.g., “Tealium Integration.”
  • Description — The description should supplement the name, giving additional information about the tag group, if necessary. Be descriptive enough that anyone in your company would understand its source and purpose.
  • Group Key — Enter tealium-integration. This permanent, unique ID is the text you will use when referring to your tag group in the API.
     Warning

    Do not enable the Allow these tags to be set only from your server setting. Enabling this setting prevents Tealium from setting tags in Airship.

Source integration setup

To set up this integration, you will:

  1. Configure your app to set the tealium_visitor_id on Airship events. See the Kotlin and iOS setup sections below for more information.
  2. Add Airship to Tealium as a source and retrieve your Data Source Endpoint.
  3. Set up the RTDS integration for Tealium in the Airship dashboard.

When you set up a Tealium RTDS integration, your events will contain a tealium_visitor_id key. This is the identifier Tealium uses to differentiate between unique events. As a fallback, you may want to set your Airship Named UserA customer-provided identifier used for mapping multiple devices and channels to a specific individual. value to tealium_visitor_id to ensure that events are matched within Tealium.

Set the tealium_visitor_id on Airship events

Kotlin SDK example
// Initialize the Tealium library
TealiumConfig tealiumConfig = TealiumConfig(
    application,
    {ACCOUNT},
    {PROFILE},
    {ENVIRONMENT},
    dataSourceId = {DATASOURCE_ID},  //optional
    modules = mutableSetOf(VisitorService),
    dispatchers = mutableSetOf(TagManagement, Collect)
  );
Tealium tealium = Tealium.create("tealium_instance", tealiumConfig);
// Get the Tealium visitor ID
String visitorId = tealium.getVisitorId();

// Add the visitor ID to the current associated identifiers
UAirship.shared().getAnalytics()
  .editAssociatedIdentifiers()
  .addIdentifier("tealium_visitor_id", visitorId)
  .apply();

See also: Tealium Kotlin Identity Resolution documentation.

Swift SDK example
// Initialize the Tealium library
let config = TealiumConfig(account: {ACCOUNT},
               profile: {PROFILE},
               environment: {ENVIRONMENT},
               datasource: {DATASOURCE})
let tealium = Tealium(config: config)
// Get the Tealium visitor ID
let visitorId = tealium.visitorId

// Add the visitor ID to the current associated identifiers
let identifiers = Airship.analytics.currentAssociatedDeviceIdentifiers()
identifiers.set(identifier: visitorId, key:"tealium_visitor_id")
Airship.analytics.associateDeviceIdentifiers(identifiers)

See also: Tealium Swift Identity Resolution documentation.

Add Airship to Tealium as a source

You will also retrieve your Data Source Endpoint URL.

  1. Log in to Tealium.

  2. In the left-hand navigation menu, click Sources then Data Sources, which will take you to a page where you can add Airship as a data source.

  3. Click Add Source and scroll to the Communication section. Click the Airship tile.

  4. Enter a name for your Airship source integration.

  5. Click Continue until you reach the Choose Event Specifications page.

     Note

    The event specifications currently do not support Airship-specific events. Tealium may add these in the future. For now, you can ignore the event specifications.

  6. Click Continue to proceed to the Get Code page.

  7. Copy the Data Source Endpoint URL. You will paste this in the Airship dashboard when setting up the RTDS integration.

     Note

    The Install steps listed in the Tealium Get Code page are the same as provided in the next section on this page. Please read the steps on this page for information not provided by Tealium.

Set up a Tealium RTDS integration in Airship

You will need your Tealium Data Source Endpoint URL to set up the integration in Airship.

  1. Go to Settings » Project Configuration and click Manage for Real-Time Data Streaming.

  2. Under Real-time Data Streaming, click Tealium.

  3. Enter a Name and Description for this integration. This helps you identify the integration later.

  4. Enter your Tealium Data Source Endpoint URL.

  5. (Optional) Check the box to Include Anonymous Data.

    Events that have a tealium_visitor_id, named user, or delivery_address (phone number/MSISDN/email) are delivered to Tealium by default.

    When electing to send anonymous data, Airship sends all events to Tealium regardless of whether the user is identified with a Visitor ID or Secondary Visitor ID.

  6. Choose the event types to send to Tealium.

  7. Click Activate.

See also: Tealium documentation: Airship Incoming Webhook Setup Guide.