Webtrekk Tag Setup Guide

[#1]

This article describes how to set up the Webtrekk tag in your Tealium iQ Tag Management (TiQ) profile.

In this article:

Table of Contents Placeholder

Prerequisites

• Webtrekk account

Supported Versions

• v5.5.1 (recommended)
• v4.4.7
• v4.4.4

Tag Configuration

First, go to Tealium tag marketplace and add the Webtrekk tag to your profile (how to add a Tag?).

After adding the tag, configure the following settings:

• Title
  • The default is "Webtrekk".
  • You may replace it with a descriptive name of choice.
• Library Version
  • Choose the version of your Webtrekk pixel (i.e. tracking script) from this list.
• Track ID
  • Enter the numeric track ID you received from Webtrekk.
  • Track ID can be located in the Webtrekk tool, under System Configuration > Data Collection.
• Track Domain
  • Enter the tracking URL (excluding the https/http protocol), as specified in your Webtrekk pixel, such as track.XXXX.net
• TagIntegration Customer ID
  • Enter your SafeTag identifier.
  • This is defined in the safetag object and required if you are loading the TagIntegration file from a Webtrekk server.
• TagIntegration Domain
  • Enter the SafeTag domain.
  • Required if you are loading the TagIntegration file from a Webtrekk server.
• Param First
  • Enter the the list of parameters in the order you want them passed in the request.
  • Separate the parameters with semi-colon (;).
• Site Domain
  • Optional.
  • Enter the domain of the site being tracked.
• Link Tracking
  • Select one of the following preferred settings for tracking visitor actions/events, clicks, downloads, etc.
    
    • Link (default)
      • Sends the value of href attribute, such as the destination page URL in the clicked link, as the action/event name.
      • For example, if the clicked link is <a href="example.htm">Click here</a>, the value example.htm is passed.
    • Standard
      • Sends the value of the name attribute as the action/event name.
      • For example, if the clicked link is <a href="example.htm" name="example_name">Click here</a>, the value example_name is passed.
    • None
      • Disables link/event tracking for the tag instance.
• Link Track Attribute
  • Optional configuration for Standard tracking option.
  • Enter the HTML attribute that you want to use instead of the default name attribute for assigning the action/event name.
  • For example, in this link <a href="example.htm" name="internal_id" rel="example">Click here</a>, you may use rel instead of name.
• Link Track Params
  • Optional.
  • Configuration for Link tracking option.
  • Enter the name of the querystring parameter with which to track the clicked link.
  • Use commas to separate multiple parameters.
  • For example: <a href="example.htm?page=10">Go to page 10</a>
• Link Track Downloads
  • Enter the list of file types you wish to track for downloads.
  • Use semi-colons to separate multiple entries.
  • For example: zip;raw;doc
• Pixel Sampling:
  • Allows you to control the percentage of traffic that is reported to Webtrekk.
  • Enter a numeric value.
• Force HTTPS:
  • Choose whether or not to force send a request as secure.
  • Default setting is OFF.
• Cookie Handling
  • Choose the type of cookie you prefer to use for tracking visitors on your site.
    
    • First party
      • Default
      • Recommended)
      • Cookie value set by your site domain
    • Third party
      • Cookie value set by Webtrekk.
• Cookie Domain
  • Applies to first party cookies only.
  • If your top level domain is double-barrelled (suffixed by an additional identifier such as .co, .uk, etc.), you must specify it here in order for the cookies to be set correctly.
• mediaCode
  • Enter the media code parameter with which to identify and track your campaign.
• mediaCodeCookie
  • Enter the media code cookie parameter with which to track a campaign only once per session.
  • If the mediaCode query parameter is in the address bar, set the value to sid.
• WT Object Name
  • Pre-populated by wt which is the default object for a single tag instance.
  • If you are loading multiple tag instances on the same page, replace with a unique object name in each of those tags.
• Heat Map tracking
  • Choose whether or not you want to activate Heatmap tracking for this tag instance.
  • Default setting is OFF.
• Form tracking
  • Choose whether or not you want to activate Form tracking for this tag instance.
  • Default setting is OFF.

Load Rules

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

Recommended Rule: All Pages (default)

Data Mappings

Mapping is the process of sending data from a Data Layer Variable to the corresponding destination variable of the vendor tag. For instructions on how to map a Variable to a tag destination, see Data Mappings.

Standard Category

Map to these destinations to either override or dynamically populate the tag settings.

These mappings apply to your global  Webtrekk.js configuration.

