Tag Specifications and Requirements

Specifications

  • Name: Chartbeat
  • Vendor: Chartbeat
  • Type: Real-time Web Analytics

Required

Services: Chartbeat Account

Configurations:

  • Chartbeat User ID

Tag Configuration in Tealium iQ

Adding the Tag

Tealium iQ's Tag marketplace offers a wide variety of Tags. Click here to learn how to add a Tag to your profile.

Configuring the Tag

tag_config.png

  1. Title (Required): Enter a descriptive title to identify the Tag instance.
  2. User ID (Required): Enter the numeric user ID provided to you by Chartbeat. This can be found in your Chartbeat account. Example: 1234
  3. Domain (Required): Enter the domain name where you want to implement Chartbeat. Do not include the prefix 'www'. Example: yoursite.com
  4. Use Canonical (Optional): Choose whether or not you want Chartbeat to use the Canonical path (the preferred URL) to access a page. By default, the Use Canonical drop-down is set to false, in which case Chartbeat will use the page's actual URL.
    • Select 'true' if you want Chartbeat to use the canonical path you have defined using a link element in your site's HTML.
    Example: Assume a page can be accessed by two different URLs—http://yoursite.com/products?category=apparel&kids and http://yoursite.com/apparel/kids. But only URL #2 is set as canonical. By enabling the Use Canonical field, Chartbeat can use your preferred URL#2 for tracking purpose. Note: You have the option to override this selection by mapping to the 'path' variable.

NOTE: You may use the Data Mapping toolbox to override or dynamically set the Tag settings for #2 through #4.

 

Applying Load Rules

Load Rules determine when and where to load an instance of this Tag. The 'Load on All Pages' rule is the default Load Rule. To load this Tag on a specific page, create a new load rule with the relevant conditions.

Note: Leave the default 'Load on All pages' rule as is. Chartbeat, like most analytics Tags, is recommended to load on all pages of the site to ensure accurate data collection.

Setting up Mappings

Mapping is the simple process of sending data from a data source, in your Data Layer, to the matching destination variable of the vendor Tag. The destination variables for this Tag are available in the Mapping toolkit. (how to map a Data Source to a Tag destination?)

 

mapping toolbox.png

 

  • User ID: Map to this destination to send the numeric user ID, one that Chartbeat has provided you.
  • Domain: Map to this destination to send the domain name where Chartbeat is implemented.
  • Use Canonical (canonical): Map to this destination to indicate whether or not the page's url is Canonical. Make sure the value in the data source is either "true" or "false".
  • title: Map to this destination to send the page's current title.
  • path: Map to this variable to send the page's path.
  • sections: Map to this variable to send section information that contains the content you want Chartbeat to track. Multiple sections must be sent as a comma-separated list of values.
  • authors: Map to this variable to send information about the content's author. Multiple authors must be sent as a comma-separated list of values.

Vendor Documentation