Eventos recomendados

Com esses eventos, você pode medir outros recursos e comportamentos, além de gerar relatórios mais úteis no Google Analytics 4. Como é preciso mais contexto para que os eventos façam sentido, eles não são enviados automaticamente. Use este documento para conferir os parâmetros obrigatórios e opcionais de cada evento.

add_payment_info

Esse evento significa que um usuário enviou as informações de pagamento em um processo de finalização de compra de e-commerce.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao evento.

Os parâmetros coupon no nível do evento e do item são independentes.
payment_type string Não Cartão de crédito Forma de pagamento escolhida.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

add_shipping_info

Esse evento significa que um usuário enviou as informações de frete em um processo de finalização de compra de e-commerce.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao evento.

Os parâmetros coupon no nível do evento e do item são independentes.
shipping_tier string Não Terrestre Tipo de frete (por exemplo, Ground, Air, Next-day) selecionado para a entrega do item comprado.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

add_to_cart

Esse evento indica que um item foi adicionado a um carrinho de compras.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

add_to_wishlist

O evento indica que um item foi adicionado à lista de desejos. Use esse evento para identificar os presentes mais procurados no seu app.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

begin_checkout

Esse evento indica que um usuário iniciou o processo de finalização da compra.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao evento.

Os parâmetros coupon no nível do evento e do item são independentes.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

earn_virtual_currency

Este evento mensura quando um usuário recebe moeda virtual em um jogo. Registre-o com spend_virtual_currency para entender melhor sua economia virtual.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
virtual_currency_name string Não Pedras preciosas Nome da moeda virtual.
value number Não 5 Valor da moeda virtual.

Exemplo

generate_lead

Este evento determina quando um lead é gerado (por exemplo, por meio de um formulário). Registre isso para entender a eficácia das campanhas de marketing e como muitos clientes interagem novamente com sua empresa após o remarketing para os clientes.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.

Exemplo

join_group

Registre esse evento quando um usuário entrar em um grupo, como uma associação, equipe ou família. Use esse evento para analisar a popularidade de determinados grupos ou recursos sociais.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
group_id string Não G_12345 ID do grupo.

Exemplo

level_end

Este evento indica que um jogador chegou ao final de um nível em um jogo.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
level_name string Não O início da jornada... Nome do nível.
success boolean Não verdadeiro Defina como true se o nível tiver sido concluído.

Exemplo

level_start

Esse evento indica que um jogador iniciou um nível em um jogo.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
level_name string Não O início da jornada... Nome do nível.

Exemplo

level_up

Esse evento indica que um jogador subiu de nível em um jogo. Use para avaliar a distribuição de níveis da sua base de usuários e identificar fases difíceis de concluir.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
level number Não 5 Nível do personagem.
character string Não Jogador 1 Personagem que subiu de nível.

Exemplo

login

Envie esse evento para indicar que um usuário fez login no seu site ou app.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
method string Não Serviços Método usado para fazer login.

Exemplo

post_score

Envie esse evento quando o usuário registrar uma pontuação. Use esse evento para entender o desempenho dos usuários no seu jogo e correlacionar as maiores pontuações com os públicos-alvo ou comportamentos.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
score number Sim 10.000 Pontuação que será registrada.
level number Não 5 Nível da pontuação.
character string Não Jogador 1 Personagem que conseguiu a pontuação.

Exemplo

purchase

Esse evento indica quando um ou mais itens são comprados por um usuário.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
transaction_id string Sim T_12345 Identificador exclusivo de uma transação.

O parâmetro transaction_id evita duplicar eventos de uma compra.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao evento.

Os parâmetros coupon no nível do evento e do item são independentes.
shipping number Não 3,33 Custo de frete associado a uma transação.
tax number Não 1,11 Custo dos tributos associados a uma transação.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

refund

Esse evento indica quando um ou mais itens são reembolsados a um usuário.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
transaction_id string Sim T_12345 Identificador exclusivo de uma transação.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao evento.

Os parâmetros coupon no nível do evento e do item são independentes.
shipping number Não 3,33 Custo de frete associado a uma transação.
tax number Não 1,11 Custo dos tributos associados a uma transação.
items Array<Item> Não* Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

remove_from_cart

Esse evento indica que um item foi removido do carrinho.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

Registre este evento para indicar quando o usuário realizou a pesquisa. Você pode usar esse evento para identificar o conteúdo que os usuários estão pesquisando no seu site ou app. Por exemplo, você pode enviar esse evento quando um usuário acessar uma página de resultados de pesquisa depois de realizar uma pesquisa.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
search_term string Sim camisetas Termo que foi pesquisado.

Exemplo

select_content

Este evento indica que um usuário selecionou conteúdo de determinado tipo, além de ajudar você a identificar conteúdo e categorias em alta relacionados ao seu site ou app.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
content_type string Não produto Tipo de conteúdo selecionado.
content_id string Não C_12345 Um identificador para o item selecionado.

Exemplo

select_item

Esse evento indica que um item foi selecionado em uma lista.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Ignorado quando o parâmetro é definido no nível do item.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Ignorado quando o parâmetro é definido no nível do item.
items Array<Item> Sim* Itens do evento.

* A matriz do parâmetro items precisa ter um único elemento que representa o item selecionado. Quando há vários elementos definidos, só o primeiro em items é usado.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

select_promotion

Esse evento indica que uma promoção foi selecionada em uma lista.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
creative_name string Não summer_banner2 Nome do criativo promocional.

