Tealium Collect Tag Setup Guide
The Tealium Collect tag is the primary data collection tag for Tealium EventStream and AudienceStream. This article explains how to add and configure the Tealium Collect tag in your iQ Tag Management profile.
Requirements
- Contact your account manager to enable this tag for your account.
How it works
The Tealium Collect tag captures a mix of predefined data and dynamic data from the page. This tag requires no mapping; it automatically sends everything set in utag.data
or any data passed to a tracking call.
For a full list of collected variables, see EventStore data guide.
To see the incoming data from the Tealium Collect tag, see Live Events.
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 action 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.
To learn more, see (Enable Data Layer Enrichment).
Tag tips
- This tag automatically sends all data in
utag.data
on initial page load or any data object passed toutag.view()
orutag.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 the 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 usenavigator.sendBeacon()
to send tracking calls. - Set to
false
to use the legacy browser methodXMLHttpRequest
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
- Set to
- 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
.
- Send UDO Variables: The default is
Best practices
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 and Events load rule. Loading this tag on all pages ensures that all events are tracked server-side, which allows for full activation of both event and audience data. Using custom load rules on this tag limits the data that can be activated server-side and is not recommended.
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, 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.
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.
Legacy cookies
For compatibility reasons, the Tealium Collect tag creates the following legacy cookies:
utag_main_dc_event
: a duplicate of theutag_main__se
Session Event cookie.utag_main_dc_visit
: a duplicate of theutag_main__sn
Session Number cookie.
For more information about these cookies, see Data Layer: Cookies.
This page was last updated: June 25, 2024