Skip to main content

Integration via Google Tag Manager

This documentation provides instructions on how to install and configure the "Avacy CMP" template within Google Tag Manager (GTM).

Prerequisites​

Adding the Avacy CMP Template to Google Tag Manager​

  1. Log in to your Google Tag Manager account and select the desired container.

  2. Go to Templates in the side menu.

  3. In the Tag Templates section, click Search Gallery.

  4. Search for Avacy CMP, open it, click Add to workspace, then confirm with Add.

Configuring the Avacy CMP Tag​

  1. Create a New Tag in your container and select the "Avacy CMP" template.

Alt text

  1. Configure the parameters required by the template by entering the team name and the webspace key. Both of these parameters can be found in the platform settings under Integrate the banner on your web space, selecting the Google Tag Manager option from the options available in the drop-down menu.

Alt text

  1. Set the tag trigger to Consent Initialization - All Pages. This trigger fires the tag before all others and shows the banner on every page of the site. Do not use All Pages: the consent defaults would arrive too late.

    In Default consent, choose the initial state of each consent type, before the user's choice. They all start as Denied. With GTM the template sends this default, not the banner: the banner sends only the updates after the choice. Wait for update is the time, in milliseconds, that Google tags wait for the update before going on with the default.

    If you need different defaults for some regions, open Default consent by region. Each row takes one ISO 3166-2 code (for example IT, US or US-CA). For more regions, add more rows.

To validate your Avacy CMP template integration, use Google Tag Manager's Preview mode to ensure the tag fires correctly and the consent banner displays as expected on all pages.

  1. To make your changes live, remember to click the blue "Submit" button, enter the details for the new GTM version including the banner, and then click "Publish". Without this step, the banner will not appear on the website.

Alt text

Updating from version 1.x​

If the container already has the "Avacy CMP" template in version 1.x, update it from the Gallery: in Templates, open the template and accept the update that GTM offers. Then publish the container with Submit.

Tags already configured keep their parameters. The 1.x Chose specific version field (advanced settings) stays saved in the tag, but no longer counts: the Avacy CDN chooses the banner version.

The Google Tag Manager integration is fully compatible with Google Consent Mode. This allows you to leverage Google’s standardized consent signaling, enhancing transparency and control over data processed by tags.

To learn how to correctly integrate and configure Google Consent Mode with Avacy via GTM, please refer to our guide.