Tag Destination	Description
WT object name	Object name for uniquely identifying the tag instance. Default value is wt.
Cookie OptOut Name	Name of the webtrekkOptOut cookie
Cookie OptOut Time Frame	Lifespan of the webtrekkoptout cookie
Parameters to Include First	List of parameters separated by semi-colon. Parameters are sent in the order listed in the variable.
Ignore Pre-rendering	Flag (Boolean value) to determine whether or not to track pre-rendered pages
Form Path Analysis	Flag (Boolean value) to enable or disable form field tracking
tabBrowsing	Flag (Boolean value) for tracking browser tab views. Default value is false
globalVisitorIds
execRTA	Flag (Boolean value) for enabling or disabling Webtrekk’s Real Time Bidding (RTB) service
execCDB	Flag (Boolean value) for enabling or disabling Webtrekk’s Cross Device Bridge (CDB) technology
useCDBCache	Flag (Boolean value) for enabling or disabling the use of image cache cookie
useCDBScript
requestLimitAmount	The maximum number of requests that can be sent
requestLimitTime	The permissible time limit for sending the maximum number of requests
Track ID	Numeric identifier of the tracking pixel you received from Webtrekk. Track ID can also be found in the Webtrekk tool, under System Configuration >  Data Collection.
Track Domain	Tracking URL, excluding https/http protocol), as specified in your Webtrekk pixel.
Site Domain	Domain of the site being tracked.
Link Tracking	Event tracking settings for tracking visitor actions, clicks, and downloads. Webtrekk supports two options: Link and Standard.
Link Track Attribute	Applies to "Standard" tracking option. This attribute is used for determining the name of the event/action. Mapping to this destination overrides the default "name".
Link Track Params	Applies to "Link" tracking option in the global configuration. Mapping to this destination sends the query string parameter with which to track the clicked link.
Link Track Pattern	Regular Expression for filtering undesirable parameter(s) out of the Link Track Parameter query string.
Link Track Replace	Replacement character with which to replace the filtered parameters in the Link Track Parameter.
Link Track Ignore Pattern	Regular Expression to exclude individual links from being tracked
No Delay Link Track Attribute	Disables delaying of links that are explicitly tagged with this parameter
Link Track Downloads	List of file types that you want to track for downloads in the global configuration. For example: zip;raw;doc
Pixel Sampling	Percentage of traffic reported to Webtrekk.
Force HTTPS	Force send a request as secure. Data source must contain the value 1 for activation and 0 for deactivation.
Cookie Handling	Either first or third party cookie for tracking visitors on your site. First party is default and recommended.
Cookie Domain	Applies to firstparty cookies only. Map to this destination if your top level domain is double barrelled, i.e. it is suffixed by an additional identifier such as .co, .uk, etc.
contentId	Identifies a page by its unique name rather than its URL.
Heat map	Activate/deactivate Heatmap in the global configuration. Data source value must equal 1 for activation and 0 for deactivation.
Form	Activate/deactivate Form tracking in the global configuration. Data source value must equal 1 for activation and 0 for deactivation.
executePluginFuntion	List of Plugin functions
Media Code	Parameter for tracking campaigns.
Media Code cookie	Parameter for tracking a campaign ONLY once per session.
SafeTag Async	Flag (Boolean value) to determine whether or not to load the tag asynchronously
SafeTag Timeout	The maximum amount of time to wait for the TagIntegration file to load.
SafeTag Domain	TagIntegration domain
SafeTag Customer ID	TagIntegration customer identifier
SafeTag Custom Domain	Custom domain from where the TagIntegration file should load
SafeTag CustomPath	Path of the JavaScript file, for custom domain
SafeTag Option [Object]	Additional TagIntegration information
SafeTag Option
Custom wt config item

General Category

Map to these destinations for reporting custom/optional parameters such as Visitor IDs, Session, and Categories.

Tag Destination	Description
Custom Visitor ID	Map to this destination for sending unique visitor identifier.
URM categories	URM Categories in your Webtrekk tool
Email RID	Email recipient ID
Email Opt-In	Email Opt In status. Possible values: 1 (yes) 2 (no) 3 (unknown)
Gender	Gender Possible values: 1 (male) 2 (female) 3 (unknown)
Birthday	Date of birth (YYYYMMDD)
Birthday Year	Year of birth (YYYY)
Birthday Month	Month of birth (MM)
Birthday Day	Date of birthday (DD)
CRM Category 1 to 10	Custom categories for sending CRM information such as membership type, age, and gender. Before mapping, make sure the category is defined in your Webtrekk tool.
Custom Session Parameter 1 to 10	Custom parameters for sending additional visit/session information such as login status, registration status, and test group for A/B testing. Before mapping, make sure the session parameter is defined in your Webtrekk tool.

Page Data Category

