Eventos-chave no GA4: como marcar conversões e o que mudou

Quem abre o GA4 hoje e procura por “conversões” não encontra o que esperava. O Google separou o conceito em dois: o evento-chave, que mede ações importantes dentro do Analytics, e a conversão, que passou a designar a ação usada nos anúncios. Na interface em português, o menu se chama “Eventos principais”. Neste texto, evento-chave e evento principal são a mesma coisa: o primeiro é a tradução corrente de key event, o segundo é o nome que aparece no menu.

A confusão de nomes gera erros caros. Lojas marcam dezenas de eventos como principais, esperam histórico retroativo, importam eventos para o Google Ads sem entender que entram como conversões secundárias e comparam números de plataformas que contam de formas diferentes.

Este guia explica o que mudou, como marcar e desmarcar um evento, como escolher o método de contagem, como importar para o Google Ads e quais erros evitar, com base nas páginas de ajuda oficiais do Google.

O que mudou: de conversão para evento principal

Segundo a página oficial sobre conversões e eventos principais, os eventos que antes eram marcados como conversões no Analytics eram medidos de forma diferente das conversões do Google Ads, o que gerava discrepâncias. Por isso passaram a se chamar eventos principais. O termo “conversão” ficou reservado à ação usada para medir o desempenho de anúncios e orientar lances.

A definição oficial, na página sobre eventos principais, é que um evento principal mede uma ação particularmente importante para o sucesso da empresa. Qualquer evento coletado pode ser marcado como principal.

Como o dado vem de modelos de atribuição diferentes, o número do GA4 e o do Google Ads para a mesma ação nem sempre bate. Isso não é defeito de configuração; é a consequência dos dois sistemas. O mesmo raciocínio vale para a divergência de receita entre o GA4 e a loja, explicada em por que a receita do GA4 não bate com a da plataforma.

Quais eventos já vêm marcados como principais

A página Marcar eventos como principais lista os eventos principais por padrão:

• Web e app: purchase.
• Somente app: first_open, in_app_purchase, app_store_subscription_convert e app_store_subscription_renew.
• Com personalização de anúncios ativa e Google Ads vinculado: add_to_cart, add_to_wishlist, begin_checkout, session_start, view_item, view_item_list e view_search_results.

Isso significa que, em uma loja com Google Ads vinculado, vários eventos do funil já podem vir marcados sem que ninguém tenha decidido isso. Revise a lista logo no início da configuração, como parte da configuração do GA4 do zero.

Como marcar um evento como principal

Pela lista de eventos

1. Acesse Administrador > Exibição de dados > Eventos.
2. Em “Eventos recentes” ou na busca, localize o evento.
3. Clique na estrela ao lado do evento. É necessário ter o papel de editor ou superior.
4. Na aba “Eventos principais”, ajuste o valor padrão e o método de contagem, se necessário.

É possível marcar um evento que ainda não foi coletado. A marcação vale a partir daquele momento e não é retroativa. Os relatórios padrão podem levar até 24 horas para refletir a mudança, e o tempo real atualiza em minutos. Marque cedo, mesmo antes do lançamento da campanha.

Criando um evento a partir de outro

Para páginas de agradecimento sem evento próprio, a página sobre criar ou modificar eventos descreve o caminho:

1. Acesse Administrador > Exibição de dados > Eventos > “+ Criar evento”.
2. Dê o nome ao evento (por exemplo, generate_lead) e ative “Marcar como evento principal”.
3. Em “Escolha como criar um evento”, selecione “Criar sem código”.
4. No evento de origem, escolha page_view e informe a URL da página de confirmação.
5. Clique em “Criar” e valide abrindo a página de confirmação e conferindo o card “Eventos principais por nome” no tempo real.

Nunca modifique o page_view: o comando “Criar” copia o evento, enquanto “Modificar” substitui o original. A configuração pode levar de minutos a horas.

Pelo Google Tag Manager

Esta é a prática da Analytikos, não uma instrução de página oficial: crie uma tag de evento do GA4 com o nome do evento e os parâmetros value, currency e transaction_id, dispare-a por um acionador de evento do dataLayer e, depois, marque o evento como principal dentro do GA4, porque o GTM não faz essa marcação. Valide no DebugView e no tempo real. O passo a passo da ferramenta está em Google Tag Manager para iniciantes.

Método de contagem: uma vez por evento ou uma vez por sessão

A página sobre o método de contagem define duas opções. “Uma vez por evento” (recomendada) conta cada disparo: cinco disparos na sessão contam cinco. “Uma vez por sessão” (legada) conta uma única vez por sessão. O padrão é “uma vez por sessão” para eventos criados a partir de metas do Universal Analytics em propriedades criadas automaticamente e para metas migradas pelo assistente de configuração após abril de 2023. Para todos os outros, o padrão é “uma vez por evento”.

A mudança vale somente daqui para frente, sem recalcular o histórico, e cria quebra de tendência. É preciso o papel de profissional de marketing. Anote a data da alteração no seu relatório, porque a comparação entre períodos antes e depois da mudança deixa de ser equivalente.

Valor do evento principal

Na Admin API, o campo defaultValue (numericValue e currencyCode) preenche o parâmetro value quando ele não vem no evento. Os dois subcampos são obrigatórios, segundo o recurso properties.keyEvents. Para enviar valor ao Google Ads a partir de um evento criado no Analytics, é preciso value numérico e currency em código ISO 4217. Sem eles, o evento conta, mas não é enviado ao Google Ads.

