The basis of the Mapp Intelligence implementation is the integration of the tracking script (pixel). With the pixel version 5, you can make the configuration in Mapp Tag Integration.

The use of Tag Integration requires that the visitor has enabled JavaScript. If JavaScript is disabled, no user information is captured.

Please take the following steps:

  1. Download

    First, download the JavaScript-file
    The "tiLoader.min.js" JavaScript-file is used for the implementation with Tag Integration.


  2. Validate

    Now validate the JavaScript-file.

    ParameterDescription
    tiDomainSpecify the Tag Integration domain if the JavaScript-file should be loaded from the Mapp server.
    tiId

    Enter your Tag Integration customer ID if the JavaScript-file should be loaded from the Mapp server.

    Please note that the safeTagId/ tiID is not necessarily identical to the trackId. If in doubt, contact the support.

    customDomainSpecify your domain if the JavaScript-file should be loaded from your server.
    customPath

    Enter the path to the container script file if it should be loaded from your own server.

    Optionally, you can host the JavaScript file on your web server. In this case, you have to specify the correct path <script src="/js/tiLoader.min.js"></script>

    option

    Additional Tag Integration information can be specified here.


    Example Tracking Script (excerpt)

    window._tiConfig = window._tiConfig || {
	tiDomain: 'responder.wt-safetag.com',
	tiId: '111111111111111',
	// customDomain: 'sub.domain.tld', 
	// customPath: 'js/container_script.js', 

	option: {}
};

/** start TagIntegration loader */
// ...
/** end TagIntegration loader */
    JS



  3. Integrate

    Integrate the script in all pages to be tracked. Please save this script on the web server on which the website to be measured is also hosted.

    <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>
    XML



  4. Data Layer

    Mapp recommends using a global data layer, which provides all relevant information.

    This information is requested and defined as parameters in Tag Integration.

    Please click here to get more information on data layers.

    Supported Characters and Coding Formats

    Mapp Intelligence supports the UTF-8 standard.

    • A maximum of 255 characters can be entered per parameter.
    • A request may not be larger than 7KB.
    • Input is case-sensitive.


    If you are using the NoScript segment of the pixel:

    • all parameters in the "<noscript>" segment must be set according to UTF-8 and URL code standards. For example, the German "ΓΌ" as "%C3%BC". This will ensure the proper transmission of all special characters and applies to all websites regardless of coding (UTF-8, ISO-8859-1, etc.).


    Certain characters are automatically filtered out during tracking:

    • 0x00-0x1f
    • '
    • "
    • <>\
    • 0xA0 => space
    • Several spaces become one.
    • Trailing and ending spaces are removed.