Tags

Tags

by on ‎03-04-2015 10:44 PM - edited on ‎12-04-2017 09:31 AM by Community Manager (17,865 Views)

The Tags tab is used to manage the vendor tags that will load on your website. Use these tags in conjunction with load rules to determine when and where a tag should load. 

This article covers the following topics:

Table of Contents Placeholder

How it Works

In the Tealium iQ interface, the Tags tab provides the ability to add, load, and configure tags on your websites with just a few points and clicks.

Adding a Tag

Use the following steps to add a tag:

  1. From the Tealium iQ interface, click the Tags tab.

  2. Click +Add Tag.
    The Tag Marketplace dialog displays.

  3. Locate the tag for a vendor using one (1) of the following three (3) methods:
    If you have enabled the Tag Marketplace Policy to show or hide specific tags, the Tag Marketplace display will vary accordingly. Tags hidden by the policy do not appear in the Tag Marketplace
    1. Search
      Enter the name of the vendor in the text box and click +Add next to the desired tag from the list of results.

      TiQ_Tag Marketplace_Search Tags.png
    2. Categories
      From the left sidebar, browse a vendor category, locate your tag in the listing and click +Add.

      Tags_Search Tag Marketplace by Category.png
    3. Detect Tag From Code
      Click Detect Tag from Code and enter the code snippet provided by your tag vendor. If the code is recognized, the matching tag will be added with the settings automatically configured.

      Tags_Detect Tag from Code.png
    4. Title/Tag Configuration
      Enter a title for the tag. If you have multiple instances of the same tag, use a descriptive title to distinguish it from the other instances.

      Tags_Add Additional Instance of Same Tag_Optimizely Example.png

      For Universal Data Hub accounts enabled for DataAccess, tag titles are included as column values in EventDB; characters for a Redshift database must consist of only UTF-8 printable characters; and ASCII letters are converted to lower case.
      For detailed information, see Amazon Web Services - Names and Identifiers.

Don't find your tag in the marketplace? Use the Tealium Generic Tag to implement most any variety of tag.

Viewing the Tag Detail Window

The expanded view of a tag provides a condensed view of tag details, categorized as follows:

  • Summary View (Left Pane)
    Summary information displays in the left pane, including the overall score based on user feedback. From this view, you can copy a tag, delete the tag, or manage labels for the tag.
    Tags_View Tag Details_Left Pane.png

    • Apply Labels
      View, add, and manage labels for the tag.
    • Tag Vendor Information
      Displays a brief note about the tag vendor and how the tag is used.
    • Tips
      Provides useful tips and documentation to assist with tag configuration.
  • Detailed View (Right Pane)
    Detailed information displays in the right pane, as well as links to edit the information without the need to navigate back to a previous screen. From this screen, you can also expand and collapse the tag history view. Detailed information on this screen is categorized by: Tag Configuration, Load Rules, and Mapped/UID, as shown in the following example:
    Tags_View Tag Details_Right Pane.png
    • Tag Configuration
      Displays a read-only view of the tag configuration.
    • Load Rules
      Displays load rule conditions that indicate when and where the tag will load.
    • Mapped Variables
      Displays the variables that are currently mapped to the destination variables for the tag.
    • Notes
      Provides space for additional notes about the tag configuration.
    • Mapped and UID
      • The Mapped column displays the number of equal (=) variables mapped to the destinations for the tag.
      • The UID column displays the unique identifier for the tag.
        The UID determines the name of the tag configuration file served from the CDN. For example, tag with a UID  of 1878 corresponds to the file utag.1878.js.
        tags-mapped-uid.png

Editing a Tag

Use the following steps to edit a tag:

  1. From the TiQ interface, click the Tags tab.

  2. Click on a tag to expand.

  3. Click the Edit button for the section you want to edit.
    Each section: Tag Configuration, Load Rules, and Mapped Variables, have separate edit buttons that allow you to focus on editing that area.

Turning a Tag OFF or ON

Tealium recommends deactivating a tag to turn it off without removing it from the list of tags.

Use the following steps to turn off or deactivate a tag:

  1. Click the OFF/ON button to toggle the tag to the OFF position.

  2. Click Save/Publish to save the change.
    This step immediately prevents the tag from loading on any of your pages.

  3. To turn a tag back on, simply click the OFF/ON button again to toggle back to the ON position.

Copying a Tag

Copying a tag is a simple process and is the best method to use to add tags in bulk.

Use the following steps to copy a tag:

  1. From the Tags tab, click on a tag to expand the view.

  2. In the sidebar, click Copy....
    The Copy Tag dialog displays.

  3. To create multiple instances of a tag, specify the number of copies you want to make and click Copy Tag.
    Copy_Tag_Window.png

Deleting a Tag

Use the following steps to delete a tag:

  1. Click the Tabs tab.

  2. Click a tag to expand the details.

  3. Click the Delete button underneath the logo for the tag.

    After you edit, delete, or deactivate a tag, the Save/Publish button displays orange to indicate that you have unsaved changes in the profile.

  4. Click Save/Publish to save the change.

Viewing Tag History

