Google Analytics

Reutilizar configurações de evento no Gerenciador de tags do Google

Esta página é destinada a quem mantém a tag do Google no Gerenciador de tags e quer definir configurações de eventos.

O que é uma variável de configurações do evento?

Você pode reutilizar configurações de eventos em várias tags do Google e do GA4 usando uma variável Tag do Google: configurações de eventos.

Exemplo: você tem uma loja on-line e está fazendo uma promoção. Então, você quer saber quantas pessoas usarão o código de desconto que você forneceu. Em vez de adicionar um parâmetro discount a cada uma das tags manualmente, é possível reutilizar o parâmetro com uma variável Tag do Google: configurações de eventos.

Como usar uma variável de configurações de evento

Para criar uma nova variável de configurações de evento:

Abra o Gerenciador de tags do Google.
No espaço de trabalho, abra o menu Variáveis à esquerda.
Crie uma variável Nova definida pelo usuário.
Em Configuração da variável, selecione a variável Tag do Google: configurações de eventos.
Adicione os parâmetros que você quer reutilizar. Confira abaixo uma tabela de parâmetros predefinidos. Se nenhum deles for útil, crie um parâmetro personalizado. Basta digitar um nome no campo Nome.
(Opcional) Adicione Propriedades do usuário do Google Analytics ao seu evento.
1. Em Propriedades do usuário do Google Analytics, clique em Adicionar propriedade.
2. Configure o par de chave-valor para enviar com o evento:
  - Defina o Nome da propriedade como a categoria que você quer enviar, por exemplo, favorite_food.
  - Defina Valor como os dados específicos do usuário, por exemplo, apple.
Dê um nome à variável e clique em Salvar.

Reutilizar configurações em uma tag do Google

Para enviar parâmetros no nível do evento com cada evento, use a variável de configurações de evento em uma tag do Google.

No seu espaço de trabalho, abra o menu Tags à esquerda.
Selecione uma tag do Google em que você quer implementar uma variável de configurações.
Reutilizar configurações:
- Para reutilizar o campo Definições de configuração, selecione uma variável Tag do Google: configurações na lista suspensa.
- Se quiser reutilizar as Configurações de eventos compartilhados, escolha uma variável Tag do Google: configurações de eventos na lista suspensa.
- Para consultar quais parâmetros foram herdados da variável de configurações, clique em Mostrar configurações herdadas.
- Se quiser modificar um parâmetro herdado apenas na tag do Google, clique em Editar .
- Para reverter um parâmetro herdado editado, clique em Redefinir .
Salve a tag e publique o contêiner.

Reutilizar configurações em uma tag de evento do GA4

Para enviar parâmetros de evento somente para determinados eventos do GA4, adicione a variável de configurações de evento a uma tag de evento do GA4.

No seu espaço de trabalho, abra o menu Tags à esquerda.
Selecione a tag de evento do GA4 à qual você quer aplicar uma variável de configurações.
Reutilizar configurações:
- Se quiser reutilizar as Configurações de eventos, escolha uma variável Tag do Google: configurações de eventos na lista suspensa.
- Para consultar quais parâmetros foram herdados da variável de configurações, clique em Mostrar configurações herdadas.
- Se quiser modificar um parâmetro herdado apenas na tag do Google, clique em Editar .
- Para reverter um parâmetro herdado editado, clique em Redefinir .
Salve a tag e publique o contêiner.

Parâmetros válidos para configurações de eventos

As tabelas a seguir listam os parâmetros predefinidos e com quais produtos eles podem ser usados (marcados com um x), agrupados por tipo de parâmetro. Esses não são nomes de eventos. Para acessar uma lista de nomes de eventos predefinidos, consulte a referência de eventos recomendados.

Observação: todos os parâmetros listados abaixo são indefinidos, exceto o parâmetro language. O valor padrão de language é navigator.language.

string

