MSAAQ Documentation

Google Tag Manager (GTM)

This document provides step-by-step instructions for setting up Google Tag Manager (GTM) to track various events in your platform. Follow these instructions to integrate and configure GTM for monitoring user interactions such as login, signup, checkout, and purchase events.

Prerequisites

Access to your Google Tag Manager account.

Admin privileges to edit and publish container configurations.

The GTM container snippet installed on your website.

Step-by-Step Guide

1. Create User-Defined Variables

You need to create user-defined variables to capture the data sent with each event.

1.

Go to Variables and click on New.

2.

Name the variable DLV - Login Method.

3.

Click on Variable Configuration and choose Data Layer Variable.

4.

Set the Data Layer Variable Name to eventModel.method.

5.

Save the variable.

6.

Repeat steps 1-5 to create another variable named DLV - Login Email, with the Data Layer Variable Name set to eventModel.email.

1.

Go to Variables and click on New.

2.

Name the variable DLV - Signup Method.

3.

Click on Variable Configuration and choose Data Layer Variable.

4.

Set the Data Layer Variable Name to eventModel.method.

5.

Save the variable.

6.

Repeat steps 1-5 to create another variable named DLV - Signup Email, with the Data Layer Variable Name set to eventModel.email.

Checkout Event Variables

1.

Go to Variables and click on New.

2.

Name the variable DLV - Checkout Currency.

3.

Click on Variable Configuration and choose Data Layer Variable.

4.

Set the Data Layer Variable Name to eventModel.currency.

5.

Save the variable.

6.

Repeat steps 1-5 to create the following variables:

DLV - Checkout Value with Data Layer Variable Name eventModel.value.

DLV - Checkout Coupon with Data Layer Variable Name eventModel.coupon.

DLV - Checkout Items with Data Layer Variable Name eventModel.items.

Payment Info Event Variables

1.

Follow the same steps as above to create the following variables:

DLV - Payment Currency with Data Layer Variable Name eventModel.currency.

DLV - Payment Value with Data Layer Variable Name eventModel.value.

DLV - Payment Coupon with Data Layer Variable Name eventModel.coupon.

DLV - Payment Items with Data Layer Variable Name eventModel.items.

Purchase Event Variables

1.

Follow the same steps as above to create the following variables:

DLV - Purchase Transaction ID with Data Layer Variable Name eventModel.transaction_id.

DLV - Purchase Currency with Data Layer Variable Name eventModel.currency.

DLV - Purchase Value with Data Layer Variable Name eventModel.value.

DLV - Purchase Coupon with Data Layer Variable Name eventModel.coupon.

DLV - Purchase Items with Data Layer Variable Name eventModel.items.

2. Set Up Event Triggers

For each event, you need to set up specific triggers that will fire the appropriate tag when a user action occurs.

1.

Go to Triggers and click on New.

2.

Name the trigger (e.g., "Login Trigger").

3.

Click on Trigger Configuration and choose Custom Event.

4.

Set the event name to login.

5.

Save the trigger.

1.

Go to Triggers and click on New.

2.

Name the trigger (e.g., "Signup Trigger").

3.

Click on Trigger Configuration and choose Custom Event.

4.

Set the event name to sign_up.

5.

Save the trigger.

Begin Checkout Event

1.

Go to Triggers and click on New.

2.

Name the trigger (e.g., "Begin Checkout Trigger").

3.

Click on Trigger Configuration and choose Custom Event.

4.

Set the event name to begin_checkout.

5.

Save the trigger.

Add Payment Info Event

1.

Go to Triggers and click on New.

2.

Name the trigger (e.g., "Add Payment Info Trigger").

3.

Click on Trigger Configuration and choose Custom Event.

4.

Set the event name to add_payment_info.

5.

Save the trigger.

Purchase Event

1.

Go to Triggers and click on New.

2.

Name the trigger (e.g., "Purchase Trigger").

3.

Click on Trigger Configuration and choose Custom Event.

4.

Set the event name to purchase.

5.

Save the trigger.

3. Create Tags to Capture Events

Now, you need to create tags that will send the data to Google Ads Conversion Tracking.

1.

Go to Tags and click on New.

2.

Name the tag (e.g., "Login Tag").

3.

Click on Tag Configuration and choose Google Ads Conversion Tracking.

4.

Set the Conversion ID and Conversion Label.

5.

In the Custom Parameters section, add the following:

method: {{DLV - Login Method}}

email: {{DLV - Login Email}}

6.

In the Triggering section, add the Login Trigger.

7.

Save the tag.

Example Payload:

1.

Go to Tags and click on New.

2.

Name the tag (e.g., "Signup Tag").

3.

Click on Tag Configuration and choose Google Ads Conversion Tracking.

4.

Set the Conversion ID and Conversion Label.

5.

In the Custom Parameters section, add the following:

method: {{DLV - Signup Method}}

email: {{DLV - Signup Email}}

6.

In the Triggering section, add the Signup Trigger.

7.

Save the tag.

Example Payload:

Begin Checkout Event Tag

1.

Go to Tags and click on New.

2.

Name the tag (e.g., "Begin Checkout Tag").

3.

Click on Tag Configuration and choose Google Ads Conversion Tracking.

4.

Set the Conversion ID and Conversion Label.

5.

In the Custom Parameters section, add the following:

currency: {{DLV - Checkout Currency}}

value: {{DLV - Checkout Value}}

coupon: {{DLV - Checkout Coupon}}

items: {{DLV - Checkout Items}}

6.

In the Triggering section, add the Begin Checkout Trigger.

7.

Save the tag.

Example Payload:

Add Payment Info Event Tag

1.

Go to Tags and click on New.

2.

Name the tag (e.g., "Add Payment Info Tag").

3.

Click on Tag Configuration and choose Google Ads Conversion Tracking.

4.

Set the Conversion ID and Conversion Label.

5.

In the Custom Parameters section, add the following:

currency: {{DLV - Payment Currency}}

value: {{DLV - Payment Value}}

coupon: {{DLV - Payment Coupon}}

items: {{DLV - Payment Items}}

6.

In the Triggering section, add the Add Payment Info Trigger.

7.

Save the tag.

Example Payload:

Purchase Event Tag

1.

Go to Tags and click on New.

2.

Name the tag (e.g., "Purchase Tag").

3.

Click on Tag Configuration and choose Google Ads Conversion Tracking.

4.

Set the Conversion ID and Conversion Label.

5.

In the Custom Parameters section, add the following:

transaction_id: {{DLV - Purchase Transaction ID}}

currency: {{DLV - Purchase Currency}}

value: {{DLV - Purchase Value}}

coupon: {{DLV - Purchase Coupon}}

items: {{DLV - Purchase Items}}

6.

In the Triggering section, add the Purchase Trigger.

7.

Save the tag.

Example Payload:

Final Steps

1.

Preview and Debug: Use the GTM preview mode to ensure that the tags are firing correctly.

2.

Publish: Once you’ve verified that everything is working as expected, publish the container.

By following these steps, you will successfully integrate Google Tag Manager with your application and start tracking
user interactions effectively.

Getting Started