Parâmetros de Evento

O que são Parâmetros de Evento?

Parâmetros de Evento, também chamados de Event Parameters em inglês, são pares de nome e valor que viajam junto com cada evento enviado ao GA4. O evento diz o que aconteceu e os parâmetros dizem como, onde e com qual valor.

Um exemplo torna a ideia concreta. O evento purchase sozinho informa apenas que houve uma compra. Com os parâmetros value: 349.90, currency: "BRL" e items listando os produtos, o mesmo evento vira um registro completo da transação.

O GA4 envia alguns parâmetros automaticamente com todo evento, como page_location e page_title. Os eventos recomendados do Google têm parâmetros padronizados, e você pode criar parâmetros personalizados para as necessidades do seu negócio.

Como funciona na prática?

Um parâmetro só aparece nos relatórios se for coletado e, no caso dos personalizados, registrado. O fluxo tem três etapas:

1. Coleta: o site envia o parâmetro junto com o evento, em geral pelo Data Layer e por uma tag do Google Tag Manager. Exemplo: o evento form_enviado leva tipo_formulario: "orcamento".
2. Registro: para usar um parâmetro personalizado em relatórios, cadastre-o como dimensão personalizada (textos) ou métrica personalizada (números) na administração do GA4.
3. Análise: depois do registro, o parâmetro vira uma coluna disponível nos relatórios e nas explorações.

Parâmetros também têm papel especial nas conversões: o value de uma conversão alimenta as métricas de receita e o retorno sobre investimento em mídia.

Exemplos de uso

• E-commerce: uma loja envia purchase com value: 189.90, currency: "BRL", coupon: "PRIMEIRACOMPRA" e a lista de itens. A equipe analisa receita por cupom e por produto.
• Portal de conteúdo: cada page_view leva os parâmetros personalizados autor e editoria. O time de audiência descobre quais editorias mais engajam.
• Site de serviços: o evento click_whatsapp carrega posicao_botao: "header" ou "rodape", revelando qual posição gera mais contatos.

Erros comuns

• Coletar parâmetros personalizados e esquecer de registrá-los como dimensões, deixando os dados invisíveis nos relatórios.
• Enviar valores numéricos como texto, o que impede somas e médias.
• Ultrapassar os limites do GA4 de quantidade de parâmetros por evento e de tamanho dos valores, perdendo dados em silêncio.
• Colocar dados pessoais identificáveis, como e-mail ou CPF, em parâmetros, o que viola as políticas do Google e a LGPD.
• Criar nomes inconsistentes entre eventos, como form_type em um e tipo_form em outro.

Perguntas frequentes sobre Parâmetros de Evento

Qual a diferença entre parâmetro, dimensão e métrica?

O parâmetro é o dado bruto enviado com o evento. A dimensão e a métrica personalizadas são os registros que tornam esse parâmetro utilizável nos relatórios: dimensão para textos, métrica para números. Sem o registro, o parâmetro personalizado fica coletado, porém oculto.

Quantos parâmetros posso enviar por evento?

O GA4 limita a quantidade de parâmetros por evento e o comprimento dos nomes e valores, com tetos diferentes entre a versão gratuita e a 360. Os números exatos mudam com o tempo, então consulte a documentação oficial antes de planejar uma implementação extensa.

Preciso registrar todos os parâmetros como dimensões?

Não. Registre apenas os parâmetros que você pretende analisar, porque o GA4 limita a quantidade de dimensões e métricas personalizadas por propriedade. Parâmetros padrão, como page_location, já aparecem sem registro. Priorize o que responde às perguntas do seu plano de medição.