Tag Destination	Description
Page Content ID	Identifies a page by its unique name rather than its URL and is set in the page-specific configuration.
Content Group 1 to 25	Map to these destinations to send up to 50 custom parameters for a page. Make sure the Content Group you are mapping to is also defined in your Webtrekk tool.
Custom Parameter 1 to 50	Map to these destinations to send up to 50 custom parameters for a page.

Search and Form Tracking

Map to these destinations for sending internal search and form input parameters.

Tag Destination	Description
Internal Search	Search keywords/terms used by visitors to look up your site
Form Tracking	Activate/deactivate Form tracking in the page-specific configuration Data source must contain the value 1 for activation and 0 for deactivation.
Form Attribute	This attribute is used for determining the name of the form. Mapping to this destination overrides the default "name" attribute.
Form Value Attribute	This attribute is used for determining the name of the form when the form field is a 'radio' or a 'checkbox'. Mapping to this destination overrides the default  value attribute.
Form Field Attribute	---
Full Content Form Tracking	Sends the first 30 characters of a free-text field.
Anonymous Form Tracking	Contents of the form will not be sent to Webtrekk. Mapping to this destination makes the form data anonymous.
Form HTML Id	Method from tracking forms reloaded by Ajax. Mapping to this destination invokes the method

Click Tracking

Tag Destination	Description
Heatmap	Activate/deactivate Heatmap in the page-specific configuration. Data source value must equal 1 for activation and 0 for deactivation.
Heatmap reference point id	ID of the element being used as a point of reference for Heatmaps.
Link Track	Event tracking settings in the page-specific configuration. Webtrekk supports 'Link' and 'Standard' settings.
Link Track Attribute	Applies to "Standard" tracking option in the page-specific configuration. This attribute is used for determining the name of the event/action. Mapping to this destination overrides the default "name".
Link Tracks Params	Applies to "Link" tracking option in the page-specific configuration. Mapping to this destination sends the query string parameter of the tracked link.
Link Track Pattern	Regular Expression for filtering undesirable parameter(s) out of the Link Track Parameter query string. Applies to page-specific configuration.
Link Track Replace	Replacement character for replacing the filtered parameters in the Link Track Parameter. Applies to page-specific configuration.
Link Track Downloads	List of file types that you want to track for downloads. Applies to page-specific configuration. Example: zip;raw;doc
Link ID for custom utag.link tracking	Name of the tracked link.
Custom Click parameter 1 to 10	Custom parameters for click tracking. The Link ID value must be mapped in order for your custom click parameter(s) to be sent. Before mapping, make sure the parameter is also defined in your Webtrekk tool.

Campaign Tracking

Map to these destinations for sending optional and custom campaign parameters

These mappings apply to page-specific configurations.

Tag Destination	Description
Media Code	Parameter for tracking campaigns.
Media Code Cookie	Parameter for tracking a campaign ONLY once per session.
Campaign ID	Media code parameter followed by %3D and the parameter value
Campaign Action	Determines whether the visitor's response to a campaign was 'view' or 'click'.
Custom Campaign Parameters 1 to 10	Custom parameters for campaign tracking. Before mapping, make sure the parameter is defined in your Webtrekk tool.

E-Commerce Category

Since the Webtrekk tag is e-commerce enabled, it will automatically use the default E-Commerce Extension mappings. Manually mapping in this category is generally not needed unless:

• you want to override any Extension mappings
• your desired e-commerce variable is not offered in the Extension

Tag Destination	Description	E-Commerce Extension Mappings
Order ID	Unique identifier of the final order	_corder
Order Total	Total amount after shipping and tax.	_ctotal
Currency	Currency used by the customer to make the payment	_ccurrency
Coupon Value	The value of the coupon used in the order	N//A
List of product names	Name of each product in the product array	_cprodname
List of product quantities	Quantity of each product in the product array	_cquan
List of product prices	Unit price of each product in the product array	_cprice
List of product categories (productCategories[1])	Category of each product in the product array	_ccat
List of product brands (productCategory[2])	Brand of each product in the product array	_cbrand
List of product subcategories (productCategory[3])	Sub-category of each product in the product array	_ccat2
Product Status	Indicates if the product was viewed, added to cart, or checked out from the cart.	N/A
Product Category 1 to 25	Custom category with which a product can be associated only once. You may map up to 25 unique categories. Before mapping, make sure the product category is defined in your Webtrekk tool.	N/A
Custom E-Commerce Parameter 1 to 50	Custom parameters for sending additional product- and order-level data. You may map up to 50 unique parameters. Before mapping, make sure the parameter(s) is defined in your Webtrekk tool.	N/A