The Diff tool is built for version control and Distro verification in Tealium iQ. It allows you to compare the versions published in your profile and then inspect their Distro files. By inspecting the code changes, you can find out which Tealium iQ configurations were added, removed, or left untouched between revisions.

This article describes how to compare and contrast the versions in your Tealium iQ profile.

In this article:

Table of Contents Placeholder

How it Works

You select a pair of published versions to compare and run the tool on an environment (Dev, QA, Prod, or Custom). In order to use the Diff Tool for a version, that version must be published. The Diff Tool will not work for a version that was only saved and not published.

The Diff Tool generates an SHA256 hash for each version of the following Distro files:

    • utag.js and utag.#.js
    • utag.sync.js
    • utag.sub.js
    • utag.footer.js

If the SHA256 hash of the Distro file versions being compared fail to match, the Diff tool highlights the differences in the enclosed code and displays them side by side.

You cannot use the Diff Tool on versions published before December 19, 2014.

Using the Diff Tool

Use the following steps to interact with the Diff Tool:

  1. In the sidebar, go to iQ Tag Management > Client-Side Versions.
  2. Click the published version you want to compare and choose one of its publish environments.
  3. Click Compare using Diff tool in the environment you just selected.
    The tool is immediately grayed out to signal that this version will be compared first.
    WhiteUI_TiQ_TealiumiQDiffTool_Select First Version to Compare.png
  4. A yellow alert banner displays at the top of the screen prompting you to select the second version. If you do not want to continue, click Cancel.
  5. Select the second version and environment and click Compare using Diff Tool again for this version.
    WhiteUI_TiQ_TealiumiQDiffTool_CompareUsingDiffToolSelectSecondVersion.png
    An informational message displays while the information is gathered.
  6. After comparing each version of the Distro files for code changes, the results display in the Distro File Comparison window.
  7. View the changes and then click Close to close the Distro File Comparison window.

Reading the File Comparison Results

Use the following numbered example and descriptions that follow as a guide to learn how to read the Distro File Comparison results:

WhiteUI_TiQ_TealiumiQDiffTool_Distro File Comparison Window_Numbered.png

  1. Files
    • Displays the list of Distro files compared by the tool.
    • Clicking on a file displays the corresponding code for each version.
    • The symbol next to the file indicates what is different between the two versions.
      Indicates there are changes to the code contained in the file.
      + Indicates the tag was added to the second version.
      Indicates the tag was removed from the second version.

      If a Tealium iQ extension is modified, the code changes display in the utag.# file of the tag to which the extension is scoped

  2. Version Details
    • Displays the Tealium account and profile, version title, timestamp, and the user that published the version.
    • The information is arranged in the order you select the versions: the first version selected is on the left and the second version on the right.
  3. Code
    • Displays the code within the two versions of the Distro files.
    • The changes to the code are highlighted in red and green:
      • Red indicates the portion of the code that is absent in the second version.
      • Green indicates the code that was added to the second version.
  4. Column Indicator
    • Click any column indicator to scroll to exact locations that contain code changes.

Distro Verification

The Distro Verification screen displays SHA256 signatures of every file generated for a version. By looking at the signatures, you can quickly compare a file in Tealium iQ with its corresponding instance on the server and spot any differences. This is especially important if you are hosting Distro files in a location different from Tealium's multi-CDN.

Use the following steps to access the Distro Verification screen:

  1. Click a version and select one of its environments.
    WhiteUI_TiQ_TealiumiQDiffTool_DistroVerification.png
  2. Click Distro Verification.
    The Distro Verification - SHA256 Digest Signatures file displays.
    WhiteUI_TiQ_TealiumiQDiffTool_SHA256 Distro Verification File Sample.png
  3. Click Close to close the window.