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 artigo para conferir os parâmetros obrigatórios e opcionais de cada evento.
add_payment_info
Esse evento indica que um usuário enviou as informações de pagamento.
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
Exemplo
add_shipping_info
Esse evento indica que um usuário enviou as informações de frete.
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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 |
O nível 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
Exemplo
earn_virtual_currency
Esse evento mede a concessão de moeda virtual. 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
Registre esse evento quando um lead for gerado para entender a eficácia das suas campanhas de reengajamento.
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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
Esse evento indica que um jogador chegou ao fim de um nível.
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.
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. Use-o 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.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
method |
string |
Não | 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.
|
transaction_id |
string |
Sim | T_12345 | Identificador exclusivo de uma transação. O parâmetro transaction_id evita duplicar eventos de uma compra. |
value |
number |
Sim* | 12,21 | Valor monetário do evento. * O parâmetro value é necessário para gerar relatórios importantes e preencher o público-alvo preditivo dos compradores.
* 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> |
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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
Exemplo
search
Registre esse evento para indicar quando o usuário realizou uma pesquisa. Você pode usar esse evento para contextualizar as operações de pesquisa e 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 visualiza uma página depois de fazer 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
Esse evento indica que um usuário selecionou conteúdo de um determinado tipo. Esse evento pode ajudar você a identificar conteúdos e categorias de conteúdo em alta no 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 do conteúdo que foi 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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 |
Código 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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 | Método de compartilhamento do conteúdo. | |
content_type |
string |
Não | image | 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 | 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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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* | 7,77 | Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marca 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |
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 |
Código 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
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 associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | 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 | 9,99 | O preço monetário do item em unidades do parâmetro de moeda especificado. |
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 | 1 |
Quantidade do item. |