Webtrekk Tag Setup Guide
This article describes how to set up the Webtrekk tag in your Tealium iQ Tag Management account.
Requirements
- Webtrekk account
Supported versions
- v5.5.1 (recommended)
- v4.4.7
- v4.4.4
Tag configuration
Navigate to the Tag Marketplace to add a new tag. Read the Tag Overview article for general instructions on how to add a tag.
When 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
- Enter the tracking URL (excluding the https/http protocol), as specified in your Webtrekk pixel, such as
- 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 valueexample.htm
is passed.
- Sends the value of
- 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 valueexample_name
is passed.
- Sends the value of the
- None
- Disables link/event tracking for the tag instance.
- Link (default)
- Select one of the following preferred settings for tracking visitor actions/events, clicks, downloads, etc.
- 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 userel
instead ofname
.
- 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.
- First party
- Choose the type of cookie you prefer to use for tracking visitors on your site.
- 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 tosid
.
- 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.
- Pre-populated by
- 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 the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation.
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 |
|
Cookie OptOut Name |
|
Cookie OptOut Time Frame |
|
Parameters to Include First |
|
Ignore Pre-rendering |
|
Form Path Analysis |
|
tabBrowsing |
|
globalVisitorIds | |
execRTA |
|
execCDB |
|
useCDBCache |
|
useCDBScript | |
requestLimitAmount |
|
requestLimitTime |
|
Track ID |
|
Track Domain |
|
Site Domain |
|
Link Tracking |
|
Link Track Attribute |
|
Link Track Params |
|
Link Track Pattern |
|
Link Track Replace |
|
Link Track Ignore Pattern |
|
No Delay Link Track Attribute |
|
Link Track Downloads |
|
Pixel Sampling |
|
Force HTTPS |
|
Cookie Handling |
|
Cookie Domain |
|
contentId |
|
Heat map |
|
Form |
|
executePluginFuntion |
|
Media Code |
|
Media Code cookie |
|
SafeTag Async |
|
SafeTag Timeout |
|
SafeTag Domain |
|
SafeTag Customer ID |
|
SafeTag Custom Domain |
|
SafeTag CustomPath |
|
SafeTag Option [Object] |
|
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 |
|
URM categories |
|
Email RID |
|
Email Opt-In |
|
Gender |
|
Birthday |
|
Birthday Year |
|
Birthday Month |
|
Birthday Day |
|
CRM Category 1 to 10 |
|
Custom Session Parameter 1 to 10 |
|
Page Data Category
Tag Destination | Description |
---|---|
Page Content ID |
|
Content Group 1 to 25 |
|
Custom Parameter 1 to 50 |
|
Search and Form Tracking
Map to these destinations for sending internal search and form input parameters.
Tag Destination | Description |
---|---|
Internal Search |
|
Form Tracking |
|
Form Attribute |
|
Form Value Attribute |
|
Form Field Attribute | — |
Full Content Form Tracking | Sends the first 30 characters of a free-text field. |
Anonymous Form Tracking |
|
Form HTML Id |
|
Click Tracking
Tag Destination | Description |
---|---|
Heatmap |
|
Heatmap reference point id |
|
Link Track |
|
Link Track Attribute |
|
Link Tracks Params |
|
Link Track Pattern |
|
Link Track Replace |
|
Link Track Downloads |
|
Link ID for custom utag.link tracking |
|
Custom Click parameter 1 to 10 |
|
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 |
|
Media Code Cookie |
|
Campaign ID |
|
Campaign Action |
|
Custom Campaign Parameters 1 to 10 |
|
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 |
|
_corder |
Order Total |
|
_ctotal |
Currency |
|
_ccurrency |
Coupon Value |
|
N//A |
List of product names |
|
_cprodname |
List of product quantities |
|
_cquan |
List of product prices |
|
_cprice |
List of product categories (productCategories[1]) |
|
_ccat |
List of product brands (productCategory[2]) |
|
_cbrand |
List of product subcategories (productCategory[3]) |
|
_ccat2 |
Product Status |
|
N/A |
Product Category 1 to 25 |
|
N/A |
Custom E-Commerce Parameter 1 to 50 |
|
N/A |
This page was last updated: December 3, 2019