Integração com Google Tag Manager

Configuração básica

Passo 1: Criar tag Custom HTML

1. Acesse Google Tag Manager
2. Selecione seu container
3. Vá para Tags → Nova
4. Clique em Configuração da tag → Custom HTML
5. Cole o seguinte código:

<!-- Cookield CMP -->
<script src="https://cdn.cookield.io/banner/SEU_BANNER_ID.js" async></script>

Passo 2: Configurar trigger

A trigger correta garante que a Cookield seja carregada antes de qualquer outra tag:

1. Em Triggering, clique para adicionar um trigger
2. Selecione Consent Initialization - All Pages

Passo 3: Publicar

1. Clique em Salvar
2. Use o Preview para testar antes de publicar
3. Se estiver tudo certo, clique em Enviar → Publicar

Consent Mode v2

A Cookield integra automaticamente com o Google Consent Mode v2. Quando um usuário interage com o banner, a Cookield atualiza os sinais de consentimento que o GTM utiliza para controlar tags.

Como funciona

Ao carregar, a Cookield define o estado padrão (denied) para todos os sinais:

// Estado padrão (antes do consentimento)
gtag('consent', 'default', {
  'analytics_storage': 'denied',
  'ad_storage': 'denied',
  'ad_personalization': 'denied',
  'ad_user_data': 'denied',
  'functionality_storage': 'denied',
  'personalization_storage': 'denied',
  'security_storage': 'granted'
});

Quando o usuário aceita categorias específicas, a Cookield atualiza os sinais:

// Após o usuário aceitar analytics e marketing
gtag('consent', 'update', {
  'analytics_storage': 'granted',
  'ad_storage': 'granted',
  'ad_personalization': 'granted',
  'ad_user_data': 'granted'
});

Ativando Consent Mode no Dashboard

1. No Dashboard da Cookield, vá para Banners → Seu banner → Configurações
2. Na seção Integrações, ative Google Consent Mode v2
3. Mapeie as categorias de cookies para os sinais do Google:
   • Analytics → analytics_storage
   • Marketing → ad_storage, ad_personalization, ad_user_data
   • Funcionalidade → functionality_storage, personalization_storage
4. Salve as configurações

Avançado: Eventos dataLayer

A Cookield envia eventos ao dataLayer do GTM que você pode usar como triggers para suas tags personalizadas.

Eventos disponíveis

Exemplo: Trigger personalizada

Crie uma trigger no GTM que dispara quando o usuário aceita analytics:

// Evento enviado ao dataLayer pela Cookield
dataLayer.push({
  event: 'cookield_consent_update',
  cookield_consent: {
    necessary: true,
    analytics: true,
    marketing: false,
    functionality: true
  }
});

No GTM, crie uma trigger do tipo Custom Event com o nome cookield_consent_update e adicione uma condição para filtrar pelo valor de cookield_consent.analytics.

Variável do dataLayer

Para acessar o estado do consentimento em outras tags, crie variáveis do dataLayer:

1. Vá para Variáveis → Nova → Variável da camada de dados
2. Nome da variável: cookield_consent.analytics
3. Repita para cada categoria que precisar