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 a Tag Manager variable

Creating Triggers

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 Given" (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 "contains" 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.