Block your tags with our Google Tag Manager integration [NEW FLOW]

This article will guide you through Didomi's integration with Google Tag Manager (GTM) to configure the loading of tags on your website when there is consent from the user.

Introduction:  events and variables sent in the Data Layer

The GTM integration enables the Didomi SDK to send events. These events can generate variables in the GTM Data Layer. 

• Didomi Events

We recommend using the didomi-consent event as it includes the others and is usually the most suitable.

You can find these events in our 📰 technical documentation. 

• Didomi Variables

Didomi events will generate Didomi variables in the GTM Data Layer.

You do not have to use all variables. The most used variable is "didomiVendorsEnabled", which holds the list of all vendors with user consent.

You can find the variables 📰 here.

The goal here is to use these events and variables in the triggers you create, in order to activate tag loading only if the user has given consent. A trigger is activated depending on the event and the variable.

 Integration

To get started, you need to activate the GTM integration when you set up your consent notice. 

1. Go to Consent notices (1) and click to edit your notice.
2. Go to step 2. Customization (2) and the Integrations tab (3).
3. Make sure you are in the Tag Managers section (4).
   
4. Scroll down to select the Google Tag Manager integration.
5. In the Data Layer Name field, write the name of your data layer.
6. The standard name "dataLayer" is used by default. 
7. If you keep the standard name you can leave the field as is.
8. If you chose a new name, you can see it in the code of your website (ask your tech team). 
9. If you didn't use the Console to create your consent notice, add this in the object didomiConfig:
   
   tagManager: {
   
   provider: 'gtm'
   
   }
10. Do not add this code if you have checked the box in the console. 

Create a variable

1. Go to your Google Tag Manager account.
   👉 Let's begin by creating a variable "didomiVendorsEnabled" (i.e., the most commonly used variable). This will enable you to set up tag loading when consent is given by a user for each vendor.
2. Click on Folders in the left menu.
   
3. Click on New Folder.
4. Name your folder "Didomi".
   
5. Click on the three dots to the left of the Didomi file.
6. Click on Add a variable.
   
7. Enter this information:

Create triggers

You will now create triggers and connect these triggers to one of the Didomi events (we recommend using didomi-consent) and to the "Didomi Vendors Enabled" variable (created in the previous step).

You will need to create a trigger for each non-IAB vendor that you wish to block.

To create a trigger:

1. Click on Folders in the left menu.
2. Click on the three dots to the right of the Didomi file.
3. Click on Add New trigger.
   
4. Enter this information:

Repeat for all non-IAB vendors. You need to create one trigger per non-IAB vendor.

👉If your existing trigger is a personalised trigger, you need to "create a group of triggers"  so that the tag is activated when condition 1 (the existing one) and condition 2 (the one linked to consent) both meet. 

👉If you add both the existing trigger linked to consent AND the existing trigger to the tag, the latter will be launched when the condition 1 OR 2 is valid. Do not use both at the same time, as this causes cookies to be dropped before/without consent (non-compliant). 

To create a group of triggers:

1. Click on Folders in the left menu.
2. Click on the three dots of the Didomi file, and Add new trigger.
   
3. Enter this information:
   

   Name of trigger group: "Group of triggers – Consent + {name of the other condition} - {vendor name}", for example
   Replace what is written between the curly brackets {} with the corresponding information (and remove the {}).
   The name of the trigger group has no impact, you can use whatever name you prefer.

   Type of trigger: click on the pencil icon and choose "Group of triggers".

   Click on ,  to the right of Triggers.
   Select the existing trigger for your tag.
   Click on   again.
   Select the Didomi trigger matching the vendor, previously created (cf. previous step).
   
4. Save.

👉This trigger (or group of triggers) can now be used in tags so they are activated whenever the user gives his consent for this vendor. 

 

 

Match the trigger to the tag

Finally, you need to connect the trigger to its tag. This last step is very important.

In the Tags section of your GTM account: 

1. Click on one of your existing tags for a non-IAB vendor.
2. Add the trigger or the group of triggers (created previously) matching with the vendor of the tag, instead of the trigger used previously. 
3. Save.