How To Validate and Troubleshoot Tags

How To Validate and Troubleshoot Tags

by 3 weeks ago (153 Views)

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

Chrome Developer Tools

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

Validating with Tealium Web Companion

The first way to validate your tag installation is to make sure all tags are loading and being sent. For this, Tealium Web Companion is a useful tool in the initial stages of validation.

Install the Tealium Tools Chrome Extension and open the Web Companion tool 

111.png

If your tags have loaded and sent, you will see a green OK next to the name of each tag.

222.png

If the tags have simply loaded, but not sent (nothing was sent to the vendor) you will see a yellow Loading next to one or more tags. If you see this, there could be an error causing the tags not to send. Please see this section for more details.  

333.png

Validating with Chrome Developer Tools

Once you have validated that your tags are loading and being sent without errors, the next step is to verify that you see the vendor request in the network activity of the browser. This can be done in the console of any browser, but this example uses Chrome Developer Tools.

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

For this example we will inspect the network request sent to Google Analytics:

  1. In Tealium iQ,  copy the Tracking ID from the tag configuration section of the tag.TiQ - services-christina 2017-12-28 13-13-14.png
  2. Open your site where Tealium iQ is installed.
  3. Right-click the page and select Inspect. The Developer Tools will open.
    chrome-inspect.png
  4. Click the Network tab.
    Section Page 2017-12-28 13-12-38.png
  1. In the "Filter" box, paste the Tracking ID number.
    Section Page 2017-12-28 13-13-56.png
  1. Click the Preserve Log checkbox and refresh the page (and trigger tracking events).
    You will see the network requests being sent by the tag:Section Page 2017-12-28 13-15-15.png
  2. Click an entry to view the details of the request.
    You will see several sections of information 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

Validating With Vendor Plugins

Some of the more popular vendors offer their own extensions for Google Chrome that allow you to validate their pixels using a friendlier interface. Here are some third-party plugins available:

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, you will want to verify the data layer variables used in your page and event tracking calls. This can be done using Web Companion or the Universal Tag Monitor. Read more about validating your web installation

If your data layer is incomplete it might 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 the vendor tags do not contain 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. Read more about setting up data mappings.