Configuração: Google Tag Manager¶

Integre o Complyr com Google Tag Manager usando Consent Mode v2 em 5 passos simples.

Passo 1: Entender a Integração¶

A integração utiliza o Modo de Consentimento v2 do GTM. O script da Complyr, instalado em seu site, envia os status de consentimento (concedido ou negado) para a dataLayer do Google. O GTM então utiliza essa informação para decidir se pode ou não disparar suas tags (Google Analytics, Google Ads, etc.).

Fluxo:

sequenceDiagram
    participant User
    participant Complyr
    participant DataLayer
    participant GTM
    participant GA4

    User->>Complyr: Visita site
    Complyr->>DataLayer: consent default (denied)
    GTM->>GA4: Bloqueia tags (sem consent)
    User->>Complyr: Aceita cookies
    Complyr->>DataLayer: consent update (granted)
    GTM->>GA4: Dispara tags (com consent)

Passo 2: Mapear Propósitos no Complyr¶

O primeiro passo é garantir que os propósitos de consentimento no Complyr estejam mapeados para as chaves corretas do GTM.

1. Navegue até Consentimento → Modelos no menu lateral
2. Crie ou edite um modelo
3. Para cada propósito na seção "Propósitos de Consentimento", um novo campo "Chave de Consentimento GTM" estará visível
4. Preencha com as chaves nativas do GTM. Os padrões recomendados já vêm preenchidos:

Mapeamento Padrão:

Passo 3: Habilitar o Modo de Consentimento no GTM¶

Dentro do seu contêiner do Google Tag Manager, você precisa habilitar a funcionalidade.

1. Acesse seu contêiner do GTM em tagmanager.google.com
2. Vá para Admin → Configurações do contêiner
3. Na seção "Configurações adicionais", marque a caixa "Ativar visão geral de consentimento"
4. Salve as alterações

Passo 4: Configurar o Consentimento nas Tags¶

Agora, você precisa dizer a cada tag qual consentimento ela necessita para ser disparada.

1. No GTM, vá para a seção Tags e clique na tag que deseja configurar (ex: sua tag do Google Analytics 4)
2. Clique em Configuração da tag → Configurações avançadas → Configurações de consentimento
3. Selecione a opção "Exigir consentimento adicional para que a tag seja disparada"
4. Clique em "Adicionar consentimento obrigatório" e escolha o tipo de armazenamento que a tag precisa

Exemplo: Google Analytics 4 - Adicione analytics_storage como consentimento obrigatório

Exemplo: Google Ads - Adicione ad_storage e ad_user_data como consentimentos obrigatórios

Passo 5: Testar a Integração¶

Use o modo de visualização do GTM para testar a integração.

1. No GTM, clique em "Visualizar" e insira a URL do seu site
2. Na janela de depuração, selecione a aba "Consentimento"
3. No carregamento da página: Você verá o estado "Padrão". Todas as chaves não essenciais devem estar como "Negado"
4. Interaja com o banner do Complyr: Aceite os cookies
5. Após o aceite: Você verá um novo evento Consent com o estado "Atualizado". As chaves que você aceitou devem mudar para "Concedido"
6. Verifique na aba "Tags" se as suas tags foram disparadas somente após o consentimento ser concedido

Eventos Personalizados do Complyr¶

Além do Modo de Consentimento, o script Complyr envia automaticamente eventos personalizados para o dataLayer, permitindo análises detalhadas sobre o comportamento de consentimento dos usuários.

Eventos de Consentimento¶

Eventos de Interação¶

Custom Dimensions Disponíveis¶

Todos os eventos incluem automaticamente as seguintes variáveis no dataLayer:

Como Usar no GTM¶

Para capturar esses eventos e dimensões no GTM:

1. Criar Variáveis de DataLayer¶

1. Vá em Variáveis → Nova
2. Escolha tipo "Variável da Camada de Dados"
3. Defina o nome da variável (ex: complyr_workspace_id)
4. Salve

Repita para todas as custom dimensions que deseja usar.

2. Criar Acionadores Personalizados¶

1. Vá em Acionadores → Novo
2. Escolha "Evento personalizado"
3. Defina o nome do evento (ex: complyr_accept_all)
4. Salve

3. Usar em Tags¶

Nas suas tags do Google Analytics, use as variáveis criadas como Custom Dimensions ou parâmetros de eventos.

Exemplo: Tag do GA4 com Parâmetros Personalizados

// Configuração da tag GA4
Event Parameters:
- complyr_workspace: {{complyr_workspace_id}}
- consent_status: {{complyr_consent_status}}
- purposes_granted: {{complyr_purposes_granted}}

Próximos Passos¶

• Entenda o Consent Mode v2 - Detalhes técnicos do funcionamento
• Eventos Customizados - Lista completa e exemplos de uso
• Testando a Integração - Guia completo de testes
• Solução de Problemas - Problemas comuns e soluções