Developer Documentation

Google Tag Manager Consent Integration

Support for Google Tag Manager is provided via GTM's data layer variable. When either the page loads or consent is subsequently changed the data layer is updated allowing you to create triggers based on the consent given.

The event name is altis-consent-changed and the variable is named altisConsent. The variable data is a list of the consent categories currently given for example "functional, statistics-anonymous".

Creating the Variable

To get started in GTM first navigate to Variables in the left hand sidebar and on User-Defined variables panel click "New".

  • For the name enter something like "Cookie Consent Categories"
  • For the variable type choose "Data Layer Variable"
  • For the Data Layer Variable Name enter altisConsent
  • Save the new variable

Adding the Tag Manager variable

Creating Triggers

Triggers in GTM can be used to block the execution of certain tags by adding them as exceptions. We recommend this method to check if consent is missing before firing a given tag.

You will need to create a trigger for each category of consent you need to check when firing tags. Navigate to the Triggers section on the left hand sidebar and then click "New".

  • For the name enter "Marketing Consent Missing"
    • replace "Marketing" with whichever category your trigger will be for
  • For the trigger type choose "Custom Event"
  • For the Event Name enter altis-consent-changed
  • Select "Some custom events" for when the trigger should fire and options to create conditions will appear
  • From the list of variables select your "Cookie Consent Categories" variable from earlier
  • Select "does not contain" as the operator
  • Enter "marketing" as the text the variable should contain
    • again replace "marketing" with the category you are adding
  • Save the trigger

Note: if you have 2 categories with similar text e.g. "statistics" and "statistics-anonymous" you can add a comma after the name to get an exact match, for example "statistics,"

Adding a Tag Manager trigger

Repeat the above steps for each consent category you need.

Once you are done you can start using these triggers to ensure only the tags that your website visitors have consented to are loaded by clicking "Add Exception" and selecting the trigger(s) that check the required consent categories.

Adding a Tag Manager tag that checks consent categories