Validate and troubleshoot tags

This guide explains how to validate client-side tags that have been implemented in Tealium iQ. It will cover several methods to ensure that tags are loading and that data is being sent.

Getting started

The validation methods covered here are performed using Google Chrome as the browser and vendor specific plugins.

Vendor plugins

We recommend downloading the following plugins for Google Chrome:

Chrome Developer Tools

We recommend taking a tutorial on Chrome Dev Tools to familiarize yourself with the interface:

Validate with Google Tag Assistant

The following list provides links that describe parameters for popular Google tags:

Use the following steps to validate with the Google Tag Assistant:

  1. After you download the plugin, open your site to where the Tealium tags are installed and click the plugin icon in the upper-right corner of your Chrome window.
    tag assistant

  2. Select Validate All Pages then click Done.
    Validate all pages - Done

  3. Click Allow to allow the plugin to check if other plugins are blocking any Google tags and then click on any Google tags appearing in the plugin interface for more details.
    Allow

  4. For Google Analytics, click either Pageview Requests or Events. The following example shows the results that display when you click Pageview Requests. Pageview requests

  5. When you click either of those, you will see the parameters sent to Google. Clicking the URLs tab provides a more detailed view. Parameters sent to Google|

  6. The default view shows the unformatted URL request. Change to the formatted view by clicking the table button. This will allow you to see each parameter sent to Google. However, you should be fine viewing the initial Metadata tab.

    Metadata tab
  7. You can validate any other Google tags using this plugin as well. Some examples are: Floodlight, Google Ads, Google Publisher, DFP, Google Trusted Stores.

Validate with Google Debugger

The following list provides links that describe parameters for the Google Analytics tag:

Use the following steps to validate with Google Debugger:

  1. After you download the plugin, open your site where the Tealium tags are installed and click the plugin icon in the upper-right corner of your Chrome window.
    Plugin icon The live output in the Chrome Developer Tools Console appears.
  2. Start triggering events and page views and you will see the Google Analytics output in the console.
    The output displays what is getting sent to Google Analytics.
    What is sent to Google Analytics|

Validate with Facebook Pixel Helper

There are a number of events that will be displayed in this window depending on the type of interaction. Go to Facebook Events to learn about these events and the parameters that can be sent with each.

Use the following steps to validate with the Facebook Pixel Helper:

  1. After you download the plugin, open your site where the Tealium tags are installed and click the plugin icon in the upper-right corner of your Chrome window.
    Plugin icon
  2. After you expand an event within the plugin, the parameters appear as follows:
    Parameters
  3. Each pixel type detected can be expanded to display the details.
    In this example, the AddToCart pixel event is shown:
    The data that appears is the data sent to Facebook.
    Data sent to Facebook

Validate with Adobe Analytics Debugger

There are a number of parameters that will be displayed in the Adobe Analytics debugger. Go to Adobe Query Parameters to learn more about the parameters for the Adobe Analytics (AppMeasurement) tag.

Use the following steps to validate using the Adobe Analytics Debugger:

  1. After you download the plugin, open your site where the Tealium tags are installed and click the plugin icon in the upper-right corner of your Chrome window. The screen displays the live output in the Chrome Developer Tools Console.
    Live output

  2. Start triggering events and pageviews and the Adobe Analytics output will display in the console.
    This console output represents all the data that is sent to Adobe in each server call.
    Data sent to Adobe

Validate with Chrome Developer Tools

Not all vendors have their own plugins. In this case, we recommend using the Chrome Developer Tools’ Network tab to validate that requests are successfully sent by the tags from the browser.

For more information, see the Chrome DevTools Network Analysis and search the document for View query string parameters to learn more about the parameters available.

Use the following steps to validate using Chrome Developer tools:

  1. Open your site where Tealium is installed.

  2. To display the Developer Tools, right-click the page and select Inspect.
    Chrome Inspect

  3. Click the Network tab.
    This example uses Google Analytics, but you can use any tag.
    Section Page

  4. In Tealium iQ, find the Tracking ID in the configuration portion of the tag and copy the ID number.
    TiQ - services

  5. Navigate back to your site where the Network tab is still open and paste the ID number in the Filter box.
    Paste the ID number

  6. Click the Preserve Log checkbox and start executing page views and/or events.
    The network requests being sent by the tag appear.
    Network requests

  7. Click an entry to view the details of the request.
    You will see several sections of information here, such as Request URL, Response Headers, Cookies, and Query Parameters.

We are most interested in Request URL and Query Parameters but you will find more information on the others here: Chrome Network Tab

Chrome Network Tab
The Request URL is the entire URL that was either sent as a POST or GET to the vendor’s server. This URL includes the server URL and the query string parameters (the data) that the vendor will receive.
Request URL and data
The Query String Parameters are a list of the parameters (not including the server url) that the vendor is receiving. This is most likely how data is passed from the page to the vendor.
How data is passed from page to vendor
The following example shows the Query String Parameters from an Adobe AppMeasurement server call:
Adobe AppMeasurement server call

Troubleshooting

There may be an instance where you find something missing in the Query Parameters or one of the plugins. If you would like to try and troubleshoot this yourself, there are some things you can try:

  • First, use Web Companion or the Universal Tag Monitor to verify the data layer variables used in your page and event tracking calls. Learn more.
  • If your data layer is incomplete, it may require additional development work to include the variables you need.
  • If your data layer looks good and your tracking calls are working as expected, but your vendor tags are not receiving the data you expect, the next step is to verify the data mappings for your tag. Data mappings tell Tealium which data layer variables to send to the corresponding vendor parameters. Learn more.

Was this page helpful?

This page was last updated: January 7, 2023