---
title: "Tag Integration Script"
slug: "integration-tracking-pixel"
updated: 2026-04-14T15:59:28Z
published: 2026-04-14T15:59:28Z
canonical: "docs.mapp.com/integration-tracking-pixel"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag Integration Script

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.

> [!NOTE]
> 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](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/Mapp_TagIntegration.zip)

---

## 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 |
| --- | --- |
| `tiDomain` | The Tag Integration domain used to load the container from the Mapp server. Required when hosting on Mapp infrastructure. |
| `tiId` | Your Tag Integration ID. Required when loading the container from the Mapp server. **Note:** The `tiId` is not necessarily identical to the Track ID. If in doubt, contact Mapp Support. |
| `customDomain` | Your own domain, if you are hosting the Tag Integration container script on your own server instead of the Mapp server. |
| `customPath` | The path to the container script file on your own server. Use this together with `customDomain` when self-hosting. |
| `option` | An object for additional Tag Integration configuration options. |

**Example configuration (Mapp-hosted):**

```javascript
window._tiConfig = window._tiConfig || {
    tiDomain: 'responder.wt-safetag.com',
    tiId: '111111111111111',
    option: {}
};

/** start TagIntegration loader */
// ...
/** end TagIntegration loader */
```

**Example configuration (self-hosted):**

```javascript
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.

```xml
<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](/v1/docs/data-layer).

---

## 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 |
| --- | --- |
| `0x00–0x1F` | Removed |
| `' " &lt; &gt; \` | Removed |
| `0xA0` (non-breaking space) | Converted to regular space |
| Multiple consecutive spaces | Collapsed to a single space |
| Leading and trailing spaces | Removed |