How to Validate and Troubleshoot your Tags

How to Validate and Troubleshoot your Tags

by on ‎12-28-2017 02:27 PM - edited Monday by (1,878 Views)

This is a guide to validating 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.

Validation of data received by the vendor should be coordinated with your vendor representative.

In this article:

Table of Contents Placeholder

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:

Validating with Google Tag Assistant

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

  1. Once you have downloaded the plugin, open your site to where the Tealium tags are installed and click the plugin icon in the top right corner of your Chrome window.
    tag assistant.png
  2. Select "Validate All Pages" then click Done.
    Image 2017-12-28 09-41-08.png
  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.
    Image 2017-12-28 09-44-50.png
  4. For Google Analytics, click either Pageview Requests or Events.
    The following example shows the results that display when you click Pageview Requests.

    Image 2017-12-28 10-00-07.png
  5. When you click either of those, you will see the parameters sent to Google.
    Clicking the URLs tab
     provides a more detailed view.

    Image 2017-12-28 10-02-02.png
  6. The default view shows the unformatted URL request. Change to the formatted view by clicking table button.
    This will allow you to see each parameter sent to Google. However, you should be fine viewing the initial "Metadata" tab.

    Image 2017-12-28 10-03-53.png  
  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.

Parameters for Popular Google Tags

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

Validating with Google Debugger

Use the following steps to validate with Google Debugger:

  1. Once you have downloaded the plugin, open your site where the Tealium tags are installed and click the plugin icon in the top right corner of your Chrome window.
    Section Page 2017-12-28 10-27-20.png
    The live output in the Chrome Developer Tools Console displays.
  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.
    Section Page 2017-12-28 10-28-48.png

Parameters for the Google Analytics Tag

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

Validating with Facebook Pixel Helper

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

  1. Once you have downloaded the plugin, open your site where the Tealium tags are installed and click the plugin icon in the top right corner of your Chrome window.
    Image 2017-12-28 11-13-34.png
  2. Once you expand an event within the plugin, the parameters display as follows:
    Image 2017-12-28 11-20-25.png
  3. Each pixel type detected can be expanded to display the details.
    In this example, the "AddToCart" pixel event is shown:
    The data that displays is the data sent to Facebook.
    Image 2017-12-28 11-21-53.png

Facebook Events

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.

Validating with Adobe Analytics Debugger

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

  1. Once you have downloaded the plugin, open your site where the Tealium tags are installed and click the plugin icon in the top right corner of your Chrome window.
    The screen displays the live output in the Chrome Developer Tools Console.

    Drapey tie-neck top_gap 2017-12-28 11-28-20.png
  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.
    Drapey tie-neck top_gap 2017-12-28 11-29-46.png

Parameters for the Adobe Analytics Tag

Click Adobe Query Parameters to learn more about the parameters for the Adobe Analytics (AppMeasurement) tag.

Validating with Chrome Developer Tools

Use the following steps to validate using Chrome Developer tools:

Not all vendors have their own plugins to validate their tags. In this case, we recommend using the Chrome Developer Tools' Network tab to validate that the request is successfully received by the vendor's server and the correct data is being sent.

Here is some more information on the Chrome Network Tab. Search this document for "View query string parameters".

  1. Open your site where Tealium is installed.
  2. To display the Developer Tools, right-click the page and select Inspect.
    chrome-inspect.png
  3. Click the Network tab.
    This example uses Google Analytics, but you can use any tag.
    Section Page 2017-12-28 13-12-38.png
  4. In Tealium iQ, find the Tracking ID in the configuration portion of the tag and copy the ID number.
    TiQ - services-christina 2017-12-28 13-13-14.png
  5. Navigate back to your site where the Network tab is still open and paste the ID number in the "Filter" box.
    Section Page 2017-12-28 13-13-56.png
  6. Click the Preserve Log checkbox and start executing page views and/or events.
    The network requests being sent by the tag displays.
    Section Page 2017-12-28 13-15-15.png
  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

    Section Page 2017-12-28 13-15-55.png
    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.
    Section Page 2017-12-28 13-18-25.png
    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.
    Section Page 2017-12-28 13-20-01.png
    The following example shows the Query String Parameters from an Adobe AppMeasurement server call: 
    Drapey tie-neck top_gap 2017-12-28 13-22-40.png

Parameters for the Chrome Network Tab

Click Chrome Network Tab and search the document for "View query string parameters" to learn more about the parameters available for the Chrome Network tab.

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.