• Platforms
  • Partners
  • Forums
  • TLC Tealium Learning Center Tealium Learning
    Community
  • Discussions & Ideas Dicussions & Ideas
  • Product Guides Product Guides
  • Knowledge Base Knowledge Base
  • Developer Docs Developer Docs
  • Education Education
  • TLC Blog TLC Blog
  • Support Desk Support Desk
  • CDH Customer Data Hub Customer Data Hub

Table of Contents

  • Requirements
  • How it Works
  • Install
    • Add New Tag
    • Triggers
  • Validation
GOOGLE TAG MANAGER

Install

Learn to install Tealium Collect for Google Tag Manager.

Requirements

  • Tealium Customer Data Hub account

How it Works

The Tealium Collect Tag (Beta) for Google Tag Manager (GTM) is a custom template that loads the Tealium Collect JavaScript file from the Tealium CDN once per page.

For each tag triggered event, the tag automatically flattens the dataLayer object into key-value pairs and posts the data to Tealium’s data collection endpoint. A custom endpoint may be used if you use first-party data collection.

The following GTM event is prior to being flattened:

dataLayer.push({
  'ecommerce': {
    'purchase': {
      'actionField': {
        'id': 'T12345',
...

After being flattened, it becomes the following Tealium event:

"tealium_event": "purchase"
"ecommerce.purchase.actionField.id": "T12345"
...

Install

To add the Tealium Collect Tag (Beta) via Google Tag Manger

  1. In Google Tag Manager, click Templates in the left navigation.
  2. On the Tag Templates screen, click Search Gallery.
  3. Search for and select “Tealium Collect Tag (Beta)”.
  4. Add the template by clicking Add to workspace.
  5. On the “Are you sure you want to add a community template?” screen, click Add

Add New Tag

To add an instance of the Tealium Collect Tag:

  1. In Google Tag Manger, click Tags in the left navigation.
  2. Click the New button.
  3. Click “Tag Configuration” to choose a tag type. Search and select “Tealium Collect Tag (Beta)” from the list.
  4. Provide a name for the tag to replace the text “Untitled Tag”.

After adding the Tag, configure the following settings. Leave optional fields blank if the value is unknown.

  • Tealium Account (required): The Tealium account name. For example, companyXYZ.
  • Tealium Profile (required): The Tealium profile name. For example, main.
  • Tealium Data Source Key (optional): The data source key from your server-side Tealium configuration. For example, abc123.
  • Data Collection Endpoint (optional): Override the Tealium Collect endpoint with your first-party data collection endpoint. For example, https://collect.example.co.uk/event.
  • Data Object (optional): The custom JavaScript variable to use instead of the global dataLayer object. For example, {{myObject}}.

Triggers

For page view tracking, use the built-in “All Pages” trigger. To include event tracking, use an “All Events” trigger to fire for all events.

To set up the “All Events” trigger in Google Tag Manager:

  1. In Google Tag Manager, click the Triggers in the left navigation.
  2. Click the New button to add a trigger.
  3. Click “Trigger Configuration” to choose a tag type. Search and select “Custom Event” from the list.
  4. Select the “Use regex matching” checkbox.
  5. Enter the following for the “Event Name” regular expression (regex):

    ^(?!gtm\.load)(?!gtm\.dom).*
    
  6. Click Save, rename the custom trigger a new name, and click Save again.

This rule triggers for all events excepting gtm.loadand gtm.dom (two events specific to GTM that we want to ignore).

Validation

If the Tealium Collect tag is firing for all events, then every dataLayer.push call on your page sends a data collection event to Tealium.

In your debug console Network tab, a POST call goes out to https://collect.tealiumiq.com/ACCOUNT/PROFILE/2/i.gif.

Use Live Events to see your event data in real-time.

Data Layer

 
  • Mobile
  • Getting Started
    • Overview
    • Quick Start Guide
    • Mobile Concepts
    • Client-Side
    • Server-Side
    • Tracking Webviews
    • Data Layer
    • Consent Management
    • Event Batching
    • User Location and Geofencing
    • Deep Links
    • Timed Events
    • Trace
    • Hosted Data Layer
    • Feature Comparison
    • Troubleshooting
  • Remote Commands
    • Overview
    • How It Works
    • Integrations
      • AppsFlyer
      • Braze
      • Contentsquare
      • Facebook
      • Firebase
      • Kochava
      • Usabilla
  • Android (Java)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Module
      • Optimizely X Tracking Module
    • Android TV
    • Android Wear
    • API Reference
      • ConsentManager
      • DataSources
      • Lifecycle
      • Tealium
      • Tealium.Config
      • TealiumLocation
    • Release Notes
  • Android (Kotlin)
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • Identity Resolution
    • Module List
      • Collect Module
      • Collectors Module
      • Crash Reporter Module
      • Install Referrer Module
      • Lifecycle Tracking Module
      • Location Manager Module
      • Tag Management Dispatcher Module
      • Visitor Service Module
    • Android TV
    • API Reference
      • ConsentCategory
      • ConsentManager
      • CurrentVisit
      • DataLayer
      • Lifecycle
      • LocationManager
      • Tealium
      • TealiumConfig
      • VisitorProfile
      • VisitorService
    • Release Notes
  • Cordova
    • Overview
    • Install
    • Track
    • Data Management
    • Module List
      • Ad Identifier Module
      • Crash Reporter Module
      • Install Referrer Module
    • API Reference
    • Release Notes
  • Flutter
    • Overview
    • Install
    • Track
    • Consent Management
    • Data Management
    • API Reference
    • Release Notes
  • iOS (Objective-C)
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • Consent Management
    • Tag Management
    • Module List
      • Lifecycle Tracking Module
      • Optimizely X Tracking Module
    • tvOS
    • watchOS
    • API Reference
    • Release Notes
  • iOS (Swift) 1.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Data Management
    • App Extensions
    • Identity Resolution
    • Consent Management
    • Modules
    • Module List
      • AppData Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DataSource Module
      • DefaultStorage Module
      • Delegate Module
      • DeviceData Module
      • DispatchQueue Module
      • FileStorage Module
      • Lifecycle Module
      • Location Module
      • Logger Module
      • PersistentData Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
      • VolatileData Module
    • Feature Comparison
    • Working with Objective-C
    • API Reference
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManagerDelegate
      • TealiumConsentManager
      • TealiumInstanceManager
      • TealiumPersistentData
      • TealiumVolatileData
      • Tealium
    • Release Notes
  • iOS (Swift) 2.x
    • Overview
    • Install
    • Track
    • Data Layer
    • Consent Management
    • App Extensions
    • Identity Resolution
    • Modules
    • Module List
      • AppData Module
      • Attribution Module
      • AutoTracking Module
      • Collect Module
      • Connectivity Module
      • CrashReporter Module
      • DeviceData Module
      • Lifecycle Module
      • Location Module
      • RemoteCommands Module
      • TagManagement Module
      • VisitorService Module
    • Working with Objective-C
    • API Reference
      • Tealium
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManager
      • TealiumDataLayer
      • TealiumInstanceManager
    • Release Notes
  • React Native
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Unity
    • Overview
    • Install
    • Track
    • API Referencee
  • Xamarin
    • Overview
    • Install
    • Track
    • Data Management
    • Consent Management
    • API Reference
    • Release Notes
  • Web
  • AMP
    • Overview
    • Install
    • Track
    • Data Layer
  • Angular
    • Overview
    • Install
    • Track
    • API Reference
  • Google Tag Manager
    • Overview
    • Install
    • Data Layer
  • JavaScript (Web)
    • Overview
    • Install
    • Track
    • Data Layer
    • Universal Data Object (utag_data)
    • Universal Tag (utag.js)
    • Data Layer Object (b)
    • Single-Page Applications
    • Settings
    • Debugging
    • API Reference
      • Cookie Functions
      • GDPR Functions
      • Tracking Functions
      • Utility Functions
    • Release Notes
  • Server
  • C#
    • Overview
    • Install
    • Track
    • Data Layer
    • API Reference
    • Release Notes
  • HTTP API
    • Overview
    • Endpoint
    • Data Layer
  • Java
    • Overview
    • Install
    • Track
    • API Reference
    • Release Notes
  • Node
    • Overview
    • Install
    • Track
    • API Reference
  • Python
    • Overview
    • Install
    • Track
    • API Reference
  • Roku
    • Overview
    • Install
    • Track
    • API Reference
  • Ruby
    • Overview
    • Install
    • Track
    • API Reference

Was this article helpful?

This page was last updated: July 2, 2020       Thank you for your feedback!
  • Platforms
  • Partners
  • Forums
  • Mobile
  • Getting Started
  • Remote Commands
  • Android (Java)
  • Android (Kotlin)
  • Cordova
  • Flutter
  • iOS (Objective-C)
  • iOS (Swift) 1.x
  • iOS (Swift) 2.x
  • React Native
  • Unity
  • Xamarin
  • Web
  • AMP
  • Angular
  • Google Tag Manager
  • JavaScript (Web)
  • Server
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby