Basic Implementation

This is the fastest and easiest way to integrate Mapp Intelligence. The tracking script will be loaded from the Mapp CDN. Thus, you don't have to care about updates.

Please note, that you can't use any Mapp Intelligence Plugins (e.g., Teaser Tracking, Scroll Depth Plugin) via this method.

A) Add the Mapp Intelligence Configuration as GTM Template

With this tag, we can configure the tracking. This includes:

• In which Mapp account(s) should the data be tracked?
• How should the pages be named?
• Is automatic link tracking needed?
• ...

1. In your container, click Tags > New > Tag Configuration and choose Discover more tag types in the Community Template Gallery
   
   
   
2. Search for the Mapp Cloud Tracking tag and add it to your Workspace.
   
   
   
3. Activate Load Smart Pixel via external source in the template settings. This will load the tracking Pixel from the Mapp CDN.
   
4. Name it 'Mapp Intelligence Tracking Configuration' and save it without a trigger or with a trigger of your choice (when tracking data is available).

B) Configure and map data in the Mapp Intelligence GTM Template

Now we do the basic configuration.

• Select, in which Mapp account(s) the data should be tracked.
• Activate automatic tracking of HTML links.
• Activate page naming.

1. Select the 'Mapp Intelligence Tracking Configuration' tag and enable edit mode.
2. Select Request Type Page. Learn more about request types on this page.

3. Add Account information

   Setting	Description
   Track ID	Track IDs are used to assign requests to an account. You find the track ID under Mapp Q3 > Configuration > System Configuration > Data Collection. If the same information is to be recorded for multiple accounts, you can enter the corresponding track IDs of the accounts comma-separated.
   Track Domain	Specify your Mapp Intelligence track domain. This information is provided by your account manager.
   Exclude referrer domains	Add domains that should be excluded from the referrer and campaign analyses in Mapp Intelligence. Here you should add your own domain. Often, also payment providers are used here.

   Once this is done, tracking starts. You will find basic information, like global traffic and the usage of single pages.

   

   Please note, that data is updated hourly in standard analyses. We recommend using the Mapp Cloud Debugger to check if tracking works.

4. Activate automatic tracking of HTML links
   Mapp Intelligence offers automatic tracking of all HTML links. The easiest option is the type "Link".
   
   
   

5. Add Page categorization
   The different pages are automatically tracked with their URL as the page name.
   We strongly recommend using content groups to categorize your pages. This allows for a high-level view, greater flexibility in the analysis, and easier usage of the user interface.
   Learn more about content groups in this How-To.
   
   You can configure content groups in the Page section.
   Add the ID of the Content group (from Mapp Q3) and add the value, based on your GTM configuration.

   
6. Testing
   Use the Mapp Cloud Debugger to check the track requests. Find more information in the documentation.

Mapp Intelligence offers a lot of predefined parameters to track different use cases. Learn more about it on this page.

This approach supports the usage of Mapp Intelligence Plugins. The tracking script will be added via a Custom HTML tag. This allows to include additional plugins.

A) Add the Mapp Intelligence Smartpixel as Custom HTML

1. In your container, click Tags > New.
   
2. Select Tag Configuration and choose tag type Custom HTML.
   
3. Go to this page and copy the code from there.
   
4. After pasting it in your tag, it will look similar to this:
   
   
   
5. Next, we pick a trigger. We use the default trigger 'All Pages'.
   
   
   
6. Don't forget to name your new tag. In our example, we call it 'Mapp Intelligence':
   
7. Now click Save.

B) Add the Mapp Intelligence Configuration as GTM Template

With this additional tag, we can configure the tracking. This includes:

• In which Mapp account(s) should the data be tracked?
• How should the pages be named?
• Is automatic link tracking needed?
• ...

1. In your container, click Tags > New > Tag Configuration and next Discover more tag types in the Community Template Gallery
   
   
   
2. Search for the Mapp Cloud Tracking tag and add it to your Workspace.
   
   
   
3. Name it 'Mapp Intelligence Tracking Configuration' and save it without a trigger in case you load Smartpixel via Custom HTML, or with a trigger of your choice (when tracking data is available).
   You have now 2 tags available:
   
   
   

C) Activate Tag Sequencing

Next, we have to make sure that the Custom HTML tag loads before the Tracking configuration tag. This can be done by using Tag Sequencing.

1. Go back to the Custom HTML tag 'Mapp Intelligence'.
2. Click edit and go to the advanced settings.
3. Under Tag Sequencing activate Fire a tag after Smartpixel code fires and select the 'Mapp Intelligence Tracking Configuration' tag.
   

D) Configure and map data in the Mapp Intelligence GTM Template

Now we do the basic configuration.

• Select, in which Mapp account(s) the data should be tracked.
• Activate automatic tracking of HTML links.
• Activate page naming.

1. Select the 'Mapp Intelligence Tracking Configuration' tag and enable edit mode.
2. Select Request Type Page. Learn more about request types on this page.

3. Add Account information
   Select Request Type Page and add the following information:

   Setting	Description
   Track ID	Track IDs are used to assign requests to an account. You find the track ID under Mapp Q3 > Configuration > System Configuration > Data Collection. If the same information is to be recorded for multiple accounts, you can enter the corresponding track IDs of the accounts comma-separated.
   Track Domain	Specify your Mapp Intelligence track domain. This information is provided by your account manager.
   Exclude referrer domains	Add domains that should be excluded from the referrer and campaign analyses in Mapp Intelligence. Here you should add your own domain. Often, also payment providers are used here.

   Once this is done, tracking starts. You will find basic information, like global traffic and the usage of single pages.

   

   Please note, that data is updated hourly in standard analyses. We recommend using the Mapp Cloud Debugger to check if tracking works.

4. Activate automatic tracking of HTML links
   Mapp Intelligence offers automatic tracking of all HTML links. The easiest option is the type "Link".
   
   
   

5. Add Page categorization
   The different pages are automatically tracked with their URL as the page name.
   We strongly recommend using content groups to categorize your pages. This allows for a high-level view, greater flexibility in the analysis, and easier usage of the user interface.
   Learn more about content groups in this How-To.
   
   You can configure content groups in the Page section.
   Add the ID of the Content group (from Mapp Q3) and add the value, based on your GTM configuration.

   
   
   
6. Testing
   Use the Mapp Cloud Debugger to check the track requests. Find more information in the documentation.

Mapp Intelligence offers a lot of predefined parameters to track different use cases. Learn more about it on this page.