Configurando Google Analytics 4
Guia completo para gerar o Segredo da API (Measurement Protocol) e conectar seus Eventos Qualificados ao GA4.
Para enviar eventos do Intentyon diretamente para o Google Analytics 4 (sem depender do navegador do usuário), utilizamos o Measurement Protocol.
Esta é a tecnologia "Server-Side" do Google. Para ativá-la, você não precisa apenas do ID do seu fluxo de dados, mas também de uma chave especial chamada Segredo da API (API Secret).
Este guia mostra exatamente onde criar essa chave.
1. Localizando o ID da Métrica (Measurement ID)
O ID da Métrica identifica para qual propriedade do GA4 os dados devem ir.
- Acesse sua conta no Google Analytics.
- No canto inferior esquerdo, clique em Administrador (ícone de engrenagem).
- Na coluna "Coleta e modificação de dados", clique em Fluxos de dados (Data Streams).
- Clique no fluxo de dados do seu site (Web).
- No topo da janela que abrir, copie o ID DA MÉTRICA. Ele geralmente começa com
G-(ex:G-A1B2C3D4).
Documentação Oficial: Encontrar o ID da métrica no GA4.
2. Criando o Segredo da API (API Secret)
Esta etapa é frequentemente ignorada, mas é obrigatória para o Intentyon funcionar.
- Ainda na mesma janela de detalhes do Fluxo de dados da Web (onde você pegou o ID acima).
- Role a página para baixo até a seção "Eventos".
- Clique na opção Segredos da API do Measurement Protocol (Measurement Protocol API secrets).
- Clique no botão Criar (ou "Revisar termos" se for a primeira vez).
- Dê um apelido para a chave (sugerimos
Intentyon CAPI). - Copie o valor do Valor do segredo gerado.
Atenção: O "Segredo da API" não é o mesmo que o "ID da Métrica". O segredo é uma sequência longa de caracteres aleatórios que atua como uma senha. Sem ele, o Google rejeitará os dados enviados pelo Intentyon.
3. Ativando no Intentyon
- No painel do Intentyon, vá para o seu Projeto e clique na aba Configurações.
- Role até a seção Credenciais das Plataformas.
- Clique para expandir a opção Google Analytics 4 (GA4).
- Cole o ID da Métrica (G-XXXX) no primeiro campo.
- Cole o Segredo da API no segundo campo.
- Clique em Salvar Alterações.
Segurança dos Dados
Assim como com o Meta, seu Segredo de API é criptografado com AES-256-GCM no momento em que é salvo.
4. Como os Eventos Aparecem no GA4
O Intentyon padroniza automaticamente o nome dos eventos para garantir que o Google os aceite.
- Prefixo: Todos os eventos enviados pelo Intentyon terão o prefixo
intentyon_. - Formato: Espaços são substituídos por sublinhados (
_) e tudo é convertido para minúsculas. - Exemplo: Se você criou um evento no Intentyon chamado "Leitor Qualificado", ele aparecerá no GA4 como
intentyon_leitor_qualificado.
Validando em Tempo Real
Para testar se a integração está funcionando:
- Abra o relatório de Tempo Real no seu GA4.
- Abra seu site em uma janela anônima e realize a ação de qualificação.
- Aguarde de 1 a 2 minutos.
- O evento deve aparecer no cartão "Contagem de eventos por Nome do evento".
Latência dos Relatórios: Embora os dados apareçam no "Tempo Real" quase instantaneamente, eles podem levar de 24 a 48 horas para aparecerem nos relatórios de aquisição e engajamento padrão do GA4. Isso é uma característica da plataforma do Google.