Google Tag Manager in conjunction with Wordpress / Woocommerce

You can use the Plugin in combination with our Mapp Intelligence Google Tag Manager template.

With 3 easy steps you can accomplish basic tracking and even e-commerce tracking in case you use Woocommerce:

• Install and configure the Mapp Intelligence Plugin in Wordpress
• In Google Tag Manager, create a trigger and the variables
• In Google Tag Manager, install our Mapp Intelligence template and map the variables

This guide will lead you through those steps.

A) Install Mapp Intelligence in Wordpress

1. Log in to your Wordpress backend, click on Plugins > Add new.
2. Search for 'Mapp Cloud' and click the 'Install Now' button.
   > Afterward, under 'Plugins' you will see 'Mapp Cloud' in your side menu.
3. Click the entry and you will see the configuration. You can now choose 'Google Tag Manager'.

4. At 'Google Tag Manager Container ID' you have the option to enter your Container ID. Do this if you want the Mapp Intelligence plugin to load the GTM code snippet in the head of your Wordpress website. If you already load the GTM Snippet through your theme or another plugin, you can keep this field empty.

   

   You can find the Container ID in the corresponding column of your container overview in Google Tag Manager (GTM-XXXXXXX).

   
   

   
   

5. If you do not want to have certain data in the dataLayer, you can exclude those keys under 'Exclude keys'.
   By default we exclude customFields - in there you will find data of plugins you have installed, and it might contain personal data. So be careful if you want to add customFields - you can check the data with the preview mode of GTM or you can have a look at the dataLayer variable in the Javascript console on your page.
   
   

6. You can exclude Wordpress users from tracking. If you activate this option, admins, managers, editors or anybody being logged into the admin console will not be tracked by Mapp Intelligence anymore. However, Woocommerce customers will still be tracked.

Once done, click 'Save Changes' and the configuration within Wordpress is finished.

B) Trigger and variables in Google Tag Manager

Now log in to your GTM Account and go into your container.

Trigger

First, we add a trigger by clicking Triggers > New > Choose trigger type > Custom Event and enter as the event name:

mapp.load

 You can also name the trigger, here we call it "mapp.load" too.

Variables

Now we create variables. In the tables below you can see which data you can expect to be pushed by the Mapp Intelligence plugin.

To create the variable for the pageName, you need to click Variables > New > Choose variable type > Data Layer Variable. Again you can name the variable however you want, but the value for 'Data Layer Variable Name' needs to fit the entry in the table below. For the sake of consistency, we call both of them "mapp.pageName" here:

Now click the 'Save' button and continue with all data you want to track.

General Wordpress data

Woocommerce product tracking

There are many keys containing product data. However, when using the Google Tag Manager template and its underlying Smartpixel, all you basically need is 'mapp.gtmProductArray'. Inside that variable, you'll find all product data without the need to bring it to the right structure. You will learn in step 3 how you can customize the tracking information.

Structured product data (recommended)

Raw product data (only needed in edge cases)

Under normal circumstances, you won't need those because the tracking is covered by mapp.gtmProductArray. Only use the following keys in case you have an edge case where you need a specific entry. However, for Mapp Intelligence product tracking the variables mapp.gtmProductArray and optionally mapp.shoppingCartStatus as well as mapp.pageRequestType will be all you need.

Woocommerce order tracking

C) Configure Mapp Intelligence GTM template

Now that we have all the data available, it is time for the final step: installing the Mapp Intelligence template tag and mapping the data.

1. Click Tags > New > Choose type > Community Template Gallery > Mapp Intelligence Smartpixel - Tracking Configuration > Choose Template
2. Name the tag. Here we call it "Mapp Page Tracking"
   
   
   
3. Let's add out trigger first: scroll down to the bottom of the tag configuration, and click 'Choose trigger to make this tag fire...'. Pick the trigger from above, in our example "mapp.load".
   
   
4. Now map the data. For example, if you want to map the pageName value from the Wordpress Plugin to the page name in Mapp Intelligence, just map it like this:
   
   
5. Now all you need to do is to enter basic information like your Track ID and Track Domain, save the tag, publish the container and you will have basic tracking. 

E-commerce with Woocommerce 

In this chapter we want to have a closer look at how you can add and customize product- and order tracking within Woocommerce.

Basic configuration

For basic e-commerce tracking, all you need to map is this:

Now you will track orders, product views, and products being added to the basket. The product ID, which is the central identifier for products in your tracking data, will be in this format: "[productID] - [productName]". However, within the "gtmProductArray" there are more tracking data available than it is used by this very basic configuration.

Here is an overview of what is included in the basic configuration, and what else is available:

{
	product_cat_0: "Music",
	product_cat_1: "Jazz",
	product_cat_2: "Acid"
}

Advanced product tracking

You can further customize the product tracking and use the additional information that is available in "mapp.gtmProductArray".

To do that, you first need to create a new variable. Click variables → New → Choose type → Community Template Gallery → Mapp Intelligence Product Array

Add the variable template to your container and open the configuration.

If you then map Product array to mapp.gtmProductArray and Product status to mapp.shoppingCartStatus, and map the new variable, that we call "Enhanced Product Array" here, to the product array entry in the main Mapp Intelligence Template, you are back to the basic setting but you have the option to customize it now.

In your Enhanced Product Array, you can now map the additional values to product categories (static values) and e-commerce parameters (dynamic parameters).

For example, the SKU value is a static value, meaning it is always the same for a product. So it is a perfect value to map to a product category. All you need to do is to add it to the corresponding table. So if you'd want to add the sku as product category 3, you would do it like this: enter the is number in the left column, and the property name (see table above) in the right column:

A typical example for dynamic values are attributed in variable products. Let' map e-commerce parameter 20 to the pa_color_0 taxonomy:

If you now save and publish your settings, the additional data will be tracked if it is available in a product.