Nome	Descrição	Anúncios	GA4	Merchant Center
achievement_id	ID da conquista que foi desbloqueada. Parte do evento unlock_achievement para medir a experiência do jogo.		x
aw_feed_country	O país associado ao feed em que seus itens são enviados. Use códigos de território CLDR, por exemplo, '`US`'. Parte do Relatório de conversões com dados do carrinho.	x
aw_language	O idioma associado ao feed em que seus itens são enviados. Use os códigos de idioma ISO 639-1. Parte do Relatório de conversões com dados do carrinho.	x
content_group	Os grupos de conteúdo permitem categorizar páginas e telas em buckets personalizados. Saiba mais		x	x
content_id	Um identificador para o conteúdo selecionado, por exemplo, `C_12345`. Parte do evento select_content.		x	x
content_type	O tipo de conteúdo, por exemplo, '`image`'. Parte do evento share e select_content.		x
coupon	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.		x
country	Parâmetro para capturar o país do usuário. Use o formato ISO 3166-1 alpha-2. Por exemplo, '`US`' para Estados Unidos.	x
currency	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. * Se você definir `value, currency` será necessário para que as métricas de receita sejam calculadas corretamente.	x	x	x
estimated_delivery_date	A data de entrega mais recente (ou "máxima") prometida para um pedido nos dados do carrinho de um cliente. Em casos de pedidos qualificados para entrega rápida e gratuita (status de novo ou em manutenção), o Google usa essa data para validar a velocidade da entrega. Observação: esse parâmetro usa o formato de data internacional (AAAA-MM-DD). A data de envio deve se basear na data e no fuso horário do local enviado para `delivery_post_code`. Parte do acompanhamento de conversões do Google Ads para validar dados de entrega.	x
group_id	O ID do grupo, por exemplo, `G_12345`. Parte do evento join_group, usado para medir a popularidade de determinados grupos ou recursos sociais.		x
language	Especifica a preferência de idioma do usuário.	x	x	x
method	O método que um usuário escolhe para fazer algo, por exemplo, '`email`'. Parte do evento login, share e sign_up.		x
payment_type	A forma de pagamento escolhida pelo cliente, por exemplo, '`credit card`'.		x
search_term	Termo que foi pesquisado. Parte do evento search.		x
send_to	Especifica um ID de destino da tag do Google. Para ser usado com o parâmetro de configuração groups.	x	x	x
delivery_tier	O nível de entrega (por exemplo, '`Ground`', '`Air`', '`Next-day`') selecionado para a entrega do item comprado.	x	x	x
transaction_id	O identificador exclusivo de uma transação, por exemplo, `T_12345`. O parâmetro `transaction_id` ajuda a evitar eventos duplicados para uma compra.	x	x	x
virtual_currency_name	Nome da moeda virtual. Parte dos eventos `earn_virtual_currency` e `spend_virtual_currency`.		x

integer

Nome	Descrição	Anúncios	GA4	Merchant Center
aw_merchant_id	O ID do Merchant Center. Adicione esse parâmetro se você tiver um item em várias contas do Merchant Center e quiser controlar de onde serão lidos os dados do item no Merchant Center, por exemplo, o CPV. Parte do Relatório de conversões com dados do carrinho.	x

number

Nome	Descrição	Anúncios	GA4	Merchant Center
delivery_post_code	O prefixo regional ou a parte de identificação de um código postal para o endereço de entrega de um pedido. O prefixo regional é usado para determinar o desempenho da entrega do comerciante. Ao enviar esses dados, recomendamos incluir somente os três primeiros dígitos do código postal. Parte do acompanhamento de conversões do Google Ads para validar dados de entrega.	x		x
discount	Valor do desconto monetário associado ao item.	x	x
score	A pontuação do usuário. Parte do evento post_score para medir as pontuações em jogos.		x
delivery	Custo da entrega associado a uma transação, por exemplo, `4,99`.	x	x	x
tax	Custo dos tributos associados a uma transação, por exemplo, `1,11`.		x	x
value	O valor monetário do evento, por exemplo, `12,99`. O parâmetro value é necessário para gerar relatórios importantes e preencher o público-alvo preditivo dos compradores. * Se você definir `value`, também vai precisar definir `currency`.	x	x	x

array<Item>

Nome

Descrição

Anúncios

GA4

Merchant Center

items

Inclui os itens do evento. Esse é um parâmetro de e-commerce que tem subparâmetros. Você encontra os subparâmetros para:

Anúncios: conversões com dados do carrinho
GA4: referência de parâmetros do item

object

Nome

Descrição

Anúncios

GA4

Merchant Center

user_data

Parâmetro para desativar a coleta automática de dados fornecidos pelo usuário.

Para desativar as páginas selecionadas, defina user_data como null. Para desativar totalmente a coleta de dados definidos pelo usuário, use a configuração da tag do Google.

user_properties

Parâmetro para enviar outras propriedades do usuário do Google Analytics com um evento. Saiba como configurar as propriedades do usuário.

Recursos relacionados

Isso foi útil?

Como podemos melhorá-lo?