Para lojas brasileiras, envie currency como BRL e value como número, sem símbolo nem separador de milhar. O detalhamento do evento de compra e dos parâmetros está em GA4 para e-commerce: eventos recomendados.

Importar eventos principais para o Google Ads

O procedimento está na ajuda do Google Ads. Os pré-requisitos são propriedade vinculada ao Ads, autotagging ligado e acesso mínimo de analista de marketing. O caminho é Publicidade > Gerenciamento de conversões > “Nova conversão”. Os eventos selecionados ali também passam a ser eventos principais no Analytics.

• As conversões importadas entram como secundárias, para não contar em dobro nos lances.
• Conversões de visualização (view-through) não aparecem.
• Conversões entre dispositivos exigem Google signals.
• O crédito pode ir para “Canais pagos do Google” ou “Canais pagos e orgânicos”. O padrão para propriedades vinculadas desde junho de 2023 é “Canais pagos do Google”.

Atribuição e janelas de lookback

Em Administrador > Exibição de dados > Eventos > Configurações de atribuição, a página oficial informa que a janela padrão é de 30 dias para eventos de aquisição (first_open e first_visit), com opção de 7 dias, e de 90 dias para os demais eventos principais, com opções de 30 ou 60 dias. A mudança do modelo de atribuição é retroativa; a da janela de lookback não é. A configuração afeta dimensões de escopo de evento (origem, mídia, campanha e grupo de canais padrão) e métricas como eventos principais e receita, mas não dimensões de sessão ou de usuário. Os modelos linear, baseado em posição, primeiro clique e influência da conversão estão indisponíveis desde novembro de 2023.

Em equipe, avise antes de mudar o modelo, porque a alteração reescreve números históricos de origem e mídia.

Limites e regras que costumam passar despercebidos

Quem consome dados por API ou por dashboards antigos precisa migrar os nomes. Segundo o registro de mudanças da Data API, a dimensão isConversionEvent foi substituída por isKeyEvent, a métrica conversions virou keyEvents e userConversionRate virou userKeyEventRate. Na exportação para o BigQuery, não encontramos na parte consultada do esquema um campo que indique se o evento é principal; parta da hipótese de que o modelo de dados precisa de uma lista própria de nomes de eventos.

Eventos principais em lojas brasileiras

As recomendações abaixo são da Analytikos, sem fonte oficial específica:

• Priorize purchase, begin_checkout e add_to_cart, e mantenha poucos eventos principais para não esgotar o limite.
• Em lojas com Pix ou boleto, confirme que o purchase só dispara depois do pagamento aprovado, para não inflar a receita.
• Para sites de serviço, marque generate_lead e os cliques de contato; o rastreamento de WhatsApp é tratado em um guia à parte.

Erros comuns com eventos-chave no GA4

Erros de configuração

• Marcar quase todo evento como principal. O limite é 30 (50 no GA360) e a lista inchada polui relatórios e lances. Mantenha só ações com valor de negócio.
• Evento criado sem value e currency. O evento conta, mas não vai ao Google Ads. Envie value numérico e currency ISO 4217, ou defina um valor padrão.
• Nome do evento com mais de 40 caracteres. Ele não é reportado como principal. Use nomes curtos, em snake_case.
• purchase contando em dobro. Falta de transaction_id ou recarregamento da página redisparam o evento. Envie o transaction_id e proteja o disparo. (A causa é inferência da Analytikos; a página oficial lida não a detalha.)
• Contagem por sessão herdada do Universal Analytics. Metas migradas podem subcontar eventos repetidos. Revise o método e aceite a quebra de tendência.

Erros de interpretação

• Esperar histórico retroativo. A marcação vale a partir do momento em que é feita, e o gráfico parece começar do zero. Marque cedo.
• Achar que desmarcar apaga dados. O histórico continua aparecendo como evento principal. Documente a data da mudança.
• Confundir evento principal com conversão do Google Ads. Os números diferem por modelo de atribuição e janela. Compare com o mesmo modelo ou use cada número para sua finalidade.
• Mudar método ou modelo de atribuição sem avisar. A alteração quebra a tendência ou reescreve números históricos. Comunique antes e anote a data.

Erros de operação

• Importar para o Google Ads e esperar lances automáticos. As conversões importadas entram como secundárias e não entram nos lances. Revise a categoria da ação no Ads.
• Manter código antigo com conversions ou isConversionEvent. Relatórios e dashboards podem quebrar. Migre para keyEvents e isKeyEvent.

Checklist de eventos-chave no GA4

• Lista de eventos principais definida, abaixo do limite de 30 (50 no GA360).
• purchase com transaction_id, value e currency (BRL).
• Método de contagem revisado por evento.
• Valor padrão definido, onde fizer sentido.
• Janela de lookback e modelo de atribuição conferidos.
• Propriedade vinculada ao Google Ads com autotagging ativo.
• Importação feita e categoria revisada no Google Ads.
• Validação no tempo real e no DebugView.
• Dashboards e scripts migrados para keyEvents e isKeyEvent.
• Mudanças documentadas com data.

Conteúdos Relacionados

• GA4 para e-commerce: eventos recomendados e como validar
• Receita do GA4 não bate com a da loja: causas e conciliação
• Como configurar o GA4 do zero: guia passo a passo