To configure the plugin for usage with Mapp Intelligence via Google Tag Manager, follow these steps:

  1. In the admin panel, go to Stores > Configuration.
  2. In the plugin list, select Mapp Cloud > Mapp Intelligence - Google Tag Manager.
  3. If you haven't loaded Google Tag Manager somewhere else: enable Load GTM via Mapp Cloud and enter the GTM ID in the corresponding field.
  4. In most circumstances, all other settings can be left to defaults (see below).

Setting

Description

Enable tracking via Google Tag Manager

Activates Mapp Intelligence Tracking via Google Tag Manager

Load GTM via Mapp Cloud

If Google Tag Manager is not loaded somewhere else (other plugins, theme, etc.), activate this option

GTM ID

In case you want the Mapp Cloud plugin to load the Google Tag Manager script, you need to enter the ID here. It is GTM-XXXXXX and you can find it in the code snipped, provided in your GTM container settings.

GTM data layer variable name

If you use a variable other than ‘dataLayer’ in your GTM configuration, you can enter the name here.

GTM add-to-basket trigger name

‘mapp.load’ is the default trigger name for Page views. If you want to use a different trigger for add-to-cart events, you can define the trigger name here.

Add-to-cart event name

This option is only visible if you decide to use the default ‘mapp.load’ trigger name for add-to-cart events. The Mapp Cloud plugin will automatically convert those requests to events, hence you can define the name of the event here.

 

Mapping data

The easiest way to map tracking data via Google Tag Manager is by using the Mapp Cloud template. After activating the plugin in Magento 2 / Adobe Commerce as described above, load up the Google tag Manager interface (https://tagmanager.google.com/). Go to the container that is loaded by the plugin, and follow these three steps to activate tracking:

  1. Create variables.
  2. Create a trigger.
  3. Import and configure the Mapp Cloud tag.

 

Create Variables

Click “Variables”, then “New”. Use “Data Layer Variable” as the type. Enter a name of your choice and the Data Layer Variable Name. For the name of the page, it would look like this: 

The available Data Layer Variable names are:

AttributeDescriptionSuggested Mapping

mapp.pageName

URL without parameter.

Page → Page name

mapp.pageTitle

The meta title of the page.

Page → Predefined page Parameter → title

mapp.customerId

Sha256 hash of the customer's email address

User → User ID

mapp.gender

'1' for male and '2' for female (this will only work if the technical name for Salutations is for male Mr or Herr, and Ms, Mrs, Miss or Frau for female (see Settings → Salutations in Shopware 6 Backend). Only available if the customer is logged in.

User → Predefined URM category → Gender

mapp.contentCategory

Depending on where you are the values can be: Checkout, Catalogue, Account, Home, Content.

Page → Content Groups

mapp.contentSubcategory

Depending on where you are the values can be: Product Overview, Product Detail, Internal Search, or Landing Page.

Page → Content Groups

mapp.pageNumber

The number of pages in product lists and search results.

Page →  Page Parameter

mapp.internalSearch

Search term on the search result page.

Internal Search → Search term

mapp.gtmProductArray

Object with product data

E-Commerce → Products → Product data

mapp.currency

The currency ISO code.

E-Commerce → Order → Currency

mapp.orderId

The ID of an order.

E-Commerce → Order → Order ID

mapp.totalOrderValue

The total value of an order, incl. taxes.

E-Commerce → Order → Order value

mapp.couponValue

Value of coupons during order.

E-Commerce → Order → Coupon Value

Those are just the most important ones. Depending on your shop configuration you might find a lot more data that can be tracked. Use the GTM debugger and look for Data Layer variables that start with “mapp.”.

 

Create Trigger

Go to Triggers >New. Select Custom Event as the type, give it a name, and enter “mapp.load” as the event name:


Import & configure the Mapp Cloud Tag

Go to Tags> New. When picking the type, click Discover more tag types in the Community Template Gallery and search for “Mapp Cloud”. Add it to your container. Now add your mappings, track id, and track domain to configure. Set the trigger as the custom trigger you just created. Save and publish the container – your basic tracking is now working!

Customize product tracking

When mapping mapp.gtmProductArray to products, you get the product id, status, cost, and quantity. However, you might want to track additional information, like the real product name. In order to do that, you need the Mapp Intelligence Product Array custom variable. Once more, go to Variables > New. When asked for the type, click Discover more variable types in the Community Template Gallery. Then search for Mapp Intelligence and pick Mapp Intelligence Product ArrayNext, configure the new variable.

First, map the mapp.gtmProductArray to Product arrayNow enter the name of variables as you know them from the dataLayer, but without “mapp.”. So if you want to map the real product name as product category 1, you’d do it like this:

All data from the dataLayer is available within gtmProductArray and can be mapped here, just remove “mapp”. You can keep product status unmapped, the Magento plugin will take care of the status.

 

Advanced configuration – a separate trigger for add-to-cart events

For advanced usage, there is the option to set a different trigger name for add-to-cart events. If you set something other than “mapp.load” as the trigger name for add-to-cart events in the plugin configuration, you can create another trigger for those add-to-cart events and therefore fire a different tag when those events occur. For example, you can import the Mapp Cloud tag a second time, and set it to “Event” for this trigger, allowing you to completely customize the add-to-cart events.

However, in most circumstances, the default behavior should prove sufficient.