Ignorado quando o parâmetro é definido no nível do item.
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao evento.

Ignorado quando o parâmetro é definido no nível do item.
promotion_id string Não P_12345 ID da promoção associada ao evento.

Ignorado quando o parâmetro é definido no nível do item.
promotion_name string Não Promoção de verão Nome da promoção associada ao evento.

Ignorado quando o parâmetro é definido no nível do item.
items Array<Item> Não Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

share

Use esse evento quando um usuário compartilhar conteúdo.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
method string Não Twitter Método de compartilhamento do conteúdo.
content_type string Não imagem Tipo de conteúdo compartilhado.
item_id string Não C_12345 ID do conteúdo compartilhado.

Exemplo

sign_up

Esse evento indica que um usuário se inscreveu em uma conta. Use o evento para entender os diferentes comportamentos de usuários conectados e desconectados.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
method string Não Serviços Método usado para inscrição.

Exemplo

spend_virtual_currency

Esse evento mede a venda de produtos virtuais no seu app e ajuda você a identificar os itens mais procurados.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
value number Sim 5 Valor da moeda virtual.
virtual_currency_name string Sim Pedras preciosas Nome da moeda virtual.
item_name string Não Incentivo para iniciantes Nome do item em que a moeda virtual está sendo usada.

Exemplo

tutorial_begin

Esse evento indica o início do processo de integração. Use-o em um funil com tutorial_complete para entender quantos usuários concluem o tutorial.

Parâmetros

Não há parâmetros para esse evento.

Exemplo

tutorial_complete

Esse evento indica a conclusão do processo de integração do usuário. Utilize-o em um funil com tutorial_begin para entender quantos usuários concluem o tutorial.

Parâmetros

Não há parâmetros sugeridos para esse evento.

Exemplo

unlock_achievement

Registre esse evento quando o usuário desbloquear uma conquista. O evento ajuda você a entender como os usuários estão explorando seu jogo.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
achievement_id string Sim A_12345 ID da conquista que foi desbloqueada.

Exemplo

view_cart

Esse evento indica que um usuário viu o carrinho.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

view_item

Esse evento indica que parte do conteúdo foi exibido ao usuário. Use o evento para descobrir os itens mais procurados que foram visualizados.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Sim* USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.

* Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value number Sim* 30,03 Valor monetário do evento.

* Defina value como a soma de (price * quantity) para todos os itens em items. Não inclua shipping ou tax.
* O parâmetro value geralmente é necessário para gerar relatórios importantes. Se você marcar o evento como uma conversão, é recomendável definir value.
* O parâmetro currency é obrigatório quando você define value.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

view_item_list

Registre esse evento quando uma lista de itens de uma determinada categoria for exibida para o usuário.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Ignorado quando o parâmetro é definido no nível do item.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Ignorado quando o parâmetro é definido no nível do item.
items Array<Item> Sim Itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo

view_promotion

Esse evento indica que uma promoção foi acessada em uma lista.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
creative_name string Não summer_banner2 Nome do criativo promocional.

Ignorado quando o parâmetro é definido no nível do item.
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao evento.

Ignorado quando o parâmetro é definido no nível do item.
promotion_id string Não P_12345 ID da promoção associada ao evento.

Ignorado quando o parâmetro é definido no nível do item.
promotion_name string Não Promoção de verão Nome da promoção associada ao evento.

Ignorado quando o parâmetro é definido no nível do item.
items Array<Item> Sim* Itens do evento.

* A matriz do parâmetro items precisa ter um único elemento que representa o item associado à promoção. Quando há vários elementos definidos, só o primeiro em items é usado.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
item_id string Sim* SKU_12345

ID do item.

*É preciso especificar item_id ou item_name.

item_name string Sim* Camiseta Stan and Friends

Nome do item.

*É preciso especificar item_id ou item_name.

affiliation string Não Google Store Uma afiliação de produto para indicar uma empresa fornecedora ou loja física.
Observação: "affiliation" está disponível apenas no escopo do item.
coupon string Não SUMMER_FUN Nome/código do cupom associado ao item.

Os parâmetros coupon no nível do evento e do item são independentes.
creative_name string Não summer_banner2 Nome do criativo promocional.

Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot string Não featured_app_1 Nome do slot do criativo promocional associado ao item.

Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount number Não 2,22 Valor do desconto monetário unitário associado ao item.
index number Não 5 Índice/posição do item em uma lista.
item_brand string Não Serviços Marca do item.
item_category string Não Vestuário Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2 string Não Adulto Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3 string Não Camisas Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4 string Não Gola redonda Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5 string Não Manga curta Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id string Não related_products ID da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.

Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant string Não verde Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id string Não ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado.
Observação: "location id" está disponível apenas no escopo do item.
price number Não 10,01 Preço unitário do item, em unidades do parâmetro de moeda especificado.
Se um desconto se aplicar ao item, defina price como o preço unitário com desconto e especifique o desconto no preço unitário no parâmetro discount.
promotion_id string Não P_12345 ID da promoção associada ao item.

Se definido, o parâmetro promotion_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name string Não Promoção de verão Nome da promoção associada ao item.

Se definido, o parâmetro promotion_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity number Não 3

Quantidade do item.

Se não for definido, quantity vai usar o valor "1".

Além dos parâmetros prescritos, você pode incluir até 27 parâmetros personalizados na matriz items.

Exemplo