Como usar: Gerador de Requisição GA4 Measurement Protocol
- Crie um API secret no GA4: Admin → Fluxos de dados → seu fluxo → Segredos da API do Measurement Protocol.
- Informe o ID de medição e o secret, depois escolha o evento e os parâmetros.
- Ative o servidor de validação, execute a requisição e corrija o que ele apontar.
- Desative a validação e envie eventos reais do seu servidor.
Quando usar o Measurement Protocol
Ele registra coisas que o navegador nunca vê: uma assinatura renovada, um reembolso, uma venda por telefone ou um webhook do seu provedor de pagamento. Envie o client_id do visitante (do cookie _ga) para que o evento entre na sessão dele, e o session_id se quiser que ele fique na mesma sessão. O endpoint de validação devolve os problemas em JSON e não registra nada; o endpoint real sempre responde 204, mesmo com dados inválidos. Mantenha o API secret no seu servidor, pois qualquer pessoa que o tiver pode enviar dados para a sua propriedade.
Também pesquisado como: ga4 measurement protocol, gerador measurement protocol, ga4 eventos server side, mp collect, ga4 api secret, measurement protocol curl, ga4 conversões offline.
Ferramentas que combinam com: Gerador de Requisição GA4 Measurement Protocol
- Gerador de Código de Evento GA4 — Escolha um evento recomendado do GA4 — generate_lead, sign_up, purchase, add_to_cart e outros — ou crie o seu, preencha os parâmetros e itens e copie o código como gtag(), um dataLayer.push() do Tag Manager ou uma requisição Measurement Protocol do servidor.
- Conversor cURL — Cole um comando curl, da documentação de uma API ou da opção “Copiar como cURL” do DevTools do seu navegador, e receba código pronto para usar em seis linguagens, com headers, corpo e autenticação preservados.
- Testador de API — Uma alternativa leve ao Postman no seu navegador: monte uma requisição HTTP, envie e veja status, tempo, headers e o JSON formatado.
- Decodificador GA4 — Depure o Google Analytics 4 sem adivinhação.
Perguntas frequentes
Por que o endpoint collect retorna 204 para tudo?
O endpoint de produção nunca informa erros. Envie o mesmo corpo para /debug/mp/collect para ver as mensagens de validação.
Em quanto tempo os eventos do Measurement Protocol aparecem?
Normalmente em Tempo real em até um minuto; os relatórios padrão podem levar até um ou dois dias.
Posso enviar eventos sem uma visita ao site?
Sim, mas você ainda precisa de um client_id. Use um ID próprio e estável por cliente; esses eventos iniciam sessões próprias em vez de entrar em uma visita web.
Posso instalar o Gerador de Requisição GA4 Measurement Protocol como um aplicativo da web e usá-lo offline?
Sim. O Gerador de Requisição GA4 Measurement Protocol é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.