The Tag Integration script is the foundation of every Mapp Intelligence implementation. It loads the Tag Integration container on your website, which in turn executes all configured plugins, parameters, and rules.
Tag Integration requires JavaScript to be enabled in the visitor's browser. If JavaScript is disabled, no tracking data is captured.
Step 1: Download the Script
Download the Tag Integration loader script. This file is required for all Tag Integration implementations.
Download Tag Integration Script
Step 2: Configure the Script
Open the downloaded file and configure the _tiConfig object with your Tag Integration credentials. The following parameters are available:
Parameter | Description |
|---|---|
| The Tag Integration domain used to load the container from the Mapp server. Required when hosting on Mapp infrastructure. |
| Your Tag Integration ID. Required when loading the container from the Mapp server. |
| Your own domain, if you are hosting the Tag Integration container script on your own server instead of the Mapp server. |
| The path to the container script file on your own server. Use this together with |
| An object for additional Tag Integration configuration options. |
Example configuration (Mapp-hosted):
window._tiConfig = window._tiConfig || {
tiDomain: 'responder.wt-safetag.com',
tiId: '111111111111111',
option: {}
};
/** start TagIntegration loader */
// ...
/** end TagIntegration loader */
Example configuration (self-hosted):
window._tiConfig = window._tiConfig || {
customDomain: 'sub.domain.tld',
customPath: 'js/container_script.js',
option: {}
};
/** start TagIntegration loader */
// ...
/** end TagIntegration loader */
Step 3: Embed the Script
Add the script to all pages you want to track. Place it in the <head> section so it loads before the page content. Save the file on the same web server that hosts your website.
<html>
<head>
<title>Home page</title>
<script type="text/javascript" src="js/tiLoader.min.js"></script>
</head>
<body>
Here is the content of your website.
</body>
</html>Step 4: Set Up a Data Layer
Mapp recommends implementing a global data layer on your website. The data layer provides a structured JavaScript object that holds all relevant tracking values – such as page names, product data, or user information – in a consistent format.
Tag Integration reads from this data layer using parameters, making it easier to maintain and extend your tracking setup without modifying the Tag Integration configuration every time your site changes.
For more information, see Data Layer Essentials.
Technical Reference: Data Formats and Limits
The following constraints apply to all data sent via Tag Integration.
Encoding
Mapp Intelligence supports UTF-8 encoding.
Input is case-sensitive.
A single tracking request must not exceed 7 KB.
Parameter data types
Parameters can be configured as either text or numeric (figure) values.
Text – Maximum 255 characters per value. If a parameter captures multiple values simultaneously, each individual value can be up to 255 characters.
Figure – Supports decimal(12,2): up to ten digits with two decimal places (range: −9,999,999,999.99 to 9,999,999,999.99).
Filtered characters
The following characters are automatically removed or normalized during tracking:
Character / range | Behavior |
|---|---|
| Removed |
| Removed |
| Converted to regular space |
Multiple consecutive spaces | Collapsed to a single space |
Leading and trailing spaces | Removed |