Entendendo Eventos GA4: Um Explicador em Linguagem Simples

Por Emily Redmond, Analista de Dados na Emilytics · Abril de 2026

TL;DR: Eventos são ações que usuários realizam. GA4 tem eventos automáticos (pageview, scroll, click) e eventos customizados que você define. Cada evento tem parâmetros que adicionam contexto. Entender eventos é a fundação do rastreamento GA4.

GA4 é orientado por eventos. Tudo—cada interação, cada mudança de estado—é um evento. Se você não entender eventos, você está perdido em GA4. Mas são mais simples do que parecem. Este artigo decompõe em linguagem simples.

O Que É um Evento?

Um evento é algo que um usuário faz, ou algo que acontece em seu site ou app. Exemplos:

• Chegar em uma página (page_view)
• Fazer scroll na página (scroll)
• Clicar em um botão (click)
• Enviar um formulário (form_submit)
• Reproduzir um vídeo (video_play)
• Comprar um item (purchase)
• Fechar o app (app_close)

Na visão de GA4, cada interação é um evento. Sem distinção entre "importante" e "não importante"—são todos eventos. Você decide quais importam marcando-os como conversões.

Eventos Automáticos

GA4 coleta automaticamente certos eventos sem nenhuma configuração customizada:

Estes são úteis, mas são apenas a fundação. Eles dizem que algo aconteceu, mas não por quê ou o quê.

💡 A opinião de Emily: Uma vez auditei uma configuração GA4 onde alguém dependia inteiramente de eventos automáticos. Eles sabiam que usuários estavam scrollando, mas não que conteúdo os estava engajando. Eventos customizados com parâmetros mudaram tudo—de repente eles podiam ver "usuários que assistiram >75% da página de pricing" ou "usuários que passaram o mouse no demo do produto." É quando GA4 fica poderoso.

Eventos Customizados

Um evento customizado é um que você cria para rastrear algo específico do seu negócio. Exemplos:

• search_performed: Um usuário buscou por um produto
• add_to_cart: Um usuário adicionou um item ao carrinho
• feature_used: Um usuário usou um recurso específico
• video_started: Um usuário clicou play em seu próprio vídeo (não-YouTube)
• error: Um erro JavaScript ocorreu
• chat_opened: Um usuário abriu o widget de chat

Para disparar um evento customizado, você usa código ou Google Tag Manager:

Via Código (JavaScript)

gtag('event', 'add_to_cart', {
  item_id: '12345',
  item_name: 'Blue Widget',
  item_price: 29.99,
  quantity: 1
});

Via Google Tag Manager

1. Crie um gatilho (ex: "Clique no botão adicionar-ao-carrinho")
2. Crie uma tag de evento GA4 com o nome do evento (add_to_cart)
3. Adicione parâmetros (item_id, item_name, etc.)
4. Publique

Parâmetros: O Segredo

Um parâmetro de evento é um par chave-valor que adiciona contexto a um evento. Parâmetros são onde GA4 fica poderoso.

Um page_view básico diz que uma página foi visitada. Mas um evento page_view com parâmetros diz:

Evento: page_view
Parâmetros:
  - page_path: /pricing
  - page_title: Pricing Page
  - page_category: pricing
  - user_segment: premium
  - experiment_id: test_v2

Agora você pode filtrar: "Mostre-me pageviews na página de pricing para usuários premium no grupo de teste." Sem parâmetros, isso é impossível.

Parâmetros Padrão (Integrado)

GA4 inclui parâmetros padrão automaticamente:

• page_path: O caminho da URL
• page_title: O título da página
• page_referrer: De onde o usuário veio
• page_location: A URL completa
• event_count: Quantas vezes este evento disparou na sessão

Parâmetros Customizados (Você Define)

Você pode adicionar até 25 parâmetros customizados por evento:

gtag('event', 'purchase', {
  transaction_id: 'txn_12345',
  value: 99.99,
  currency: 'USD',
  items: [
    {
      item_id: 'prod_001',
      item_name: 'Widget',
      price: 99.99,
      quantity: 1
    }
  ],
  coupon_code: 'SAVE20',
  shipping_address: 'New York'
});

Cada parâmetro deveria ter um nome e valor claros. item_name: 'Widget' é bom; x: 'w' é inútil.

Convenções de Nomenclatura de Eventos

Nomeie seus eventos customizados claramente. Use snake_case (underscores, não espaços ou pontos). Exemplos:

✓ Bom: video_play, form_submission, add_to_cart, feature_upgrade

✗ Ruim: Video Play, form.submission, addToCart, x1

GA4 permite usar até 40 caracteres. Use esse espaço para ser descritivo.

Eventos Customizados Recomendados (Por Caso de Uso)

Para SaaS / Negócios de Serviço

• demo_requested: Usuário pediu um demo
• pricing_viewed: Usuário visualizou página de pricing
• free_trial_started: Usuário começou trial gratuito
• subscription_upgraded: Usuário fez upgrade de seu plano
• support_ticket_opened: Usuário abriu ticket de suporte

Para Ecommerce

• product_viewed: Usuário visualizou página de detalhe de produto
• add_to_cart: Usuário adicionou item ao carrinho
• remove_from_cart: Usuário removeu item do carrinho
• begin_checkout: Usuário começou checkout
• purchase: Usuário completou uma compra
• wishlist_added: Usuário adicionou item à lista de desejos

