Tealium Collect Tag Setup Guide

Requirements

• Contact your account manager to enable this functionality for your account.

How it works

The Tealium Collect tag captures a mix of predefined data and dynamic data from the page. Using this tag, there is no need for mapping, the tag automatically sends everything set in utag.data or any data passed to a tracking call.

See the EventStore Data Guide for a full list of collected variables.

Learn more about Live Events to see the incoming data from the Tealium Collect tag.

Use the Tealium Collect tag with the following features:

• Reduce pixel requests with EventStream
  Use this tag with EventStream and event feeds to transition client-side tags to server-side connectors, such as the Webhook connector.
• AudienceStream
  Use this tag with AudienceStream to identify and take action on your visitors.
• DataAccess
  The event data coming from this tag can also be made available to DataAccess, where it can be analyzed using Business Intelligence (BI) tools of your choice.
• Enrich your data layer
  Use the data enrichment setting to add visit and visitor attributes from AudienceStream to your data layer.
  Learn more about data layer enrichment.

Tag tips

• This tag automatically sends all data in utag.dataon initial page load or any data object passed to utag.view() or utag.link().
• When using proxy tools to inspect network requests, look for the POST method (instead of GET).
• Specify a value in the Tealium Profile field only when Tealium Collect Endpoint field is blank and your server-side data collection profile is something other than the current profile.

Tag configuration

First, go to the tag marketplace and add the Tealium Collect tag (Learn more about how to add a tag).

After adding the tag, configure the following settings:

• Title
  • Enter a title for this tag.
  • Default: Tealium Collect
• Tealium Collect Endpoint (Optional)
  • Only for use with custom data collection endpoints.
  • Custom URLs entered into this field automatically default to HTTPS unless otherwise specified.
  • Default: (not set)
• Data Layer Enrichment Frequency
  • Enables AudienceStream data layer enrichment.
  • Choose the frequency for enriching your data layer with AudienceStream data.
    • None (default) – enrichment does not occur.
    • Infrequent– (recommended) enrichment occurs once per session.
    • Frequent– enrichment occurs on every page load.
• Tealium Collect Profile (Optional)
  • Use to override the existing data collection endpoint, such as the AudienceStream profile that receives data from your site.
  • Specify a value in this field only when the Tealium Collect Endpoint field is blank and your data collection profile for AudienceStream is different from the current profile.
  • Default: (not set)
• Tealium Data Source Key (Optional)
  • The unique identifier of the data source you are tracking through Customer Data Hub.
  • Default: (not set)
• Tealium Collection Region
  • The geographic location of the data collection servers.
  • Default: Global (recommended)
  • If you are not sure what to choose, contact your Account Manager.
• Sample Size (Optional)
  • Default: 100% (recommended)
  • Use this option during a trial on high volume sites to limit data collection to a small percentage of visitors.
• Use SendBeacon
  • Set to true to use navigator.sendBeacon() to send tracking calls.
  • Set to false to use the legacy browser method XMLHttpRequest to send tracking calls.
  • SendBeacon is intended for small amounts of data and has a data size limit of 64Kb in most browsers. For more infomrmation, see Navigator:sendBeacon() method.
  • Default: true
• Use HTTP API Endpoint
  • Set to true to use the HTTP API endpoint instead of the Tealium Collect endpoint.
  • Default: false
• Visitor Service Override
  • Specifies the domain used to retrieve visitor profile data from Tealium AudienceStream for data layer enrichment.
  • Enter a custom domain to override the default value.
  • This value is usually set to a first-party domain, such as visitor-service.yourdomain.com.
• Tealium Cookie Domain (Optional)
  • The domain used to set the Tealium anonymous ID (TAPID cookie).
  • Enter a custom domain to override the default value.
  • This value is usually set to a first-party domain, such as .yourdomain.com .
• Tealium Cookie Expiry (Optional)
  • The expiration time of the TAPID cookie in seconds.
• Filter data sent to the the Tealium Collect endpoint using the following settings:
  • Send UDO Variables - The default is true.
  • Send Cookie Values - The default is true.
  • Send Meta Values - The default is true.
  • Send QP Values - The default is true.
  • Send Session Storage Variables - The default is false.
  • Send LocalStorage Variables - The default is false.

Apply the following best practices in your implementation:

• To prioritize third-party client-side tags, position this tag last in your list of tags to allow them to run first.
• Do not add more than one instance of this tag in your profile.
• Use the latest version of the uTag Loader template. For more information, see Release Notes - utag.js.

Advanced

For first-party CNAME of the Tealium visitor service endpoint used for data layer enrichment, use a JavaScript Code extension scoped to the Tealium Collect tag to override the URL with the following code:

u.visitor_service_override = "https://visitor-service.example.co.uk";

Load rules

The best practice is to use the All Pages load rule to load this tag on all pages.

Working with trace

If you use a more restrictive load rule, and you’ve noticed that you can’t end a session in the trace tool, then a custom load rule is needed to allow the special event triggered by trace.

Create the following load rule and assign it to the Tealium Collect tag using the Match Any Rule option.

ut.event equals (ignore case) kill_visitor_session

Implementing with mobile

For deployments using Tealium for Android or Tealium for iOS, note the following:

• The default mobile publish settings enables the native mobile Tealium Collect service by default.
  Learn more about the native Collect module for mobile.
• When using the Tealium Collect tag with the Tag Management module for mobile, ensure that the Tealium Collect option in the mobile publish settings is off to avoid duplicate tracking.