Gerador de código de evento GA4 — gtag, dataLayer e Measurement Protocol

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. Nomes e valores são verificados contra os limites do GA4 enquanto você digita.

Atualizado em

Itens

Seus dados nunca saem do seu computador. Todo o processamento acontece localmente no navegador.

Como usar: Gerador de Código de Evento GA4

  1. Escolha um evento recomendado para receber os parâmetros padrão dele, ou selecione Evento personalizado e digite um nome como newsletter_signup.
  2. Preencha ou adicione parâmetros; eventos de ecommerce também ganham uma lista de Itens com botões para adicionar e remover.
  3. Escolha o formato: gtag() para sites com a tag do Google, dataLayer para o Tag Manager ou Measurement Protocol para eventos do servidor.
  4. Opcionalmente, envolva o código em um listener de clique ou envio de formulário, copie e confira o evento no DebugView do GA4.

Eventos recomendados x eventos personalizados

O GA4 entende eventos recomendados — como generate_lead, sign_up, login, search e o conjunto de ecommerce, de view_item até purchase — e usa esses dados nos relatórios integrados. Prefira-os sempre que um se encaixar. Para qualquer outro caso, um evento personalizado funciona da mesma forma; registre os parâmetros como dimensões personalizadas em Administrador → Definições personalizadas para vê-los nos relatórios.

As verificações feitas

  • Nomes de eventos e parâmetros: começam com letra, usam apenas letras, números e underscores, têm no máximo 40 caracteres e não podem usar prefixos reservados (google_, ga_, firebase_) ou nomes de eventos reservados.
  • No máximo 25 parâmetros por evento, e valores de parâmetros de até 100 caracteres.
  • Ecommerce: value precisa de uma currency, purchase precisa de um transaction_id único, e cada item precisa de um item_id ou item_name.

Três formas de enviar

gtag() envia direto para o GA4. Com o Tag Manager, o dataLayer.push() entrega o evento ao contêiner, onde um gatilho de Evento Personalizado e uma tag de evento do GA4 o encaminham — envios de ecommerce são precedidos de { ecommerce: null } para que itens antigos não vazem para o próximo evento. O Measurement Protocol envia eventos a partir do seu servidor, para ações que acontecem fora da página, como a renovação de uma assinatura ou uma venda offline. Para rastrear cliques sem escrever código para cada botão, use o Gerador de Script de Rastreamento de Eventos.

Também pesquisado como: gerador de evento ga4, código gtag evento, código evento ga4, evento personalizado ga4, eventos recomendados ga4, código ecommerce ga4, evento purchase gtag, parâmetros de evento ga4.

Ferramentas que combinam com: Gerador de Código de Evento GA4

  • Gerador de Google Tag — Informe seu ID de medição do GA4, seu ID do Google Ads ou o ID do contêiner do Tag Manager e receba um código de instalação pronto para colar, com padrões do Consent Mode v2, vinculação entre domínios, modo debug, visualizações de página manuais e configurações de cookies ativadas somente quando você precisar.
  • Gerador de dataLayer.push — Monte o código dataLayer.push() para o Google Tag Manager: escolha um evento recomendado do GA4 ou crie o seu, adicione parâmetros e itens de ecommerce e, se quiser, envolva tudo em um listener de clique ou envio de formulário — pronto para colar.
  • Decodificador GA4 — Depure o Google Analytics 4 sem adivinhação.
  • Gerador de UTM — Adicione utm_source, utm_medium, utm_campaign e outros parâmetros a qualquer link, veja em qual canal do GA4 a visita será registrada e marque uma lista inteira de URLs de uma vez.

Perguntas frequentes

Como envio um evento personalizado para o GA4?
Chame gtag('event', 'nome_do_seu_evento', { parametro: 'valor' }) depois que a tag do Google for carregada. Escolha Evento personalizado aqui, digite o nome e os parâmetros e copie o código.
Por que meus parâmetros de evento não aparecem nos relatórios?
Parâmetros personalizados só aparecem nos relatórios padrão depois que você os registra em Administrador → Definições personalizadas. Dados coletados antes do registro não são preenchidos.
Qual é a diferença entre gtag e dataLayer.push?
gtag() é um pequeno wrapper que envia dados para o dataLayer da tag do Google. Com o Tag Manager, você envia objetos simples com uma chave event, e os gatilhos do contêiner decidem o que acontece.
Eventos do Measurement Protocol precisam de um client ID?
Sim. Use o client_id do cookie _ga do visitante para vincular eventos do servidor à sessão web dele, ou um ID próprio e estável para eventos sem visita ao site.
Posso instalar o Gerador de Código de Evento GA4 como um aplicativo da web e usá-lo offline?
Sim. O Gerador de Código de Evento GA4 é 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.

Ferramentas relacionadas