• Expand/CollapseMenu
Help
Getting Started with Tealium iQ
Introduction
Data Layer Basics
Tags, Load Rules, and Data Mappings
Extensions
Saving and Publishing
Installing and Testing
Additional Resources
Back

Installing and Testing

In this article:

Now that you have successfully saved and published your changes, it's time to test and view the results on your site. You will learn how to install the Tealium tag and data layer and then use testing tools to verify that it's working.

In this section you will:Beast-Thumbsup-Whistle-small.png

  • Learn about the Universal Data Object (utag_data) and Universal Tag (utag.js).
  • Use the Code Center to get the installation code for your iQ Tag Management account.
  • Use Web Companion to verify that the tag is loading.

Install the Universal Data Object and the Universal Tag

This step requires that you have access to edit the code of your website.

Now that you have a basic tag configuration saved and published in your account, it's time to install the two components of the Tealium tag management solution: utag_data and utag.js. Both of these components should be installed on every page of your website.

  • Universal Data Object (UDO) – utag_data
    The Universal Data Object (UDO) is a JavaScript variable named utag_data . It contains dynamic data from your web page. This object must be populated with the same variable names that you define in the Data Layer screen of the iQ Tag Management interface.
  • Universal Tag – utag.js
    The Tealium Universal Tag is a JavaScript library called utag.js. It contains the generated code necessary to load the configuration from your iQ Tag Management account on your website.

Using the Code Center

The Code Center in iQ Tag Management is where you get the code to install Tealium on your site.

Use the following steps to get the code:

  1. Go to the user menu at the top-right of the screen and select Code Center.
    TiQ_Code Center_Prepend utag.js path with https.jpg
  2. Find the universal data object code sample that looks like this:
    <!-- Tealium Universal Data Object -->
    <script type="text/javascript">
    var utag_data = {
      page_name : "",
      page_section : "",
      page_category : "",
      page_subcategory : "",
      page_type : ""
    }
    </script>
    These variables should be populated dynamically by your web application framework. However, for this test, you can set static values.
  3. Copy this code and paste it into the HTML after the <body> tag of a test page on your site.
  4. Next, find the universal tag code that looks like this:
    <!-- Tealium Universal Tag -->
    <script type="text/javascript">
    (function(a,b,c,d){
    a='https://tags.tiqcdn.com/utag/your_account/main/qa/utag.js';
    b=document;c='script';d=b.createElement(c);d.src=a;
    d.type='text/java'+c;d.async=true;
    a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a)
    })();
    </script>
  5. Copy the code and paste it into the HTML after the universal data object.
    This loads the Tealium tag asynchronously into the page.

    If you copy this code, you must change your_account to your actual account name. Otherwise, use the code from your Code Center that contains your account, profile, and environment.

After your website code is updated, it's time to test. 

Verifying with Web Companion

Web Companion is a browser tool to help verify your installation. Launching this tool will show that the utag.js tag is loading properly on your site.

To install and use the Web Companion bookmarklet:

  1. In iQ Tag Management, go to the user menu at the top right of the screen and select Web Companion.
  2. Click and drag the Web Companion button to your browser toolbar to create the bookmarklet.
  3. Navigate to your test page and click the Web Companion bookmarklet.
    If your code is working, the Web Companion window will display on the page like this, with the following information:
    getting-started-iq-web-companion.png

    Account – the name of your account.

    Profile – the name of the profile within your account  (default is "main").

    Version – the name of the version of utag.js loaded on the page.

    Environment – the publish environment loaded.

    Last Published – the publish timestamp of utag.js.

    Tags – a list of tags loaded.
  4. If Web Companion doesn't load, double-check that you are testing a page that has the Universal Tag coded in it. Also check the browser console for any syntax errors that might be preventing the code from running.
☰

Copyright All Rights Reserved © 2008-2023

Public