
{
    "kind": "term",
    "name": "Tealium Tools",
    "count": 8,
    "items": [

    
        {
            "weight": "100",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/browser-extension/",
            "title": "Tealium Tools Browser Extension",
            "body": "<p>The Tealium Tools extension is built for the following browsers:</p>\n<ul>\n<li>Google Chrome</li>\n<li>Microsoft Edge</li>\n</ul>\n<h2 id=\"install\">Install</h2>\n<h3 id=\"chrome\">Chrome</h3>\n<p>To install the Tealium Tools extension on Google Chrome:</p>\n<ol>\n<li>In a new Chrome window, go to <a href=\"https://chrome.google.com/webstore/detail/tealium-tools/gidnphnamcemailggkemcgclnjeeokaa\">Tealium Tools Chrome Extension</a>.</li>\n<li>Click <strong>+ Add to Chrome</strong>.</li>\n<li>Click <strong>Add extension</strong> to confirm.<br>\nConfirm that the button now displays <strong>Added to Chrome</strong> and that the Tealium icon displays on the upper right of the Chrome toolbar.</li>\n<li>Click the Tealium icon in the upper right of the Chrome window to open Tealium Tools and select a tool to use.</li>\n</ol>\n<h3 id=\"edge\">Edge</h3>\n<p>To install the Tealium Tools add-on on Microsoft Edge:</p>\n<ol>\n<li>In a new Edge window, go to <a href=\"https://microsoftedge.microsoft.com/addons/detail/tealium-tools/idhdcghfaooedcikdpjmbkfknlckhpfo\">Tealium Tools Edge Add-On</a>.</li>\n<li>Click <strong>Get</strong>.</li>\n<li>Click <strong>Add extension</strong> to confirm.<br>\nConfirm that the text below the button now says <strong>Add-on already installed on your browser</strong>.</li>\n<li>Click the <strong>Extensions</strong> icon.</li>\n<li>Click the visibility button next to <strong>Tealium Tools</strong>. The Tealium icon appears on the upper-right of the Edge toolbar.</li>\n<li>Click the Tealium icon in the upper right of the Edge window to open Tealium Tools and select a tool to use.</li>\n</ol>\n<h2 id=\"interface\">Interface</h2>\n<p>The Tealium Tools window is organized into two main tabs, with additional options available under the <strong>User Profile icon</strong>.</p>\n<h3 id=\"main-tabs\">Main tabs</h3>\n<ul>\n<li><strong>Home</strong><br>\nContains official Tealium built-in tools.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-browser-extension.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-browser-extension.png\"\n             alt=\"Tealium Tools Browser Extension.png\"\n             title=\"Tealium Tools Browser Extension.png\" width=\"400\"/>\n        </a>\n    </figure></li>\n<li><strong>Tool Catalogue</strong><br>\nA catalogue of official Tealium built-in tools and community tools created by contributors from Tealium, our partners, and sometimes our clients. Please note that Tealium does not officially support community tools.</li>\n</ul>\n<h3 id=\"user-profile-options\">User Profile options</h3>\n<p>Click the user profile icon to access the following additional options:</p>\n<ul>\n<li><strong>Login</strong><br>\nManage login credentials and configure Single Sign-On (SSO). For more information, see <a href=\"#using-sso\">Using SSO</a>.</li>\n<li><strong>Settings</strong><br>\nCustomize tool behavior and set domain or environment preferences for tools like the Environment Switcher. For details, see <a href=\"/iq-tag-management/tealium-tools/environment-switcher/#using-the-environment-switcher-with-custom-domains-or-path-overrides\">Using the Environment Switcher with custom domains or path overrides</a>.</li>\n<li><strong>About</strong><br>\nView version details, build information, and learn about the Community tag used to label community tools.</li>\n<li><strong>Feedback</strong><br>\nReport issues or submit suggestions directly from the extension.</li>\n</ul>\n<h2 id=\"using-sso\">Using SSO</h2>\n<p>To configure and use Single Sign-On (SSO):</p>\n<ol>\n<li>Open the <strong>Tealium Tools</strong> extension.</li>\n<li>Click the profile icon in the upper-right corner.</li>\n<li>Click <strong>Settings</strong>.</li>\n<li>Check the box for <strong>Use SSO as Default</strong>.</li>\n<li>Click <strong>Update Settings</strong> to reload the tool.</li>\n</ol>\n<p>Return to <strong>Login</strong> settings and click <strong>SSO Log In</strong> to log in with Single Sign-On.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-sso-login.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-sso-login.png\"\n         alt=\"Tealium Tools SSO Login\"\n         title=\"Tealium Tools SSO Login\"/>\n    </a>\n</figure>\n<h2 id=\"official-tealium-tools\">Official Tealium Tools</h2>\n<p>The following is a list of Tealium Tools that are built into the extension:</p>\n<ul>\n<li><a href=\"https://my.tealiumiq.com\"><strong>Tealium iQ</strong></a><br>\nA bookmark link to the iQ Tag Management interface.</li>\n<li><a href=\"/iq-tag-management/tealium-tools/web-companion/\"><strong>Web Companion</strong></a><br>\nA browser tool used to audit your tag configuration, inspect data on your site, and create and test new configurations quickly and easily.</li>\n<li><a href=\"https://university.tealium.com/\"><strong>Tealium University</strong></a><br>\nA bookmark link to Tealium online learning portal, which includes self-paced courses, as well as access to In-person/Instructor-led training..</li>\n<li><a href=\"/server-side/trace/about/\"><strong>AudienceStream Trace</strong></a><br>\nTrace provides the necessary tools to put your Universal Data Hub configuration to the test. With Trace, you can observe every detail of a defined workflow, ensure attributes update correctly, rules are dialed in, and actions fire as expected. Trace works in real-time, so you know immediately what works and what needs adjusting.</li>\n<li><a href=\"/server-side/tealium-tools/optimizely-helper/\"><strong>Optimizely Helper</strong></a><br>\nTealium AudienceStream enables marketers to discover audiences, enrich visitor profiles and stitch together customer interactions across digital touch points. Using both AudienceStream and Optimizely, users can leverage the audiences created in AudienceStream and build targeted experiments in Optimizely.</li>\n<li><a href=\"/iq-tag-management/tealium-tools/environment-switcher/\"><strong>Environment Switcher</strong></a><br>\nThe environment switcher is a powerful testing tool that lets you change the Tealium files (utag.js, utag.sync.js) that are loaded on a page by specifying an environment (Dev, QA, Prod, Custom) and/or an account and profile.</li>\n<li><a href=\"/\"><strong>Tealium Docs</strong></a>\nA bookmark link to Tealium official documentation. This is a great starting point for implementers and developers.</li>\n<li><a href=\"https://support.tealiumiq.com/en/support/solutions\"><strong>Knowledge Base</strong></a>\nA bookmark link to Tealium Knowledge base, where you can search and find support.</li>\n</ul>\n<h2 id=\"community-tools\">Community tools</h2>\n<ul>\n<li><strong>Account Stats Report</strong>\nExport client-side (iQ) and server-side (CDH) usage statistics to a CSV file.</li>\n<li><strong>Bulk Edit Assets (Client-Side)</strong>\nManage multiple variables, load rules, tags, or extensions at once by toggling their active state or deleting them in bulk.</li>\n<li><strong>Connector Action Export</strong>\nExport connector actions, including names, IDs, and their attribute mappings (source and destination), to a CSV file.</li>\n<li><strong>Connector Logs Download</strong>\nView detailed logs of successful actions and errors, with the option to download error reports.</li>\n<li><strong>Cookie Helper</strong>\nRetrieve or set cookie values directly on the current page.</li>\n<li><strong>CSS Selector Tool</strong>\nIdentify the shortest jQuery selector that uniquely matches a single element on a page.</li>\n<li><strong>File Import Logs Download</strong>\nDownload logs for File Import and Omnichannel processes.</li>\n<li><strong>Profile Copy/Paste (Client-Side)</strong>\nCopy an entire TiQ profile from one account to another. Note: Individual elements cannot be selected.</li>\n<li><strong>Profile Exporter</strong>\nExport profile data, such as the data layer, tags, and rules, to a CSV file.</li>\n<li><strong>Tag Mappings Export (Client-Side)</strong>\nExport data mappings for tags, including variables used in load rules and mappings.</li>\n<li><strong>UDO Inspector</strong>\nGet a technical view of the Universal Data Object (UDO).</li>\n</ul>\n<h2 id=\"uninstall\">Uninstall</h2>\n<h3 id=\"chrome-1\">Chrome</h3>\n<p>Use the following steps to remove the Tealium Tools extension for the Google Chrome browser:</p>\n<ol>\n<li>In a Chrome browser window, go to <a href=\"https://chrome.google.com/webstore/detail/tealium-tools/gidnphnamcemailggkemcgclnjeeokaa\">Tealium Tools Chrome Extension</a>.</li>\n<li>Click <strong>Remove from Chrome</strong>. A confirmation dialog appears.</li>\n<li>Click <strong>Remove</strong> again to confirm.</li>\n</ol>\n<h3 id=\"edge-1\">Edge</h3>\n<p>Use the following steps to remove the Tealium Tools add-on for the Microsoft Edge browser:</p>\n<ol>\n<li>In an Edge browser window, go to <a href=\"https://microsoftedge.microsoft.com/addons/detail/tealium-tools/idhdcghfaooedcikdpjmbkfknlckhpfo\">Tealium Tools Edge Add-On</a>.</li>\n<li>Click <strong>Remove</strong>. A confirmation dialog appears.</li>\n<li>Click <strong>Remove</strong> again to confirm.</li>\n</ol>\n<h2 id=\"additional-information\">Additional information</h2>\n<ul>\n<li><strong><a href=\"https://support.tealiumiq.com/en/support/solutions/articles/36000363424-list-of-custom-tealium-tools\">List of Custom Tealium Tools</a></strong><br>\nDetailed information about available custom tools.</li>\n</ul>\n"
        }  

    , 
        {
            "weight": "800",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/tealium-tools-version-3/",
            "title": "Tealium Tools Version 3 Released",
            "body": "<p>For all release notes, see <a href=\"/release-notes/?filter=tealium-tools\">Tealium Tools release notes</a>.</p>\n<hr>\n<h2 id=\"whats-new\">What&rsquo;s new</h2>\n<p>This is an update to Tealium Tools browser extension available on the Google Chrome Web Store and as a Microsoft Edge Add-on.</p>\n<p>To install Tealium Tools Version 3, see <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a>.</p>\n<ul>\n<li>\n<p><strong>Tool Catalog</strong>:<br>\nThe <strong>Tool Catalog</strong> replaces Custom tools and now includes community tools grouped under this tab.</p>\n</li>\n<li>\n<p><strong>Support for Manifest V3</strong>:<br>\nGoogle Chrome is rolling out an important update that affects all Chrome extensions. This update removes the extensions&rsquo; ability to load custom JavaScript from external sources, such as Tealium’s custom tool repository server. This enforced update aims to provide Chrome users with additional security by preventing extensions from loading potentially malicious content that isn&rsquo;t contained within the extension itself. For more information, see <a href=\"https://developer.chrome.com/docs/extensions/develop/migrate/what-is-mv3\">Chrome for Developers: Extensions &gt; Manifest V3</a>.</p>\n</li>\n<li>\n<p><strong>Sidebar support</strong>:<br>\nYou can now open the tools window in the Chrome sidebar, allowing you to work seamlessly alongside on-page content. This is particularly useful for tools like <strong>Web Companion</strong>, which can now run unobstructed while you interact with your page.</p>\n</li>\n<li>\n<p><strong>Custom tile sorting</strong>:<br>\nYou can now sort and retain the tile order in both tabs. For accessibility, we’ve implemented a &ldquo;Click-and-Hold to Unlock&rdquo; feature similar to iOS. Hold the left mouse button on a tile for 3 seconds to enable &ldquo;Wobble Mode&rdquo; and rearrange tiles. This prevents accidental reordering while improving usability.</p>\n</li>\n<li>\n<p><strong>SSO login support</strong>:<br>\nSingle Sign-On (SSO) functionality is now more reliable. You can set your SSO domain and log in seamlessly – just ensure SSO is enabled on your account. Password and MFA logins are still supported. For SSO enablement, contact your Customer Success Manager.</p>\n</li>\n<li>\n<p><strong>uTag Debugger</strong>:<br>\nWe’re excited to include the <strong>uTag Debugger</strong> as an official tool on the <strong>Home</strong> tab. It’s a valuable resource for troubleshooting and validating deployments.</p>\n</li>\n<li>\n<p><strong>Built-in feedback form</strong>:<br>\nIn the admin section (accessed by clicking your user avatar), you’ll find two new tabs: <strong>About</strong> and <strong>Feedback</strong>. The Feedback tab currently supports bug submissions, pre-populating tool information to help us troubleshoot effectively. The <strong>About</strong> tab provides build details for support tickets and information about community tools.</p>\n</li>\n<li>\n<p><strong>Retired features</strong>:<br>\nThe following features have been removed:</p>\n<ul>\n<li><strong>Multi-Publish</strong></li>\n<li><strong>CDH Copy/Paste</strong></li>\n<li><strong>Scan Companion</strong></li>\n<li><strong>Verify - Test Recorder</strong>\nPlease contact support if your workflow has been affected by this change.</li>\n</ul>\n</li>\n<li>\n<p><strong>Updated tools</strong>:</p>\n<ul>\n<li><strong>Tealium University</strong>, <strong>Tealium Docs</strong>, and <strong>UTag Debugger</strong> are now available as separate launch tiles.</li>\n<li>The <strong>TLC</strong> tile has been renamed to <strong>Knowledge Base</strong>.</li>\n</ul>\n</li>\n<li>\n<p><strong>Early Access tools</strong>:<br>\nEarly Access tools now include a callout bubble, indicating they are publicly available but still in the early stages of release.</p>\n</li>\n</ul>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-version-3-comparison.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-version-3-comparison.png\"\n         alt=\"Screenshot comparing the old and new home page and the new Tool Catalog tab\"\n         title=\"Screenshot comparing the old and new home page and the new Tool Catalog tab\"/>\n    </a>\n</figure>\n"
        }  

    , 
        {
            "weight": "200",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/environment-switcher/",
            "title": "Tealium Tools Environment Switcher",
            "body": "<h2 id=\"how-it-works\">How it Works</h2>\n<p>The Environment Switcher is a powerful testing tool used to change the Tealium files (<code>utag.js</code>, <code>utag.sync.js</code>) that are loaded on a page by specifying a specific environment (Dev, QA, or Prod) and/or a specific account/profile.</p>\n<p>Use the Environment Switcher by adding the Tealium Tools extension. For more information, see <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a>.</p>\n<h2 id=\"using-the-environment-switcher\">Using the Environment Switcher</h2>\n<p>When you launch the Environment Switcher, the current account and profile detected on the page displays, along with configuration tabs that allow you to adjust the switcher according to your input.</p>\n<p>Once you have the Environment Switcher available in Tealium Tools, use the following steps to launch it:</p>\n<ol>\n<li>Click the <strong>Tealium Tools</strong> icon in the upper right of the screen.</li>\n<li>Click the <strong>Home</strong> tab.</li>\n<li>Click <strong>Environment Switcher</strong>.<br>\nThe Environment Switcher configuration screen displays a set of configuration tabs.</li>\n</ol>\n<h3 id=\"basic-configuration\">Basic Configuration</h3>\n<p>The options on the <strong>Basic</strong> tab allow you to load <code>utag.js</code> and <code>utag.sync</code>.js from different environments.</p>\n<p>Use the following steps to switch environments:</p>\n<ol>\n<li>Click the <strong>Basic</strong> tab.</li>\n<li>Click the environment you want to switch to.<br>\nWhen you select a new environment, the environment detected on the page is outlined in orange and the active environment on the page (the one you switched to) is highlighted in blue.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-basic-tab.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-basic-tab.jpg\"\n             alt=\"Tealium Tools_Environment Switcher_Basic Tab.jpg\"\n             title=\"Tealium Tools_Environment Switcher_Basic Tab.jpg\"/>\n        </a>\n    </figure></li>\n<li>Click <strong>Start</strong> to apply your changes.<br>\nThis action refreshes the current page.</li>\n</ol>\n<h3 id=\"advanced-configuration\"><strong>Advanced Configuration</strong></h3>\n<p>The options on the <strong>Advanced</strong> tab provide the following features:</p>\n<ul>\n<li>\n<p>Advanced redirects to load the Tealium files from a different account, profile, and environment.</p>\n  <p class=\"tip\"><i class=\"fa fa-info-circle\"></i>This is helpful if you use <a href=\"/iq-tag-management/profiles/profile-libraries/about/\">profile libraries</a> or <a href=\"/iq-tag-management/save-publish/custom-publish-environments/\">custom publish environments</a>.</p>\n</li>\n<li>\n<p>URL redirects to load the Tealium files from a custom URL location.</p>\n</li>\n<li>\n<p>Separate settings for each Tealium file and your browsing session..</p>\n</li>\n</ul>\n<h4 id=\"advanced-redirects\">Advanced Redirects</h4>\n<p>To redirect the <strong>Account</strong>, <strong>Profile</strong>, or <strong>Environment</strong>, click <strong>Advanced Redirect</strong> to expand.</p>\n<p>Type the source name for each in the <strong>Source</strong> column and the destination name for each in the <strong>Destination</strong> column.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-advanced-tab-advanced-redirect.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-advanced-tab-advanced-redirect.jpg\"\n         alt=\"Tealium Tools_Environment Switcher_Advanced Tab_Advanced Redirect.jpg\"\n         title=\"Tealium Tools_Environment Switcher_Advanced Tab_Advanced Redirect.jpg\"/>\n    </a>\n</figure></p>\n<h4 id=\"url-redirects\">URL Redirects</h4>\n<p>To redirect to a custom URL, click <strong>URL Redirect</strong> to expand.</p>\n<p>Type the source URL in the <strong>Source</strong> column and the destination URL in the <strong>Destination</strong> column.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-advanced-tab-url-redirect.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-advanced-tab-url-redirect.jpg\"\n         alt=\"Tealium Tools_Environment Switcher_Advanced Tab_URL Redirect.jpg\"\n         title=\"Tealium Tools_Environment Switcher_Advanced Tab_URL Redirect.jpg\"/>\n    </a>\n</figure></p>\n<h4 id=\"advanced-options\">Advanced Options</h4>\n<p>Click <strong>Advanced Options</strong> to select or deselect how your redirects are applied.</p>\n<p>Select or deselect one or more of the following:<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-advance-tab-advanced-options.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-advance-tab-advanced-options.jpg\"\n         alt=\"Tealium Tools_Environment Switcher_Advance Tab_Advanced Options.jpg\"\n         title=\"Tealium Tools_Environment Switcher_Advance Tab_Advanced Options.jpg\"/>\n    </a>\n</figure></p>\n<ul>\n<li><strong>Current Domain Only</strong> - only apply the redirects to the current domain. If you navigate to a different subdomain, the redirects are not applied.</li>\n<li><strong>Current Tab Only</strong> - only apply the redirects to the current browser tab. Other browser tabs, even if viewing the same page, will not be affected.</li>\n<li><strong>Apply to utag.js</strong> - apply the redirect to utag.js.</li>\n<li><strong>Apply to utag.sync.js</strong> - apply the redirect to utag.sync.js.</li>\n<li><strong>Set utag_cfg_ovrd.path</strong> - set a custom cookie path.</li>\n</ul>\n<p>Click <strong>Start</strong> to apply all changes made.</p>\n<h3 id=\"active-redirects\"><strong>Active Redirects</strong></h3>\n<p>After making any changes using the Environment Switcher, the <strong>Active Redirects</strong> tab is the default tab that displays the next time you initiate the switcher. This tab displays environments that are currently being switched.</p>\n<h4 id=\"disable-an-active-redirect\">Disable an Active Redirect</h4>\n<p>To disable an active redirect, click <strong>Stop</strong> in the Action column. The page is automatically refreshed and the Tealium files load normally, as coded in the page.</p>\n<ul>\n<li>In subsequent visits to this tab, you can select <strong>Refresh</strong> or <strong>Stop</strong> in the Action column.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-active-redirects-refresh-and-stop-buttons.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-active-redirects-refresh-and-stop-buttons.jpg\"\n         alt=\"Tealium Tools_Environment Switcher_Active Redirects_Refresh and Stop Buttons.jpg\"\n         title=\"Tealium Tools_Environment Switcher_Active Redirects_Refresh and Stop Buttons.jpg\"/>\n    </a>\n</figure></li>\n</ul>\n<h3 id=\"recent-redirects\">Recent Redirects</h3>\n<p>The <strong>Recent Redirects</strong> tab provides a history of recently used configurations, which makes it simple to reactivate a switcher that was previously configured.</p>\n<p>To reactivate a previously configured switcher:</p>\n<ol>\n<li>Click the <strong>Recent Redirects</strong> tab.<br>\nA list of recently configured switchers displays.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-recent-redirects-tab-start.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-recent-redirects-tab-start.jpg\"\n             alt=\"Tealium Tools_Environment Switcher_Recent Redirects Tab_Start.jpg\"\n             title=\"Tealium Tools_Environment Switcher_Recent Redirects Tab_Start.jpg\"/>\n        </a>\n    </figure></li>\n<li>Click the <strong>Start</strong> button next to the switcher that you want to reactivate.<br>\nThe page refreshes automatically and the changes are applied.</li>\n</ol>\n<h2 id=\"using-the-environment-switcher-with-custom-domains-or-path-overrides\">Using the Environment Switcher with custom domains or path overrides</h2>\n<p>Use the following setup instructions to use the Environment Switcher in self-hosted domains, private cloud environments, or when overriding configuration paths.</p>\n<h3 id=\"first-party-or-self-hosted-domains\">First-party or self-hosted domains</h3>\n<p>To use the Environment Switcher with a self-hosted or first-party domain:</p>\n<ol>\n<li>Click the user icon in the upper-right corner of the <strong>Tealium Tools</strong> extension.</li>\n<li>Click the <strong>Settings</strong> tab.</li>\n<li>In the <strong>Domain Prefix</strong> field, enter the domain loading the <code>utag.js</code> script (for example, <code>tags.domain.com</code>).</li>\n<li>Click <strong>Update Settings</strong>.<br>\nThe <strong>Environment Switcher</strong> screen loads.</li>\n<li>Select the environment you want to switch to and click <strong>Start</strong>.\nThe page refreshes, and a blue <strong>Environment Switcher</strong> bar appears at the bottom of the screen to indicate that the redirect is active.</li>\n</ol>\n<h3 id=\"private-cloud-environments\">Private cloud environments</h3>\n<p>To use the Environment Switcher with a private cloud environment:</p>\n<ol>\n<li>Click the user icon in the upper-right corner of the <strong>Tealium Tools</strong> extension.</li>\n<li>Click the <strong>Settings</strong> tab.</li>\n<li>In the <strong>Domain Prefix</strong> field, enter the account prefix used to load the <code>utag.js</code> script. For example, if your private cloud domain is <code>pc-company-my.tealiumiq.com</code>, the prefix is <code>pc-company</code>.</li>\n<li>Click <strong>Update Settings</strong>.<br>\nThe <strong>Environment Switcher</strong> screen loads.</li>\n<li>Select the environment you want to switch to and click <strong>Start</strong>.\nThe page refreshes, and a blue <strong>Environment Switcher</strong> bar appears at the bottom of the screen to indicate that the redirect is active.</li>\n</ol>\n<h3 id=\"configuration-path-overrides\">Configuration path overrides</h3>\n<p>To use path overrides with the Environment Switcher:</p>\n<ol>\n<li>Click the <strong>Home</strong> tab in the upper-right corner of the <strong>Tealium Tools</strong> extension.</li>\n<li>Click <strong>Environment Switcher</strong>.</li>\n<li>Click the <strong>Advanced</strong> tab.</li>\n<li>Expand <strong>Advanced Redirect</strong> and enter the new environment in the <strong>Destination</strong> column.</li>\n<li>Expand <strong>Advanced Options</strong>.</li>\n<li>Check <strong>Set utag_cfg_ovrd.path</strong>.</li>\n<li>Click <strong>Start</strong>.<br>\nThe page refreshes, and a blue <strong>Environment Switcher</strong> bar appears at the bottom of the screen to indicate that the redirect is active.</li>\n</ol>\n<h2 id=\"troubleshooting\">Troubleshooting</h2>\n<p>The <strong>Help</strong> tab provides troubleshooting options to force stop all active redirects or completely reset the Environment Switcher.</p>\n<h3 id=\"force-stop-all-active-redirects\"><strong>Force Stop All Active Redirects</strong></h3>\n<p>To force stop all active redirects:</p>\n<ol>\n<li>Click the <strong>Help</strong> tab.</li>\n<li>Click <strong>Force Stop all Active Redirects</strong>.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-help-tab-force-stop-all-active-redirects.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-help-tab-force-stop-all-active-redirects.jpg\"\n             alt=\"Tealium Tools_Environment Switcher_Help Tab_Force Stop All Active Redirects.jpg\"\n             title=\"Tealium Tools_Environment Switcher_Help Tab_Force Stop All Active Redirects.jpg\"/>\n        </a>\n    </figure><br>\nThe Active Redirects tab is now empty and all active redirects are stopped.</li>\n</ol>\n<h3 id=\"reset-environment-switcher-to-the-default-state\"><strong>Reset Environment Switcher to the Default State</strong></h3>\n<p>Resetting the Environment Switcher to the default state and stop all current redirects, remove all information saved in the UI setting, remove recent redirects, stop the backend service, and close the Tealium Tools window.</p>\n<p>Use the following steps to reset the Environment Switcher:</p>\n<ol>\n<li>Click the <strong>Help</strong> tab.</li>\n<li>Click <strong>Force Reset</strong> to expand.</li>\n<li>Click <strong>Reset Environment Switcher</strong>.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/tealium-tools-environment-switcher-help-tab-reset-environment-switcher.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/tealium-tools-environment-switcher-help-tab-reset-environment-switcher.jpg\"\n             alt=\"Tealium Tools_Environment Switcher_Help Tab_Reset Environment Switcher.jpg\"\n             title=\"Tealium Tools_Environment Switcher_Help Tab_Reset Environment Switcher.jpg\"/>\n        </a>\n    </figure></li>\n</ol>\n<p>The <strong>Active Redirects</strong> and <strong>Recent Redirects</strong> tabs are now empty. All active redirects are stopped and recent redirects are purged.</p>\n<h2 id=\"additional-information\">Additional Information</h2>\n<ul>\n<li><strong><a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a></strong><br>\nAn overview of the Tealium Tools browser extension and how to install it.</li>\n<li><strong><a href=\"https://support.tealiumiq.com/en/support/solutions/articles/36000363424-list-of-custom-tealium-tools\">List of Custom Tealium Tools</a></strong><br>\nDetailed information about available custom tools.</li>\n</ul>\n"
        }  

    , 
        {
            "weight": "300",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/utag-debugger/",
            "title": "Universal Tag Debugger",
            "body": "<h2 id=\"how-it-works\">How it works</h2>\n<p>The Universal Tag (UTAG) Debugger tool displays the <a href=\"/platforms/javascript/universal-data-object/\">Universal Data Object</a> and event tracking callstriggered by <code>utag.js</code> on a site.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/utag-debugger.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/utag-debugger.png\"/>\n    </a>\n</figure>\n<h2 id=\"install\">Install</h2>\n<h3 id=\"tealium-tools\">Tealium Tools</h3>\n<p>To install UTAG Debugger as a Tealium Tool, first install the <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a>.</p>\n<p>After you install the extension, follow these steps to add the custom tool:</p>\n<ol>\n<li>Click the Tealium icon in the upper-right of your browser to open Tealium Tools.</li>\n<li>Go to the <strong>Custom Tools</strong> tab and click the square for <strong>+ Custom Tools</strong>, then click <strong>Add Custom Tools</strong>.</li>\n<li>Next, copy and paste the following JSON code in the field for <strong>Add by JSON Definition</strong> then click <strong>Add Custom Tool</strong>:\n<div class=\"highlight\"><pre tabindex=\"0\" style=\"color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"><code class=\"language-json\" data-lang=\"json\"><span style=\"display:flex;\"><span>{\n</span></span><span style=\"display:flex;\"><span>    <span style=\"color:#f92672\">&#34;id&#34;</span> : <span style=\"color:#e6db74\">&#34;teal.sol.debug&#34;</span>,\n</span></span><span style=\"display:flex;\"><span>    <span style=\"color:#f92672\">&#34;title&#34;</span> : <span style=\"color:#e6db74\">&#34;UTAG Debugger&#34;</span>,\n</span></span><span style=\"display:flex;\"><span>    <span style=\"color:#f92672\">&#34;description&#34;</span> : <span style=\"color:#e6db74\">&#34;Universal Tag Debugger&#34;</span>,\n</span></span><span style=\"display:flex;\"><span>    <span style=\"color:#f92672\">&#34;no_ui&#34;</span> : <span style=\"color:#66d9ef\">true</span>,\n</span></span><span style=\"display:flex;\"><span>    <span style=\"color:#f92672\">&#34;scripts&#34;</span> : {\n</span></span><span style=\"display:flex;\"><span>        <span style=\"color:#f92672\">&#34;utag_monitor&#34;</span> : {\n</span></span><span style=\"display:flex;\"><span>            <span style=\"color:#f92672\">&#34;js&#34;</span> : <span style=\"color:#e6db74\">&#34;void(window.open(\\&#34;\\&#34;,\\&#34;utagmon\\&#34;,\\&#34;width=700,height=600,location=0,menubar=0,status=1,toolbar=0,resizable=1,scrollbars=1\\&#34;).document.write(\\&#34;&lt;script language=&#39;JavaScript&#39; id=&#39;utagmon&#39; src=&#39;//tags.tiqcdn.com/utag/tealium-solutions/main/prod/utag.4.js?opt_show_enrich=0&amp;opt_show_meta=0&amp;opt_show_query=0&amp;opt_show_jspage=0&amp;opt_show_tiq=1&amp;opt_show_cookie=0&amp;_cb=\\&#34;+Math.random()+\\&#34;&#39;&gt;&lt;/\\&#34;+\\&#34;script&gt;\\&#34;));&#34;</span>,\n</span></span><span style=\"display:flex;\"><span>            <span style=\"color:#f92672\">&#34;auto_inject&#34;</span> : <span style=\"color:#66d9ef\">true</span>\n</span></span><span style=\"display:flex;\"><span>        }\n</span></span><span style=\"display:flex;\"><span>    }\n</span></span><span style=\"display:flex;\"><span>}\n</span></span></code></pre></div></li>\n<li>When complete, a new button with the tool name appears on the <strong>Custom Tools</strong> tab.</li>\n</ol>\n<h3 id=\"bookmarklet\">Bookmarklet</h3>\n<p>To install UTAG Debugger as a bookmark, copy the following code into the URL of a new bookmark:</p>\n<div class=\"highlight\"><pre tabindex=\"0\" style=\"color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"><code class=\"language-js\" data-lang=\"js\"><span style=\"display:flex;\"><span><span style=\"color:#a6e22e\">javascript</span><span style=\"color:#f92672\">:</span><span style=\"color:#66d9ef\">void</span>(window.<span style=\"color:#a6e22e\">open</span>(<span style=\"color:#e6db74\">&#34;&#34;</span>,<span style=\"color:#e6db74\">&#34;utagmon&#34;</span>,<span style=\"color:#e6db74\">&#34;width=700,height=600,location=0,menubar=0,status=1,toolbar=0,\n</span></span></span><span style=\"display:flex;\"><span><span style=\"color:#e6db74\">resizable=1,scrollbars=1&#34;</span>).document.<span style=\"color:#a6e22e\">write</span>(<span style=\"color:#e6db74\">&#34;&lt;script language=&#39;JavaScript&#39; id=&#39;utagmon&#39;\n</span></span></span><span style=\"display:flex;\"><span><span style=\"color:#e6db74\">src=&#39;//tags.tiqcdn.com/utag/tealium-solutions/main/prod/utag.4.js?\n</span></span></span><span style=\"display:flex;\"><span><span style=\"color:#e6db74\">opt_show_enrich=0&amp;opt_show_meta=0&amp;opt_show_tiq=1&amp;opt_show_dom=0&amp;opt_show_jspage=0&amp;opt_show_cookie=0&amp;_cb=&#34;</span>\n</span></span><span style=\"display:flex;\"><span><span style=\"color:#f92672\">+</span>Math.<span style=\"color:#a6e22e\">random</span>() <span style=\"color:#f92672\">+</span><span style=\"color:#e6db74\">&#34;&#39;&gt;&lt;/&#34;</span><span style=\"color:#f92672\">+</span><span style=\"color:#e6db74\">&#34;script&gt;&#34;</span>))\n</span></span></code></pre></div><h2 id=\"use-utag-debugger\">Use UTAG Debugger</h2>\n<p>To launch UTAG Debugger, follow these steps:</p>\n<ol>\n<li>Navigate to your site.</li>\n<li>For Tealium Tools, open Tealium Tools and click <strong>UTag Debugger</strong>.</li>\n<li>For the bookmarklet, click the bookmark in your browser toolbar.\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/utag-debugger-bookmarklet.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/utag-debugger-bookmarklet.png\"/>\n        </a>\n    </figure></li>\n</ol>\n<h3 id=\"version-and-display-options\">Version and display options</h3>\n<p>When UTAG Debugger is open, the top section displays the <code>utag.js</code> file detected on the page with the following information:</p>\n<ul>\n<li>The <code>account/profile/environment</code> of the <code>utag.js</code> file on the page.</li>\n<li>The version of the <code>utag.js</code> file on the page.</li>\n</ul>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/utag-debugger-options.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/utag-debugger-options.png\"/>\n    </a>\n</figure>\n<p>Use the following features:</p>\n<ul>\n<li>\n<p><strong>Bookmarklet</strong> – Save your preferred display options by dragging the link to your browser&rsquo;s toolbar.</p>\n</li>\n<li>\n<p><strong>Events</strong> – The tracking events detected on the page are either <code>view</code> events or <code>link</code> events. Toggle these checkboxes to filter the display.</p>\n</li>\n<li>\n<p><strong>Scope</strong> - Select the scope of the UDO data to display. The default is <strong>Before load rules</strong>.</p>\n  <p class=\"tip\"><i class=\"fa fa-info-circle\"></i>The UDO variables displayed in the tool are captured after extensions scoped to <strong>All Tags - Before Load Rules</strong> and after extensions scoped to <strong>All Tags - After Load Rules</strong>. Learn more about <a href=\"/iq-tag-management/getting-started/order-of-operations/\">order of operations</a>.</p>\n</li>\n<li>\n<p><strong>Show Data</strong> – Select the variable types to display. The UDO variables are always displayed.</p>\n</li>\n</ul>\n<h3 id=\"variable-types\">Variable types</h3>\n<p>The following variable types are available:</p>\n<ul>\n<li><strong>iQ</strong> – Built-in data collected by <code>utag.js</code>, including DOM attributes and variables prefixed with <code>ut.</code> (for example: <code>ut.profile</code>).</li>\n<li><strong>Cookie</strong> – All first-party cookies available in the page.</li>\n<li><strong>JS Page</strong> – JavaScript page variables defined in your data layer (variables other than <code>utag_data</code>).</li>\n<li><strong>Querystring</strong> – Query string variables found in the URL.</li>\n<li><strong>Meta</strong> – All meta data values available in the page.</li>\n<li><strong>AudienceStream</strong> – Variables populated by data layer enrichment.</li>\n<li><strong>Local storage</strong> – Local storage variables defined in your data layer.</li>\n<li><strong>Session storage</strong> – Session storage variables defined in your data layer.</li>\n</ul>\n<p>For more information, see <a href=\"/iq-tag-management/data-layer/data-layer-variables/\">Data layer variable types</a>.</p>\n<h3 id=\"events\">Events</h3>\n<p>The data display area automatically updates as you navigate or trigger events. New pages are listed as <code>utag_view</code> events and in-page events are listed as <code>utag_link</code> events.</p>\n<p>The following example shows two pages visited and one event triggered. The result is two <code>utag_view</code> entries and one <code>utag_link</code> entry. The most recent activity always appears at the top.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/utagmon-event-display.jpg\"><img src=\"https://docs.tealium.com/images/iq-tag-management/utagmon-event-display.jpg\"/>\n    </a>\n</figure>\n"
        }  

    , 
        {
            "weight": "300",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/web-companion/",
            "title": "Web Companion",
            "body": "<h2 id=\"install-web-companion\">Install Web Companion</h2>\n<p>Web Companion can be installed from your iQ Tag Management account or directly from the Tealium Tools browser plugin.</p>\n<h3 id=\"from-tealium-tools\">From Tealium Tools</h3>\n<ol>\n<li>Install the <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools browser plugin</a>.</li>\n<li>In the <strong>Home</strong> tab, click <strong>Web Companion</strong>.</li>\n</ol>\n<h3 id=\"using-iq-tag-management\">Using iQ Tag Management</h3>\n<p>Use the following steps to install Web Companion:</p>\n<ol>\n<li>Click your name in the upper-right corner of TiQ console.</li>\n<li>Under <strong>Account Admin</strong> settings, select <strong>Web Companion</strong> from the drop-down list.<br>\nA pop-up window containing instructions to install Web Companion displays.</li>\n<li>Drag the <strong>Tealium Web Companion</strong> link from the message box on to your browser&rsquo;s bookmark bar.</li>\n</ol>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/iq-web-companion.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/iq-web-companion.png\"\n         alt=\"Your browser&#39;s bookmark bar\"\n         title=\"Your browser&amp;rsquo;s bookmark bar\"/>\n    </a>\n</figure>\n<h3 id=\"bookmarklet\">Bookmarklet</h3>\n<p>To install Web Companion as a bookmark, copy the following code into the URL of a new bookmark:</p>\n<div class=\"highlight\"><pre tabindex=\"0\" style=\"color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"><code class=\"language-js\" data-lang=\"js\"><span style=\"display:flex;\"><span><span style=\"color:#a6e22e\">javascript</span><span style=\"color:#f92672\">:</span>(<span style=\"color:#66d9ef\">function</span>()<span style=\"color:#f92672\">%</span><span style=\"color:#ae81ff\">7</span><span style=\"color:#a6e22e\">Bif</span>(<span style=\"color:#66d9ef\">typeof</span><span style=\"color:#f92672\">%</span><span style=\"color:#ae81ff\">20__</span><span style=\"color:#a6e22e\">tealium_tagcompanion</span><span style=\"color:#f92672\">==</span><span style=\"color:#e6db74\">&#39;undefined&#39;</span>)<span style=\"color:#f92672\">%</span><span style=\"color:#ae81ff\">7</span><span style=\"color:#a6e22e\">B__tealium_tagcompanion</span><span style=\"color:#f92672\">=</span>document.<span style=\"color:#a6e22e\">createElement</span>(<span style=\"color:#e6db74\">&#39;SCRIPT&#39;</span>);<span style=\"color:#a6e22e\">__tealium_tagcompanion</span>.<span style=\"color:#a6e22e\">type</span><span style=\"color:#f92672\">=</span><span style=\"color:#e6db74\">&#39;text/javascript&#39;</span>;<span style=\"color:#a6e22e\">__tealium_tagcompanion</span>.<span style=\"color:#a6e22e\">src</span><span style=\"color:#f92672\">=</span><span style=\"color:#e6db74\">&#39;//tags.tiqcdn.com/utui//utui.tagcompanion.js?v=&#39;</span><span style=\"color:#f92672\">+</span>Math.<span style=\"color:#a6e22e\">random</span>();document.<span style=\"color:#a6e22e\">getElementsByTagName</span>(<span style=\"color:#e6db74\">&#39;head&#39;</span>)[<span style=\"color:#ae81ff\">0</span>].<span style=\"color:#a6e22e\">appendChild</span>(<span style=\"color:#a6e22e\">__tealium_tagcompanion</span>);}})();\n</span></span></code></pre></div><h2 id=\"launch-web-companion\">Launch Web Companion</h2>\n<p>To launch Web Companion, navigate to your site where the Universal Tag (<code>utag.js</code>) is installed, then either click the <strong>Web Companion</strong> link in your browser&rsquo;s bookmark bar or open it from the Tealium Tools browser plugin.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-tlc.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-tlc.png\"\n         alt=\"Web Companion link\"\n         title=\"Web Companion link\"/>\n    </a>\n</figure>\n<h2 id=\"using-web-companion\">Using Web Companion</h2>\n<p>Web Companion is organized into three screens (or tabs): <strong>Overview</strong>, <strong>Data</strong>, and <strong>Tools</strong>. The following sections describe what is available on each tab.</p>\n<h3 id=\"overview-tab\">Overview tab</h3>\n<ul>\n<li><strong>Account Information</strong><br>\nThe current account, profile, version, and environment that the page is running appear under this tab.</li>\n<li><strong>Target Environment (Disabled by Default)</strong><br>\nThe 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 want to load, then click <strong>Refresh Page</strong>. Learn about other <a href=\"/iq-tag-management/troubleshooting/switch-environoment/\">methods of switching environments</a>.</li>\n</ul>\n<p class=\"note\"><i class=\"fa fa-exclamation-triangle\"></i>To enable this feature, turn on <a href=\"/iq-tag-management/save-publish/publish-configuration/\">the Web Companion setting in your publish settings</a>.</p>\n<ul>\n<li><strong>Tags &amp; Extensions Tabs</strong><br>\nThis tab will show which tags loaded and whether they successfully sent requests. The extensions that have successfully completed will also be displayed.</li>\n<li><strong>Timers</strong><br>\nThe load and send times of the tag are displayed.\n<ul>\n<li><strong>Loaded</strong> - The time to load the <code>utag.js</code> file into the page.</li>\n<li><strong>Sent</strong> - The time to trigger all the vendor tags on the page.</li>\n</ul>\n</li>\n<li><strong>Queue (unsaved changes)</strong><br>\nChanges applied to the profile using Web Companion are queued and will not be committed until you click the <strong>Save&hellip;</strong> button. If you do not want to commit a change, you may also remove that change from the queue by clicking on the <strong>X</strong> next to the appropriate change.</li>\n</ul>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-unsaved-changes.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-unsaved-changes.png\"/>\n    </a>\n</figure>\n<h3 id=\"data-tab\">Data tab</h3>\n<p>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 <strong>Add</strong> buttons.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-data.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-data.png\"/>\n    </a>\n</figure>\n<p>The following types of data can be viewed:</p>\n<ul>\n<li><strong>HTML Metadata</strong><br>\nInformation about the web page, author, title, and other meta elements of the HTML document.</li>\n<li><strong>Querystring Parameters</strong>**<br>\nThe name and value of a parameter located within the query string of the URL.</li>\n<li><strong>Cookies</strong><br>\nSmall files that store visitor and session information.</li>\n<li><strong>JavaScript Variables</strong><br>\nJavaScript page variables other than <code>utag_data</code>.</li>\n<li><strong><a href=\"/platforms/javascript/universal-data-object/\">Universal Data Object</a></strong></li>\n</ul>\n<h4 id=\"add-a-variable-to-your-data-layer\">Add a variable to your data layer</h4>\n<p>Use the following steps to add a variable to your data layer:</p>\n<ol>\n<li>Click <strong>Data tab</strong> and select a data type.<br>\nA list of variables appears.</li>\n<li>Locate the variable you want and click <strong>+Add</strong>.<br>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-js-variables.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-js-variables.png\"/>\n    </a>\n</figure></li>\n</ol>\n<h4 id=\"universal-data-object\">Universal Data Object</h4>\n<p>The Universal Data object (UDO), or <code>utag_data</code>, view shows the detected data object on the page. For more information, see the guide to <a href=\"/iq-tag-management/data-layer/how-it-works/\">the data layer for websites.</a>.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-udo.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-udo.png\"/>\n    </a>\n</figure>\n<h3 id=\"tools-tab\">Tools tab</h3>\n<p>The <strong>Tools</strong> tab offers convenience features to make it easier to add configuration to your account.</p>\n<p><figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-tools.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-tools.png\"/>\n    </a>\n</figure>\nThe following tools are available:</p>\n<ul>\n<li><strong>On-Page Element Selector</strong><br>\nUse this simple point and click tool to select an element on the page to be used in event tracking or content modification.</li>\n<li><strong>Load Rule Helper</strong><br>\nCreate a load rule condition directly from the page that you want to target. Built-in page variable values will be pre-filled based on the current page.</li>\n<li><strong>Custom Target Environments</strong><br>\nUse this tool to switch to environments other than the default Dev, QA, and Prod.</li>\n<li><strong>Adobe Test and Target</strong><br>\nUse this tool to assist in the configuration of the Adobe Target tag in your account.</li>\n</ul>\n<p class=\"note\"><i class=\"fa fa-exclamation-triangle\"></i>An extension or load rule added to your account with Web Companion is not active until you return to iQ Tag Management to enable and publish them.</p>\n<h4 id=\"on-page-element-selector\"><strong>On-Page Element Selector</strong></h4>\n<p>Select an element on the web page 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 <strong>Queue</strong> and save the extension to your profile.</p>\n<p>The related DOM node information will also be displayed.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/jquery-web-companion.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/jquery-web-companion.png\"\n         alt=\"jQuery Web Companion\"\n         title=\"jQuery Web Companion\"/>\n    </a>\n</figure>\n<h4 id=\"load-rule-helper\"><strong>Load Rule Helper</strong></h4>\n<p>Create a new load rule to determine the location and instant a tag should load. Click <strong>Add to Queue</strong> and save the load rule to your profile.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-load-rule-helper.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-load-rule-helper.png\"/>\n    </a>\n</figure>\n<h4 id=\"custom-target-environment\"><strong>Custom Target Environment</strong></h4>\n<p>Publish to a custom environment instead of the three default environments (Dev, QA, and Prod). Enter the name of the target environment in the text box and click <strong>Set Environment</strong>.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-custom-target.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-custom-target.png\"/>\n    </a>\n</figure>\n<h4 id=\"adobe-test-and-target\"><strong>Adobe Test and Target</strong></h4>\n<p>Add this extension to modify the content you want on the page. Configure the extension and click <strong>Add to Queue</strong> to save it to your profile. For more details, see <a href=\"/iq-tag-management/extensions/extensions-list/adobe-target-extension/\">Adobe Test and Target Extension</a>.</p>\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/web-companion-adobe-target.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/web-companion-adobe-target.png\"/>\n    </a>\n</figure>\n"
        }  

    , 
        {
            "weight": "400",
            "url": "https://docs.tealium.com/iq-tag-management/tealium-tools/web-companion-tool-adobe-test-amp-target/",
            "title": "Web Companion Adobe Test & Target",
            "body": "<p>To use the Adobe Test &amp; Target tool in Web Companion:</p>\n<ol>\n<li>\n<p>Click on the Web Companion bookmarklet to open Web Companion.</p>\n</li>\n<li>\n<p>Navigate to the Tools tab.\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/no-title-1319if034cb2cd6b3f073.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/no-title-1319if034cb2cd6b3f073.png\"\n             alt=\"Tools_Tab.png\"\n             title=\"Tools_Tab.png\"/>\n        </a>\n    </figure></p>\n</li>\n<li>\n<p>Click on the Adobe Test and Target bar.</p>\n</li>\n<li>\n<p>Click <strong>Select Target</strong>. The On Page Element Selector crosshairs are displayed.</p>\n</li>\n<li>\n<p>With those crosshairs, select the element you want to apply a test to.</p>\n</li>\n<li>\n<p>Web Companion will populate the identifying information for the element you selected. Enter the mBox info and Static params.\n<figure><a class=\"slb\" href=\"/images/iq-tag-management/no-title-1318i318bf7765a3d7dfb.png\"><img src=\"https://docs.tealium.com/images/iq-tag-management/no-title-1318i318bf7765a3d7dfb.png\"\n             alt=\"Configured_Extension.png\"\n             title=\"Configured_Extension.png\"/>\n        </a>\n    </figure></p>\n</li>\n<li>\n<p>Select the placement for the modifying content. For more information on this see the <a href=\"/client-side-tags/adobe-test-target-tag/\">Test &amp; Target</a> article.</p>\n</li>\n<li>\n<p>Check the box next to Flicker Free to use Tealium&rsquo;s Flicker Free solution. See the <a href=\"/client-side-tags/flicker-free-test-and-target/\">Flicker Free Test and Target</a> article.</p>\n</li>\n<li>\n<p>From the drop-down at the bottom of Web Companion, select the Tag you want to scope this Extension to.</p>\n</li>\n<li>\n<p>Click <strong>New Tag</strong> to add a new instance of the Test and Target Tag.</p>\n</li>\n<li>\n<p>Click <strong>Add to Queue</strong>.</p>\n</li>\n<li>\n<p>Navigate to the Queue and click <strong>Save</strong>.</p>\n</li>\n<li>\n<p>Enter your Tealium iQ login information and click <strong>Login</strong>.</p>\n</li>\n<li>\n<p>By default, anything added with Web Companion is turned off in Tealium iQ. Log in to Tealium iQ and turn on the tag and/or extension you added.</p>\n</li>\n<li>\n<p>Save/Publish the profile.</p>\n</li>\n</ol>\n"
        }  

    , 
        {
            "weight": "0",
            "url": "https://docs.tealium.com/server-side/tealium-tools/optimizely-helper/",
            "title": "Tealium Tool Optimizely Helper",
            "body": "<h3 id=\"installing-tealium-tools\">Installing Tealium Tools</h3>\n<p>Make sure you have the latest version of Tealium Tools installed. This Google Chrome extension provides a variety of tools, including the Optimizely Helper. For more information, see <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a>.</p>\n<h3 id=\"connecting-your-optimizely-account\">Connecting Your Optimizely Account</h3>\n<p>After you have installed Tealium Tools, use these steps, along with the API Token and the Project ID from Optimizely, to connect AudienceStream and Optimizely:</p>\n<ol>\n<li>In Optimizely, navigate to <strong>Account Settings</strong> and click <strong>View Tokens</strong> under the API Tokens section.</li>\n<li>Create a new API Token and copy the new token to your clipboard.</li>\n<li>Open <strong>Tealium Tools</strong> by clicking the Tealium icon in the top-right corner of Google Chrome.</li>\n<li>Select <strong>Optimizely Helper</strong>.</li>\n<li>Paste the API Token into the <strong>Token</strong> field.</li>\n<li>Navigate to the project in which you&rsquo;d like to map AudienceStream audiences and copy the Project ID. The Project ID is available from the <strong>Project Code</strong> drop-down menu in the top-right corner of the Project page.<br>\n<figure><a class=\"slb\" href=\"/images/server-side/optimizely-helper-project-id.png\"><img src=\"https://docs.tealium.com/images/server-side/optimizely-helper-project-id.png\" width=\"432\" height=\"383\"/>\n        </a>\n    </figure></li>\n<li>In the Optimizely Helper, paste the Project ID into the <strong>Project ID</strong> field.</li>\n<li>Enter the name of the Tealium account and profile you would like to associate with this Optimizely project.</li>\n<li>Click <strong>Import Audience Data</strong>.</li>\n</ol>\n<p>The Optimizely Helper now contains a list of audiences and badges that you can map to new or existing audiences in Optimizely.</p>\n<h3 id=\"mapping-audiences-to-an-optimizely-project\">Mapping Audiences to an Optimizely Project</h3>\n<ol>\n<li>In the Optimizely Helper, select the AudienceStream audience or badge to add to Optimizely.</li>\n<li>On the Optimizely Audience drop-down menu, select an existing Optimizely Audience or create a new one. If you create a new Optimizely Audience, the name is the same as the name of the AudienceStream badge or audience you selected.</li>\n<li>Click <strong>Create Audience</strong> to confirm.</li>\n<li>To create additional audience mappings, repeat the steps above.</li>\n</ol>\n<p>After you have mapped audiences, click <strong>Generate Code Snippet</strong>. This code needs to be added to the utag.sync.js file.<br>\n<figure><a class=\"slb\" href=\"/images/server-side/optimizely-helper-code-snippet.png\"><img src=\"https://docs.tealium.com/images/server-side/optimizely-helper-code-snippet.png\"/>\n    </a>\n</figure></p>\n<p>To add the code to the utag.sync.js template, click <strong>Copy Code Snippet to Clipboard</strong>. For more information, see <a href=\"/iq-tag-management/getting-started/install/utag-sync/\">Using the utag.sync.js Script</a>.</p>\n<h3 id=\"create-audience-based-experiments\">Create Audience-based Experiments</h3>\n<p>Your project now has the mapped AudienceStream badges and audiences available for targeting. To select a new target audience:</p>\n<ol>\n<li>Create a new experiment or edit an existing experiment and click <strong>Audience Targeting</strong>.</li>\n<li>Click <strong>Add a Saved Audience</strong> and select an AudienceStream badge or audience.\n<figure><a class=\"slb\" href=\"/images/server-side/audiencebasedexperiments.png\"><img src=\"https://docs.tealium.com/images/server-side/audiencebasedexperiments.png\"\n             alt=\"AudienceBasedExperiments.png\"\n             title=\"AudienceBasedExperiments.png\"/>\n        </a>\n    </figure></li>\n<li>Save your experiment.</li>\n</ol>\n<p>For more information on targeting audiences in Optimizely, refer to the <a href=\"https://help.optimizely.com/hc/en-us/articles/200039685#changes\">Optimizely knowledge base article.</a></p>\n"
        }  

    , 
        {
            "weight": "0",
            "url": "https://docs.tealium.com/server-side/tealium-tools/mobile-qr-trace/",
            "title": "Tealium Tools Mobile QR Trace",
            "body": "<h2 id=\"how-it-works\">How it Works</h2>\n<p>After clicking <strong>Start Trace</strong> in the tool, once per Customer Data Hub session, a QR code is automatically injected into the main browser window each time you start a new trace.</p>\n<p>QR codes are generated for each platform (<a href=\"https://docs.tealium.com/platforms/android-kotlin/\">Android</a> or <a href=\"https://docs.tealium.com/platforms/ios-swift/\">iOS</a>). After you scan the appropriate QR code with the appropriate mobile device&rsquo;s camera, click the link from the QR code to start the app and pass trace parameters to the Tealium SDK. The Tealium SDK receives the trace ID (along with other parameters) and inserts the trace ID into the data layer for the current session</p>\n<p>All subsequent events are recorded in the trace session until you end the session or leave the trace.</p>\n<p>The following diagram illustrates how it works: <figure><a class=\"slb\" href=\"/images/server-side/screen-shot-2020-09-11-at-3.23.40-pm.png\"><img src=\"https://docs.tealium.com/images/server-side/screen-shot-2020-09-11-at-3.23.40-pm.png\"\n         alt=\"Screen Shot 2020-09-11 at 3.23.40 PM.png\"\n         title=\"Screen Shot 2020-09-11 at 3.23.40 PM.png\"/>\n    </a>\n</figure></p>\n<h2 id=\"install\">Install</h2>\n<p>To use this tool, you must first add it your Chrome browser using the Tealium Tools extension. To install this extension, see <a href=\"/iq-tag-management/tealium-tools/browser-extension/\">Tealium Tools Browser Extension</a>.</p>\n<p>In the <strong>Add by URL</strong> text field, paste the URL: <code>https://solutions.tealium.net/hosted/tealiumTools/mobile-trace/tool.json</code></p>\n<p>When installation has completed, launch the Mobile Trace Tool icon from the Tealium Tools extension.</p>\n<h2 id=\"url-schemes\">URL Schemes</h2>\n<p>To use the Mobile Trace tool, determine which URLs are handled by your Android and iOS apps to configure the URL schemes.</p>\n<p>The QR code trace feature launches your app from a URL and listens for a specific query parameter. To launch your app directly from a URL, your app must have registered itself to handle specific domains.</p>\n<p>Typically, most apps already handle specific URLs. For example, if your website domain is <code>https://mycompany.com</code> , your app registers itself as a handler for this domain and, if your app is installed on a user&rsquo;s device, the user is prompted to launch the link in your app instead of within a browser.</p>\n<p class=\"note\"><i class=\"fa fa-exclamation-triangle\"></i>Some apps register custom URL schemes instead of <code>http</code> or <code>https</code>, for example <code>mycompanyapp://</code>. These also work with the Mobile Trace Tool.</p>\n<p>Once you have established which URL schemes launch your app, enter these into the input fields in the Mobile Trace Tool. The tool supports different schemes for Android and iOS if necessary, but in general, these are the same for both platforms.</p>\n<figure><a class=\"slb\" href=\"/images/server-side/screen-shot-2020-09-11-at-3.41.58-pm.png\"><img src=\"https://docs.tealium.com/images/server-side/screen-shot-2020-09-11-at-3.41.58-pm.png\"\n         alt=\"Screen Shot 2020-09-11 at 3.41.58 PM.png\"\n         title=\"Screen Shot 2020-09-11 at 3.41.58 PM.png\"/>\n    </a>\n</figure>\n<p>Click <strong>Save</strong> next to each URL scheme to store the setting in the browser&rsquo;s localStorage. Click the blue pencil icon to edit the URL schemes as needed.</p>\n<h2 id=\"trace\">Trace</h2>\n<p>The following describes how to start and leave a trace using the Mobile Trace Tool.</p>\n<h3 id=\"start-trace\">Start Trace</h3>\n<p>Before starting a trace, verify that you are in the server-side Customer Data Hub. Click <strong>Start Trace</strong> in the Mobile Trace Tool, which starts a new trace and adds the Mobile Trace QR codes into the trace window.</p>\n<figure><a class=\"slb\" href=\"/images/server-side/screen-shot-2020-09-11-at-3.46.20-pm.png\"><img src=\"https://docs.tealium.com/images/server-side/screen-shot-2020-09-11-at-3.46.20-pm.png\"\n         alt=\"Screen Shot 2020-09-11 at 3.46.20 PM.png\"\n         title=\"Screen Shot 2020-09-11 at 3.46.20 PM.png\"/>\n    </a>\n</figure>\n<p>After you have started a trace once from the Tealium Tools UI, close the Tealium Tools UI and you don&rsquo;t need to use it for the rest of your session.</p>\n<p>Subsequent traces are started directly from Customer Data Hub, and the QR code automatically refreshes each time a new trace starts. Scan the QR code with your device&rsquo;s camera, click the link to launch your app and automatically begin tracing. Any Tealium events generated by your app after joining the trace are recorded in your trace session.</p>\n<figure><a class=\"slb\" href=\"/images/server-side/screen-shot-2020-09-11-at-3.48.06-pm.png\"><img src=\"https://docs.tealium.com/images/server-side/screen-shot-2020-09-11-at-3.48.06-pm.png\"\n         alt=\"Screen Shot 2020-09-11 at 3.48.06 PM.png\"\n         title=\"Screen Shot 2020-09-11 at 3.48.06 PM.png\"/>\n    </a>\n</figure>\n<h3 id=\"leave-trace\">Leave Trace</h3>\n<p>If you leave a trace session without ending it, you are able to rejoin the same trace from a different device without losing the history of that trace session.</p>\n<p>To leave a trace:</p>\n<ol>\n<li>Select the <strong>Leave Trace</strong> checkbox in the trace UI</li>\n<li>Scan the QR code again with your device&rsquo;s camera</li>\n<li>Click the link for your device to no longer participate in the trace session</li>\n</ol>\n<h3 id=\"end-of-visit-audiencestream\">End of Visit (AudienceStream)</h3>\n<p>Testing &ldquo;End of Visit&rdquo; actions in Tealium AudienceStream requires a signal to immediately end the visitor&rsquo;s session, otherwise it is necessary to wait for the session to expire normally.</p>\n<p>In the Mobile Trace Tool, end the session immediately by selecting the <strong>Kill Visitor Session</strong> checkbox, which adds a parameter to the QR code that makes the SDK send a <code>kill_visitor_session</code> event.</p>\n<figure><a class=\"slb\" href=\"/images/server-side/screen-shot-2020-09-11-at-3.50.27-pm.png\"><img src=\"https://docs.tealium.com/images/server-side/screen-shot-2020-09-11-at-3.50.27-pm.png\"\n         alt=\"Screen Shot 2020-09-11 at 3.50.27 PM.png\"\n         title=\"Screen Shot 2020-09-11 at 3.50.27 PM.png\"/>\n    </a>\n</figure>\n"
        }  

    ]
}
