Tealium Collect Tag Setup Guide

[#1]

The Tealium Collect tag is the primary data collection tag for use with Tealium EventStream and AudienceStream. This article describes how to add and configure the Tealium Collect tag in your iQ Tag Management profile.

In this article:

• Requirements
• How it Works
• Tag Tips
• Tag Configuration
• Advanced
• Load Rules
• Working with Trace
• Implementing with Mobile

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. 
• DataAcces
  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.data on 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 Server 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 Enrichment
  
  • 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 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 Server field is blank and your data collection profile for AudienceStream is different from the current profile.
  • Default: (not set)
• Data Source Key (Optional)
  • The unique identifier of the data source you are tracking through Customer Data Hub.
  • Default: (not set)
• Data 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.
• Sampling Percent (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.
  • Default: true
• Use /event endpoint
  • Set to true to use the HTTP API endpoint (/event) instead of the visitor data enrichment endpoint (/vdata).
  • Default: 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's Android and iOS integration libraries, 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.