Developers

Documentation

Everything to install Consorm, manage consent and integrate your tools, from the first script to exporting the records.

Getting started

GTM template installation

The manual method for teams that already manage their Google Tag Manager container: import the Consorm template, enter your site ID and publish.

With the template method, Consorm never touches your Google Tag Manager container: you import an official tag template into your own GTM, configure it with your site ID, and publish yourself. It is the method to choose when a team or an agency already manages the site's container.

Prerequisites

  • A GTM container already installed on the site (<head> and <body> snippets in place).
  • Edit and publish access to that container.
  • Your site created in app.consorm.com, with its nine-digit ID shown on the Installation page, GTM template (manual) tab.

Publish your banner first

The site's consent configuration must be published in the dashboard (the banner editor's Publish button) before installing the template. Without a published configuration, the tag finds nothing to load and fails silently.

Step 1: Import the template

  1. 1On Consorm's Installation page, GTM template (manual) tab, download the consorm-consent-template.tpl file.
  2. 2In Google Tag Manager, open TemplatesTag TemplatesNew.
  3. 3In the top-right corner menu, choose Import, select the .tpl file, then save. The Consorm Consent Optimization template appears among your templates.

Step 2: Create the tag

  1. 1Open TagsNew and choose the Consorm Consent Optimization template.
  2. 2Enter your Consorm site ID (the nine digits).
  3. 3As the trigger, choose Consent Initialization - All Pages. This trigger guarantees the consent instruction fires before all your other tags.
  4. 4Save, then publish the container.

As soon as it is published, the tag declares the default Consent Mode v2 state (everything denied except security_storage, with wait_for_update at 500 ms), then loads the Consorm banner for your site. The template also offers three optional parameters to change the default of the Marketing, Analytics and Preferences categories; leave them at Denied for a site subject to an explicit-consent law.

Step 3: Condition your own tags

With this method, your GA4, Meta and other tags stay in your container: conditioning them on consent is up to you. In each tag, open Consent settings and require the appropriate signal: analytics_storage for analytics, ad_storage, ad_user_data and ad_personalization for advertising. The banner relays each visitor decision through Consent Mode; GTM does the rest. See Google Analytics and other tools.

Step 4: Verify

  • Use GTM's Preview: the Consorm tag must fire on the consent initialization event, before any other tag.
  • On the site, the banner must appear, and the Network tab must show no request to your trackers before the visitor's choice.
  • Consorm's Installation page also offers Verify installation for an automatic confirmation.

Tag management

With the template installation, the dashboard's Providers tab points you back to your own GTM: your tags belong to you, Consorm does not create them for you.