Use the following steps to view the history of a tag:

  1. Click View Tag History in the bottom right corner of the expanded tag.
    An expanded view of the history for the tag displays and lists the user that made the change, what the change was, and when the change was made.
    Tags_View Tag Details_View Tag History.png
  2. Click Hide to collapse the detailed view.

Selecting Publish Locations and Settings

The following sections describe publish locations and details about publish location settings.

Publish Locations

There are three (3) publish locations available for every tag:

  • Dev
    The Development (Dev) environment is a non-production environment intended for sandbox configuration.
  • QA
    The Quality Assurance (QA) environment is a non-production environment intended for testing prior to  releasing to production.
  • Prod
    The Production (Prod) environment is the environment you intend to load on your live website.  

Publish Location Settings

If you select No for any publish locations, the tag will not be published to that location. For example, if you select No for Publish to Prod, the tag will not be pushed to your live site even if you select Prod as a publish target from the Save dialog. This setting helps to prevent the accidental release of tags before they are ready.

Publish settings.png

 

If your tags are inexplicably not loading on a page where you expect them and you have verified the Load Rule logic, the Publish Location settings are the first place to check.

Advanced Settings

The Advanced Settings are specific configurations for each tag instance. Changing the advanced settings of one (1)  tag will not affect other tags. It is important to have a good understanding of the utag.js order of operations before adjusting these settings.

The following image shows the Advanced Settings as displayed in the interface:

TiQ_Tag Marketplace_Search Tags_Advanced Settings.png

 The following table describes each advanced setting and how it is used:

Setting Descriptions
Send Flag

The Send Flag setting determines whether or not a tag sends out data when it loads. The default selection is Yes.  If you select No, the tag loads normally but  does not send data. 

Bundle Flag

The Bundle Flag setting determines whether or not you want to bundle the tag configuration file into utag.js. Tag using the "All Pages" load rule are automatically bundled by enabling the Bundle Tag Loading on All Pages setting in the Publish Configuration.
If your tag uses a custom load rule, you can bundle it by setting this flag to Yes

The loading order for bundled tags and those using the "All Pages" load rule is determined by the order in which they appear in the Tags tab.

Bundling only affects the iQ Tag Management configuration files ( utag.*.js).

JavaScript library files required by the vendor may still load.

Loading Google Analytics before bundling:

utag-google.png

Loading Google Analytics after bundling:

utag-google-bundled.png

Wait Flag

The Wait Flag setting determines whether a tag loads when the utag.js file loads, or the tag loads when the browser sends the DOM Ready signal. The default setting is Yes, meaning the tag does not load until the browsers sends the DOM Ready signal.
Selecting No means the tag will load without waiting for the DOM Ready signal.

If you load a tag before the DOM Ready signal goes out, you will risk the possibility of a resource or data the tag depends on being unavailable when the tag loads, which can negatively affect tag performance and capabilities.

Synchronous Load

This setting determines whether the tag loads synchronously or asynchronously.

If you intend to load a tag synchronously, you must include the Tealium synchronous utag.js file reference in the source code for the page.

The default setting is No, which means that tag will load asynchronously.

Tealium recommends loading tags asynchronously as a best practice.

Custom Script Source

This setting allows you to support a tag by using an external JavaScript file instead of a built-in tag template.

Enter the URL of the .js file in the Custom Script Source field.

Remove the  http: or  https: protocol from the URL and use a relative protocol. For example: //www.example.com/js/mylibrary.js

Supporting a tag using a custom JavaScript turns it into a blocking tag, which prevents other tags from running until this tag has finished loading. Though this tag still loads asynchronously, it does not load subsequent asynchronous scripts (e.g. utag.10.js) until the blocking tag is complete.

To load custom JavaScript for a tag without turning the tag into a blocking tag, use the Tealium Generic Tag to load it.

Tag Templates

The template of a tag is the JavaScript code that integrates the vendor code snippet with Tealium iQ. The template can be customized as needed. To edit the tag template of a tag:

  1. From the Tags tab, open the desired tag. In the Tag Configuration panel click Edit.
  2. Scroll down to Advanced Settings and expand the section. Click Edit Templates.
    tiq-tags-edit-templates.png
  3. Make your changes and click Save Version Template or Save Profile Template. (For more information see How do I update a tag template?)

Your changes will be see upon the next Publish.

 

The usage of tag templates is only recommended for advanced users with working knowledge of JavaScript.

Tag Order

The placement of a vendor tag in the Tags tab dictates the order in which a tag is loaded on a web page. Vendor tags will load in the same order as they appear on the Tags tab, with the exception of bundled vendor tags.
Load rules determine the location and the instant that the tag will load on a web page. To reorder the list of tags, simply drag and drop a tag in the order that you want it to load. The tags will load in sequential order, as illustrated in the following example:

tag_load_rule.png

Load Order for All Pages

The following tags will load on all the pages of your site, in the order listed:

  1. Google Universal Analytics
  2. IBM Coremetrics
  3. SiteCatalyst Tag

Load Order for the Confirmation Page Only

The following tags will only load on the confirmation page of your site, in the order listed:

  1. Google Universal Analytics
  2. IBM Coremetrics
  3. Facebook
  4. SiteCatalyst Tag