All docs

Install via GTM

The recommended path. Uses our Custom Template + Consent Initialization trigger.

Why a template (not Custom HTML)

A Custom HTML tag in GTM cannot guarantee its code runs before other tags fire. That defeats Consent Mode v2 — Google tags read "no defaults set" and proceed unrestricted. Our template uses the typed setDefaultConsentState sandbox API and the Consent Initialization trigger, which GTM guarantees to fire first.

Steps

1. In your GTM container: Templates → New → Import, select gtm-template/template.tpl from the repo.

2. Tags → New → Adsvantage Consent Hub. Fill in the website id and the loader URL (both shown in the dashboard under Banner → Installation).

3. Trigger: Consent Initialization — All Pages.

4. Submit + publish the workspace.

5. Back in the dashboard, press Verify installation. You should seebanner_shown or implicit events within seconds.

Permissions

The template asks for three sandboxed permissions: setDefaultConsentState, injectScript, and dataLayer read/write. See gtm-template/field-permissions.md for why each is needed.