Para Publishers / Sites de Conteúdo

• article_read: Usuário terminou de ler um artigo
• video_completed: Usuário assistiu vídeo completo
• newsletter_signup: Usuário se inscreveu em newsletter
• comment_posted: Usuário postou um comentário

Para Apps

• onboarding_completed: Usuário terminou onboarding
• feature_used: Usuário usou um recurso específico
• app_crashed: App crashed
• push_notification_clicked: Usuário clicou notificação push

Como Disparar um Evento Customizado: Passo-a-Passo

Digamos que você quer rastrear quando alguém clica seu botão "Agendar um Demo".

Opção 1: Google Tag Manager (Sem Código)

1. Vá para seu contêiner GTM
2. Crie um Gatilho:
   • Tipo de gatilho: Click
   • Alguns Cliques
   • Filtro: Texto de clique → contém → "Agendar um Demo"
3. Crie uma Tag:
   • Tipo de tag: Google Analytics: GA4 Event
   • Nome do evento: demo_requested
   • ID de Medição: (seu ID GA4)
   • Gatilho: Aplique o gatilho que você criou acima
4. Adicione Parâmetros (opcional):
   • Nome do parâmetro: button_location | Valor: homepage_header
5. Salve e Publique

Visite seu site, clique no botão, verifique GA4 Tempo Real. Você deveria ver demo_requested disparar.

Opção 2: Código Direto (JavaScript)

document.querySelector('.book-demo-button').addEventListener('click', function() {
  gtag('event', 'demo_requested', {
    button_location: 'homepage_header',
    timestamp: new Date().toISOString()
  });
});

Ou, se você está usando um framework:

handleDemoClick = () => {
  gtag('event', 'demo_requested', {
    button_location: 'pricing_page_cta'
  });
  // Redirecione para ferramenta de booking
  window.location.href = '/booking';
}

Visualizando Eventos em GA4

Em Tempo Real

1. Vá para GA4
2. Clique em Tempo real (sob Relatórios)
3. Você vê eventos disparando em tempo real
4. Expanda um evento para ver seus parâmetros

Em Relatórios Padrão

1. Clique em Relatórios → Eventos (sob Engagement)
2. Selecione o nome do evento
3. Veja contagem de evento, usuários únicos, etc.

Em Explorations

1. Clique em Explorar (fundo da barra lateral esquerda)
2. Crie um relatório freeform
3. Adicione event_name como uma dimensão
4. Filtre ou segmente por eventos

Armazenamento de Dados de Evento e Limites

GA4 armazena dados de evento com timestamps, parâmetros e informações de usuário. Alguns limites importantes:

• Máx 25 parâmetros customizados por evento (parâmetros padrão não contam)
• Máx 25 items por evento (útil para compras com múltiplos itens)
• Máx 40 caracteres para nomes de dimensão/métrica customizados
• Dados de evento mantidos por 2 meses (nível de usuário; você pode estender para 14 meses ou exportar para BigQuery para ilimitado)

Perguntas Frequentes

P: Se eu disparo o mesmo evento customizado duas vezes em uma sessão, ambos contam? R: Sim. Cada evento dispara independentemente. Se um usuário clica "Adicionar ao Carrinho" duas vezes, você verá dois eventos add_to_cart. GA4 os conta separadamente.

P: Posso mudar o nome de um evento depois que comecei a colecioná-lo? R: Não retroativamente. Se você perceber que nomeou um evento signin quando quis dizer sign_in, você não consegue renomear os dados antigos. Daqui em frente, você dispara o novo nome de evento. É um novo começo para aquele evento.

P: Qual é a diferença entre parâmetros de evento e propriedades de usuário? R: Parâmetros de evento estão anexados a um único evento (ação daquele usuário agora). Propriedades de usuário estão anexadas ao usuário (tier de conta daquele usuário, localização, etc.). Use parâmetros para dados específicos de ação; use propriedades de usuário para dados específicos de usuário.

P: Posso disparar eventos do meu app e do meu website para a mesma propriedade? R: Sim, se você usar o mesmo ID de Medição ou Measurement Protocol. Mas a prática recomendada é usar a mesma propriedade com fluxos de dados separados (um web, um app). Isso permite que você segmente por plataforma.

P: Com que frequência posso disparar o mesmo evento? R: Quantas vezes quiser. Sem limites de frequência. Se um usuário clica um botão 100 vezes, você verá 100 eventos (embora GA4 possa fazer sample deles em escala massiva).

O Grande Resumo

Eventos são a linguagem de GA4. Eventos automáticos o iniciam; eventos customizados o tornam poderoso. Parâmetros transformam eventos de "algo aconteceu" em "algo específico aconteceu com este usuário neste contexto."

Gaste tempo pensando sobre quais eventos customizados importam para seu negócio. Então implemente-os deliberadamente. Os dados que você coleta agora determinam os insights que você pode extrair depois.

Pronto para rastrear conversões? Veja Como Configurar Rastreamento de Conversão GA4 (Passo-a-Passo).

Emily Redmond é analista de dados na Emilytics — o agente de análise com IA que monitora seu GA4, Search Console e dados do Bing o tempo todo para que você nunca perca o que importa. 8 anos de experiência ajudando founders e times de growth a transformar ruído de dados em decisões claras. Diga oi →