Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Integrate Tealium

Import you Tealium AudienceStream audiences into Optimizely Data Platform (ODP).

πŸ‘

Beta

Tealium AudienceStream for Experiment and CMS is in beta. Apply on the Optimizely beta signup page or contact your Customer Success Manager.

Import your Tealium AudienceStream audiences to Optimizely Data Platform (ODP) as real-time segments. Then integrate with Optimizely Web Experimentation, Optimizely Feature Experimentation, or Optimizely Content Management System (CMS) Visitor Groups for advanced audience targeting.

Considerations

  • This integration leverages Tealium’s Webhook Connector to sync your Tealium audiences to ODP, where ODP converts the audiences to real-time segments.
  • You can select your preferred customer identifier in Tealium to pass to ODP.
  • Audience changes reflect in real time.

Enable the integration in ODP

  1. In ODP, go to the App Directory.

  2. Select the Tealium app.

  3. Click Install App.

  4. On the Settings tab, copy the URL, Username, and Password that displays.

Create activations in Tealium

You need to set up two activations in Tealium: one that adds new members to your ODP real-time segment when they join your Tealium audience, and another that removes users from your ODP real-time segment who have left your Tealium audience.

Create activation to add users

  1. In Tealium, go to AudienceStream > Audiences.

  2. Select the audience you want to connect to ODP, then select the Activations tab.

  3. Click Add Activations.

  4. Select the Webhooks option and click Continue.

  5. In the Source section, complete the following:

    • Audience – Select the audience you want to connect.
    • Trigger – Select Joined Audience.
    • Frequency Cap – Set to Off.
  6. Click Continue.

  7. In the Configuration section, click Add Connector, and complete the following:

  8. Click Done, and then click Continue.

  9. In the Action section, complete the following:

    • Action Name – Enter your desired action name (for example, Recent Visitors - Joined).
    • Action Type – Select Send Customized Data via HTTP Request (Advanced).
    • Method – Select POST.
    • URL – Paste the URL you copied from ODP (see step 4 of Enable the integration in ODP).
    • Body Content Type – Select application/json.
    • Body Data – Click Add Mapping and enter the following:
      • Map – {{optimizely_vid}}
      • To – Body
    • Template Variables – Click Add Mapping, once for each of the following two mappings:
      • Map and To – For Map, select the Tealium identifier you want to pass to ODP to represent audience members, and for To, select tealiumUserId
      • Map and To – Recent Visitors and audienceId
    • Templates – Enter the following:
      • Name – optimizely_vid
      • Template –
        {
          "tealiumUserID": "{{tealiumUserId}}",
          "audienceName": "{{audienceId}}",
          "audienceId": "{{audienceId}}",
          "action": "subscribe"
        }
        
  10. Click Finish.

Create activation to remove users

  1. In Tealium, click the vertical ellipsis next to the activation you just created to add users.

  2. Select Duplicate.

  3. Edit the duplicated activation as follows:

    • In the Source section, change the Trigger to Left Audience.
    • In the Action section:
      • Change the Action Name to specify that this activation is for removing visitors who have left (for example, Recent Visitors - Left).
      • Expand the Templates section and in the Template, change subscribe to unsubscribe so that it displays as follows:
        {
          "tealiumUserID": "{{tealiumUserId}}",
          "audienceName": "{{audienceId}}",
          "audienceId": "{{audienceId}}",
          "action": "unsubscribe"
        }
        
  4. Click Finish.

When you are done creating the two activations, save and publish your Tealium AudienceStream profile.

Connect additional Tealium audiences

If you want to connect additional Tealium audiences, duplicate both of the activations you created in the initial setup, then make the following changes:

  • In the Source section, select the desired Audience.
  • In the Action section:
    • Template Variables – Update both Map values to the intended identifiers for tealiumUserId and audienceId, if different from the previous setup.
    • Templates – In the Template, ensure the action value is set appropriately (subscribe for joining the audience or unsubscribe for leaving the audience).