Como organizar a data layer de um site com GTM

Data layer (camada de dados) é o contrato entre a aplicação e as tags do Google Tag Manager (GTM). A aplicação envia eventos com nomes/valores previsíveis; o GTM escuta esses nomes com acionadores de evento personalizado. Isso evita depender do texto de botão, classes ou seletores frágeis.

Defina o esquema e envie um evento

Para cada evento, documente nome, momento, campos e tipos, valores permitidos, sistema responsável, consentimento e casos em que não deve disparar. Exemplo de lead após confirmação do servidor:

window.dataLayer = window.dataLayer || [];

window.dataLayer.push({
  event: 'generate_lead',
  form_id: 'contact_site',
  form_location: 'service_page'
});

Mantenha event e seus campos no mesmo objeto. O exemplo não envia nome, email ou texto digitado. Inicialize antes do snippet GTM e nunca substitua uma fila existente; use window.dataLayer = window.dataLayer || [].

Configure e valide no GTM

1. Crie um Acionador > Evento personalizado com nome exato generate_lead.
2. Crie variáveis da camada de dados para form_id e form_location e mantenha o esquema documentado compatível com a implementação.
3. Associe o acionador às tags necessárias. No Preview/Tag Assistant, envie formulário válido e confirme um evento após a confirmação do servidor.
4. Teste validação inválida, erro do servidor e recarregamento; nenhum deve gerar lead confirmado. Após publicar, valide também o destino real: prévia não prova processamento.

Como comprovar que a tarefa terminou

Compare o contrato versionado com o Tag Assistant e a aplicação. No fluxo feliz, confirme evento único e campos documentados; em falha/erro, confirme ausência. Valide consentimento e evento no Analytics ou sistema receptor após publicação.

Checklist de revisão

• A aplicação não substitui a fila e envia evento/campos juntos, após sucesso confirmado.
• Evento e valores não contêm PII, credenciais ou conteúdo livre sem justificativa e validação.
• Nomes, tipos, valores, responsável e versão do esquema estão documentados para aplicação e GTM.

Limites e interpretação

Evite nome, email, telefone, conteúdo de campos, senhas, dados de pagamento e identificadores pessoais. O evento personalizado não substitui a gestão de consentimento. Para ecommerce ou conversões, siga o esquema recomendado e teste moeda, tipo, deduplicação e momento de confirmação.

Continue na biblioteca

Consulte também o hub de metricas para aprofundar as etapas relacionadas.

Fonte oficial: Camada de dados e eventos personalizados — Google Tag Platform.