Advanced Tracking Configuration

New
  • 2 minute(s) read
Prev Next

This page explains all available settings in the Mapp Intelligence GTM Template and how they map to the underlying Smart Pixel functionality.

For specific use cases and advanced tracking configurations (such as form tracking or e-commerce tracking), refer to the dedicated subpages in this section.

Request Types: Page vs. Event

When configuring a tag in GTM, you must choose a Request Type. This setting defines how data is sent to Mapp Intelligence and what kind of interaction is being track

Request Type

Use Case

Trigger Result

Page

Full page loads and page-related information

Generates a page impression

Event

User interactions without reload (e.g. clicks, scrolls, video views, forms)

Generates an event, media view, or form view

You should always include at least one tag with Request Type: Page to ensure complete page tracking.

To learn more about request types and their parameters, see the dedicated guide: Request Type: Page and Event.

Available Settings

The following table shows which settings are available for each request type and links to the corresponding Smart Pixel reference, where technical details and options are explained.

Settings

Page request

Event request

Smartpixel reference

Account settings


  • Track ID

  • Track Domain

  • Manual exclusion of referrers

  • Set Cookie

  • Load SmartPixel from Mapp CDN

-

Tracking Initialization

Advanced Configuration

Configure advanced settings:

  • secureCookie

  • productMerge

  • registerObfuscation

  • parameterObfuscation

  • requestObfuscation

  • tabBrowsing

  • preRendering

  • forceOldEverId

  • sendViaSDK

  • sendViaServer

    • activated

    • serverDomain

    • serverPath

    • droppedRequests

    • blacklist

  • useHashForDefaultPageName

  • useParamsForDefaultPageName

  • requestLimit.activated

  • requestLimit.amount

  • requestLimit.duration

  • requestQueue

    • activated

    • ttl

    • resendInterval

    • size

    • retries

    • retriesOption

-

Advanced Settings

GDPR Configuration

  • optOutName

  • userIdentification

    • enableAnonymousFunction

    • anonymousCookieName

    • anonymousOptIn

    • suppressParameter

    • temporarySessionId

    • saveTemporarySessionId

  • advancedPermission

    • activate

    • permissionCategory

Advanced Settings

Automatic tracking of HTML links

Tracks HTML links automatically.

Re-scan the page for new links (e.g. after lazyload).

Event tracking

Page

Track page name, parameters, and content groups.

The default name is based on the URL but can be overwritten manually.

Use page parameters to add additional metadata.

For categorization, define content groups.

-

Pages

Event

-

Allows for manual event tracking

Events

E-Commerce → Products

Tracks product-related data using an array of objects.

Each object can include:

  • id

  • status (e.g. view, basket, confirmation, list)

  • cost

  • quantity

  • soldOut

  • e-commerce parameters

  • product categories

You can use the Mapp Intelligence Product variable to generate this array from your existing dataLayer structure.

-

Products


E-Commerce → Order

Track order:

  • order ID

  • order Value

  • currency

  • coupon Value

  • predefined order parameter:

    • paymentMethod

    • shippingService

    • shippingSpeed

    • shippingCost

    • grossMargin

    • orderStatus

  • order parameter (ecommerce parameter)

-

Orders

Website goals

Use an E-Commerce parameter to track each goal.

Learn more on the Website Goals page.

Pages

Campaign

  • manually track a media code (campaignId) instead of using one from the url

  • set 'Track once per session'

  • campaign parameter

-

Campaigns

Session

Track session parameter (incl. loginStatus).

Sessions

User

Track user data:

  • customerId

  • overwrite customer validation

  • User parameter

  • User categories

Users

Internal Search

Track search term and quantity of search Results

-

Pages

Form

Activate and configure form tracking

Search for form elements or elements matching the defined selector again

Form Tracking

Send track request

Defines how and when a tracking request is sent. Useful for controlling when data is submitted to Mapp Intelligence.

Options:

  • Send track request (default):

    Automatically decides whether to send a page or event request based on the mapped data.

  • Force page request:

    Forces a page request. Ignores any event-specific data (e.g. event name).

  • Force event request:

    Forces an event request. Ignores page-specific data (e.g. page parameters).

  • No track request:

    Skips the request entirely. Use this if you:

    • Only want to prepare data,

    • Reload form or link elements, or

    • Wait for more data from another trigger.

If the page is not reloaded between requests, you can enable “Keep data” to reuse information for the next request.

Send Tracking Data

What does “SmartPixel reference” mean?

The GTM Template is built on top of the Smart Pixel, Mapp’s official tracking script. All settings you configure in GTM ultimately control Smart Pixel behavior.

The SmartPixel reference column links to the relevant documentation page where each option is explained in detail, including:

  • Available values and defaults

  • Required conditions

  • Technical limitations

  • Advanced options and examples

This is especially helpful if:

  • You’re migrating from direct Smart Pixel tracking to GTM

  • You want to mix GTM and direct implementations

  • You need to understand what happens behind the scenes

  • You want to troubleshoot or fine-tune specific behaviors