Web Companion is a browser tool that allows you to check your iQ installation, inspect data on your site, and create and test new configurations quickly and easily.

In this article:

Table of Contents Placeholder

Install Web Companion

  1. Click on your name in the top-right corner of Tealium iQ console to drop-down the Account Admin settings. Click Web Companion.
  2. A pop-up window containing instructions to install Web Companion will appear on your screen.
  3. Drag the "Tealium Web Companion" link from the message box on to your browser's bookmark bar.
    iq-web-companion.png

Web Companion can be installed as a custom Tealium Tool. Learn more about the Tealium Tool: Web Companion.

Launch Web Companion

  1. Navigate to your site where the Tealium Universal Tag (utag.js) is installed.
  2. Locate “Tealium Web companion" on your browser's bookmarks bar and click to launch it.
    web-companion-tlc.png

Using Web Companion

Web Companion is organized into three screens (or tabs): Overview, Data, and Tools. The following sections describe what is available on each tab.

Overview Tab

Account Information

The current account, profile, version, and environment that the page is running is displayed under this tab. 

Target Environment

The environment detected in the page code is outlined in orange. The currently viewed environment is highlighted in blue. To change the environment, click the target environment you wish to load, then click Refresh Page

Learn more about switching environments.

Tags & Extensions Tabs

This tab will show which Tags loaded and whether they successfully sent requests. The Extensions that are successfully completed will also be displayed.

Timers

The load and send times of the tag are displayed.

  • Loaded: the time to load the utag.js file into the page.
  • Sent: the time to trigger all the vendor tags on the page.

Queue (unsaved changes)

Changes applied to the profile using Web Companion are queued and will not be committed until you click the "Save..." button. If you do not wish to commit a change, you may also remove that change from the queue by clicking on the X next to the appropriate change.

saving_changes_web_companion.png

Data Tab

The Data tab makes it easy to explore the available data variables on the page. These can be added to your account data layer using the Add buttons. The following types of data can be viewed:

  • HTML Metadata: Information about the webpage, author, title and other meta elements of the HTML document.
  • Querystring Parameters: The name and value of a parameter located within the query string of the URL.
  • Cookies: Small files that store visitor and session information.
  • JavaScript Variables: JavaScript page variables other than utag_data.
  • Universal Data Object

data_tab.png

To add a variable to your data layer:

  1. Click Data tab and select a data type. A list of variables is displayed.
  2. Locate the desired variable and click the +Add.
    added_data_variables.png

Universal Data Object

The Universal Data object (UDO), or utag_data, view shows the detected data object on the page. For more information, see the guide to the data layer for websites..

universal_data_object_type.png

Tools Tab

The Tools tab offers convenience features to make it easier to add configuration to your account. The following tools are available:

  • On-Page Element Selector
    Use this simple point and click tool to select an element on the page to be used in event tracking or content modification.
  • Load Rule Helper
    Create a load rule condition directly from the page that you wish to target.  Built-in page variable values will be pre-filled based on the current page.
  • Custom Target Environments
    Use this tool to switch to environments other than the default Dev, QA, and Prod.
  • Adobe Test and Target
    Use this tool to assist in the configuration of the Adobe Target tag in your account.

tools_tab.png

An extension or load rule added to your account via Web Companion is not active until you return to iQ Tag Management to enable and publish them.

On-Page Element Selector

Select an element on the webpage to preconfigure the Content Modification Extension or the jQuery Live Handler Extension for it. After you choose our target element, select the extension type to create and click "Queue" and save the extension to your profile.

The related DOM node information will also be displayed.

jquery web companion.png

Load Rule Helper

Create a new load rule to determine the location and instant a Tag should load. Click "Add to Queue" and save the load rule to your profile.

load_rule_helper.png

Custom Target Environment

Publish to a custom environment instead of the 3 default environments (Dev, QA, and Prod). Enter the name of the target environment in the text-box and click "Set Environment".

set_target_environment.png

Adobe Test and Target

Add this extension to modify your desired content on the page. Configure the extension and click "Add to Queue" to save it to your profile. For more details, please visit Tealium's guide on Adobe Test and Target Extension.

adobe_test_and_target.png