How to Validate and Troubleshoot your Tags

How to Validate and Troubleshoot your Tags

by on ‎12-28-2017 02:27 PM - edited on ‎02-06-2018 06:56 AM by Community Manager (1,329 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

Once you have downloaded the plugin, open your site where the Tealium tags are installed and click on the plugin icon in the top right corner of your Chome window.

tag assistant.png

Select "Validate All Pages" then click Done.

Image 2017-12-28 09-41-08.png

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

Image 2017-12-28 09-44-50.png

For Google Analytics, you will want to click on either Pageview Requests or Events.

Here is an example of what you will see when you click on Pageview Requests.

Image 2017-12-28 10-00-07.png

When you click on either of those, you will see the parameters sent to Google. You can get a more detailed view by clicking the URLs tab. 

Image 2017-12-28 10-02-02.png

The default view shows the unformatted URL request. Change to the formatted view by clicking table button.

Image 2017-12-28 10-03-53.png

This will allow you to see each parameter sent to Google. However, you should be fine viewing the initial "Metadata" tab.

You can validate any other Google tags using this plugin as well. Some examples are: Doubleclick Floodlight, Google Adwords, Google Publisher, DFP, Google Trusted Stores.

Here are some helpful links that describe some of the parameters for popular Google tags:

Validating with Google Debugger

Once you have downloaded the plugin, open your site where the Tealium tags are installed and click on the plugin icon in the top right corner of your chome window. 

Section Page 2017-12-28 10-27-20.png

You will now be able to see live output in the Chrome Developer Tools Console.

Start triggering events and page views and you will see the Google Analytics output in the console.

Section Page 2017-12-28 10-28-48.png

The output you see here is what is getting sent to Google Analytics.

Here are some helpful links that describe some of the parameters for the Google Analytics tag:

Validating with Facebook Pixel Helper

Once you have downloaded the plugin, open your site where the Tealium tags are installed and click on the plugin icon in the top right corner of your chome window.

Image 2017-12-28 11-13-34.png

Once you expand an event within the plugin, this is what the parameters will look like:

Image 2017-12-28 11-20-25.png

 Each pixel type detected can be expanded to show its details. In this screen the "AddToCart" pixel event is shown:

Image 2017-12-28 11-21-53.png

What you see here is the data sent to Facebook. 

There are a number of events that will be displayed in this window depending on the type of interaction. Here are a list of the Facebook events and the parameters that can be sent with each:

Validating with Adobe Analytics Debugger

Once you have downloaded the plugin, open your site where the Tealium tags are installed and click on the plugin icon in the top right corner of your chome window.

Drapey tie-neck top_gap 2017-12-28 11-28-20.png

You will now be able to see live output in the Chrome Developer Tools Console.

Start triggering events and pageviews and you will see the Adobe Analytics output in the console.

Drapey tie-neck top_gap 2017-12-28 11-29-46.png

 

This console output represents all the data that is sent to Adobe in each server call.

Here is a helpful link that describes some of the parameters for the Adobe Analytics (AppMeasurement) tag:

Validating with 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. Right-click the page and select Inspect. The Developer Tools will open.
    chrome-inspect.png
  3. Click the Network tab.
    Section Page 2017-12-28 13-12-38.png
  1. We will use Google Analytics as an example here, but you can use any tag.
  2. In Tealium iQ, you will find the ID in the configuration portion of the tag, copy that ID number.TiQ - services-christina 2017-12-28 13-13-14.png
  1. Navigate back to your site where the Network tab is still open and, in the "Filter" box, paste that ID number.
    Section Page 2017-12-28 13-13-56.png
  1. Click the Preserve Log checkbox and start executing page views and/or 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 here like "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

Here is an example of the Query String Parameters from an Adobe AppMeasurement server call: 

Drapey tie-neck top_gap 2017-12-28 13-22-40.png.

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 your vendor tags aren't 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. Read more about setting up data mappings.