Eventos Customizados¶

Lista completa de eventos personalizados enviados pelo Complyr para o dataLayer do Google Tag Manager, permitindo análises detalhadas do comportamento de consentimento.

📋 Visão Geral¶

O script Complyr envia automaticamente 8 eventos customizados para o dataLayer do GTM sempre que o usuário interage com o sistema de consentimento. Cada evento inclui 7 custom dimensions com dados contextuais.

Categorias de Eventos: - Consentimento (5 eventos): Ações relacionadas ao consentimento - Interação (3 eventos): Interações com a interface

🎯 Eventos de Consentimento¶

1. complyr_banner_shown¶

Quando dispara: Banner de consentimento é exibido ao usuário.

Casos de uso: - Medir taxa de exibição do banner - Calcular bounce rate de usuários que viram banner - A/B testing de posicionamento do banner

Exemplo de uso no GTM:

Criar tag do GA4 que envia evento quando banner é exibido:

// Tipo de Tag: Google Analytics 4 - Evento
// Acionador: Evento personalizado = complyr_banner_shown

Event Name: consent_banner_shown
Event Parameters:
  - workspace_id: {{complyr_workspace_id}}
  - anonymous_id: {{complyr_anonymous_id}}
  - template_id: {{complyr_template_id}}

2. complyr_accept_all¶

Quando dispara: Usuário clica no botão "Aceitar Todos" / "Aceitar Tudo".

Casos de uso: - Rastrear taxa de aceitação total - Medir efetividade do call-to-action - Identificar páginas com maior aceitação

Custom Dimensions Incluídas: - complyr_consent_status: granted - complyr_purposes_granted: Array com todos os propósitos

Exemplo de uso:

// Tag GA4: Conversão "Aceitou Todos"
Event Name: accept_all_consents
Event Parameters:
  - consent_status: {{complyr_consent_status}}
  - purposes_count: {{complyr_purposes_granted.length}}
  - conversion_value: 1  // Para medir como conversão

3. complyr_essential_only¶

Quando dispara: Usuário clica em "Apenas Essenciais" / "Somente Necessários".

Casos de uso: - Medir taxa de rejeição de cookies não essenciais - Entender perfil de usuários mais preocupados com privacidade - Ajustar estratégia de comunicação do banner

Custom Dimensions Incluídas: - complyr_consent_status: denied - complyr_purposes_granted: Array vazio ou apenas essential

Exemplo de tag:

// Tag GA4: Usuário rejeitou cookies
Event Name: essential_only
Event Parameters:
  - consent_status: denied
  - user_type: privacy_focused

4. complyr_preferences_saved¶

Quando dispara: Usuário personaliza preferências no modal granular e clica em "Salvar Preferências".

Casos de uso: - Rastrear usuários que personalizam consentimento - Identificar propósitos mais/menos aceitos - Otimizar descrições dos propósitos

Custom Dimensions Incluídas: - complyr_consent_status: partial, granted, ou denied - complyr_purposes_granted: Array com propósitos aceitos

Exemplo:

// Tag GA4: Preferências personalizadas
Event Name: custom_consent_saved
Event Parameters:
  - consent_status: {{complyr_consent_status}}
  - analytics_granted: {{complyr_purposes_granted}} contains 'analytics'
  - marketing_granted: {{complyr_purposes_granted}} contains 'marketing'

5. complyr_consent_revoked¶

Quando dispara: Usuário revoga consentimento previamente concedido (via API ou painel de preferências).

Casos de uso: - Monitorar taxa de revogação de consentimento - Disparar ações de limpeza (remover de listas de email) - Alertas para equipe de privacidade

Custom Dimensions Incluídas: - complyr_consent_status: revoked - complyr_purposes_granted: Array vazio

Exemplo:

// Tag GA4: Consentimento revogado
Event Name: consent_revoked
Event Parameters:
  - revocation_timestamp: {{complyr_timestamp}}
  - previous_status: granted  // Via variável customizada

🖱️ Eventos de Interação¶

6. complyr_preferences_opened¶

Quando dispara: Usuário abre o painel de preferências de consentimento.

Casos de uso: - Medir engajamento com painel de preferências - Rastrear cliques no link "Gerenciar Preferências" - A/B testing de visibilidade do link

Exemplo:

// Tag GA4: Painel de preferências aberto
Event Name: preferences_panel_opened
Event Parameters:
  - source: {{Click Source}}  // De onde veio o clique

7. complyr_preferences_closed¶

Quando dispara: Usuário fecha o painel de preferências sem salvar alterações (clicou fora, ESC, botão X).

Casos de uso: - Identificar usuários indecisos - Medir taxa de abandono do painel - Detectar problemas de UX no painel

Exemplo:

// Tag GA4: Painel fechado sem salvar
Event Name: preferences_abandoned
Event Parameters:
  - abandonment_reason: closed_without_saving

8. complyr_user_identified¶

Quando dispara: Usuário é identificado via API window.complyr.identify() após login.

Casos de uso: - Sincronizar consentimento com ID do usuário autenticado - Enhanced conversions do Google Ads - Cross-device tracking (com consentimento)

Custom Dimensions Incluídas: - complyr_user_id: Hash SHA-256 do email/identificador

Exemplo:

// Tag GA4: Usuário identificado
Event Name: user_identified
User Properties:
  - user_id: {{complyr_user_id}}  // Hash SHA-256

📊 Custom Dimensions¶

Todas as custom dimensions enviadas automaticamente com cada evento:

🛠️ Configurando no GTM¶

Passo 1: Criar Variáveis de DataLayer¶

Para cada custom dimension que deseja usar:

1. Vá em Variáveis → Nova
2. Escolha tipo "Variável da Camada de Dados"
3. Nome da variável da camada de dados: complyr_workspace_id (exatamente como listado acima)
4. Salve

Repita para todas as 7 variáveis.

Passo 2: Criar Acionadores Personalizados¶

Para cada evento que deseja rastrear:

1. Vá em Acionadores → Novo
2. Tipo: "Evento personalizado"
3. Nome do evento: complyr_accept_all (exatamente como listado)
4. Este acionador será disparado em: Todos os eventos personalizados
5. Salve

Passo 3: Criar Tags¶

Exemplo de tag do GA4 que rastreia aceitação de todos os cookies:

Tipo de Tag: Google Analytics 4 - Evento ID de Medição: G-XXXXXXXXXX (seu ID do GA4)

Nome do Evento: accept_all_consents

Parâmetros do Evento: - workspace_id = {{complyr_workspace_id}} - consent_status = {{complyr_consent_status}} - purposes_granted = {{complyr_purposes_granted}}

Acionador: complyr_accept_all (criado no passo 2)

📈 Análises Recomendadas¶

1. Taxa de Aceitação de Consentimento¶

Taxa = (complyr_accept_all + complyr_preferences_saved com status=granted) / complyr_banner_shown

Onde analisar: - Google Analytics 4: Relatório de Eventos - Data Studio: Dashboard customizado

2. Funil de Consentimento¶

graph TD
    A[Banner Exibido<br/>complyr_banner_shown] --> B{Usuário Escolhe}
    B -->|Aceita Todos| C[complyr_accept_all]
    B -->|Essenciais| D[complyr_essential_only]
    B -->|Personaliza| E[complyr_preferences_opened]
    E --> F{Salva?}
    F -->|Sim| G[complyr_preferences_saved]
    F -->|Não| H[complyr_preferences_closed]

Métricas: - Drop-off em cada etapa - Tempo médio de decisão - Taxa de personalização

3. Propósitos Mais/Menos Aceitos¶

Use complyr_purposes_granted para identificar: - Qual propósito tem maior taxa de aceitação? - Quais combinações de propósitos são mais comuns?

Exemplo de análise:

// Criar variável customizada no GTM
Variable Type: JavaScript personalizado
Variable Name: purposes_count

return {{complyr_purposes_granted}}.length;

Depois envie como custom dimension para o GA4.

🎯 Casos de Uso Avançados¶

Enhanced Conversions (Google Ads)¶

Use complyr_user_identified para ativar Enhanced Conversions:

// Tag: Google Ads - Enhanced Conversion
Conversion ID: AW-XXXXXXXXX
Acionador: complyr_user_identified

User Data:
  - email: {{complyr_user_id}}  // Hash SHA-256

Cross-Device Tracking¶

Sincronize complyr_user_id com User-ID do GA4:

// Tag GA4: Configuração
User-ID: {{complyr_user_id}}
Acionador: complyr_user_identified

Segmentação por Consentimento¶

Crie segmentos de usuários no GA4 baseados em: - complyr_consent_status = granted: Usuários que aceitaram tudo - complyr_consent_status = partial: Usuários que personalizaram - complyr_consent_status = denied: Usuários que negaram

🧪 Testando Eventos¶

Use o GTM Preview Mode para validar:

1. Clique em "Visualizar" no GTM
2. Abra seu site
3. Interaja com o banner Complyr
4. Na janela de debug, aba "Resumo", veja eventos disparados
5. Verifique se os valores das variáveis estão corretos

🔗 Próximos Passos¶

• Testando a Integração - Guia completo de validação
• Solução de Problemas - Problemas comuns
• Consent Mode v2 - Entenda o mecanismo
• Configuração - Voltar ao guia de setup