Eventos App + Web

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
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
currency string (ISO 4217) Não USD Moeda da compra ou dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
payment_type string Não Cartão de crédito Forma de pagamento escolhida.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'add_payment_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  payment_type: 'Credit Card',
  value: 9.99
});

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
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
currency string (ISO 4217) Não USD Moeda da compra ou dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
shipping_tier string Não Terrestre O tipo de frete (por exemplo, Ground, Air, Next-day) selecionado para a entrega do item comprado.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'add_shipping_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  shipping_tier: 'Ground',
  value: 7.77
});

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 Não USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'add_to_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

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 Não USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'add_to_wishlist', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 9.99
});

begin_checkout

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

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
currency string (ISO 4217) Não USD Moeda da compra ou dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'begin_checkout', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

earn_virtual_currency

Esse evento avalia a concessão de moeda virtual. Registre-o com spend_virtual_currency para entender melhor sua economia virtual.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
virtual_currency_name string Não Pérolas Nome da moeda virtual.
value number Não 5 Valor da moeda virtual.

Exemplo

gtag('event', 'earn_virtual_currency', {
  virtual_currency_name: 'Gems',
  value: 5
});

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 Exemplo Descrição
currency string Não USD A moeda do lead no formato ISO 4217 de três letras.
value number Não 99,99 O valor do lead.
transaction_id string Não T_12345 ID da transação.

Exemplo

gtag('event', 'generate_lead', {
  currency: 'USD',
  value: 99.99,
  transaction_id: 'T_12345'
});

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 Exemplo Descrição
group_id string Não G_12345 ID do grupo.

Exemplo

gtag('event', 'join_group', {
  group_id: 'G_12345'
});

level_end

Esse evento indica que um jogador chegou ao fim de um nível.

Parâmetros

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

Exemplo

gtag('event', 'level_end', {
  level_name: 'The journey begins...',
  success: true,
});

level_start

Esse evento significa que um jogador iniciou um nível.

Parâmetros

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

Exemplo

gtag('event', 'level_start', {
  level_name: 'The journey begins...'
});

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 níveis difíceis de concluir.

Parâmetros

Nome Tipo Obrigatório 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

gtag('event', 'level_up', {
  level: 5,
  character: 'Player 1'
});

login

Envie esse evento para indicar que um usuário fez login.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
method string Não Google Método usado para fazer login.

Exemplo

gtag('event', 'login', {
  method: 'Google'
});

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 Exemplo Descrição
score number Sim 10000 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

gtag('event', 'post_score', {
  score: 10000,
  level: 5,
  character: 'Player 1'
});

purchase

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

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
currency string (ISO 4217) Não USD Moeda da compra ou dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
transaction_id string Não T_12345 Identificador exclusivo de uma transação.
shipping number Não 3,33 Custo do frete associado a uma transação.
tax number Não 1,11 Custo dos tributos associados a uma transação.
value number Não 12,21 O valor monetário do evento em unidades do parâmetro de moeda especificado.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'purchase', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
})

refund

Esse evento indica que um reembolso foi emitido.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
currency string (ISO 4217) Não USD Moeda da compra ou dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
transaction_id string Não T_12345 Identificador exclusivo de uma transação.
shipping number Não 3,33 Custo do frete associado a uma transação.
tax number Não 1,11 Custo dos tributos associados a uma transação.
value number Não 12,21 O valor monetário do evento em unidades do parâmetro de moeda especificado.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

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 Não USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'remove_from_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

Use esse evento para contextualizar as operações de pesquisa. Ele ajuda você a identificar o conteúdo em alta no seu app.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
search_term string Sim t-shirts O termo que foi pesquisado.

Exemplo

gtag('event', 'search', {
  search_term: 't-shirts'
});

select_content

Esse evento indica que um usuário selecionou algum conteúdo de um determinado tipo. O evento ajuda você a identificar conteúdo e categorias de conteúdo em alta no seu app.

Parâmetros

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

Exemplo

gtag('event', 'select_content', {
  content_type: 'product',
  item_id: 'I_12345'
});

select_item

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

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
items Array<Item> Não Os itens do evento.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'select_item', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: "Related Products",
    item_list_id: "IL_12345",
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

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
items Array<Item> Não Os itens do evento.
promotion_id string Não P_12345 ID de uma promoção de produto.
promotion_name string Não Promoção de verão Nome de uma promoção de produto.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'select_promotion', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    creative_slot: "featured_app_1",
    location_id: "L_12345",
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  promotion_id: "P_12345",
  promotion_name: "Summer Sale"
});

share

Use esse evento para identificar conteúdo viral.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
method string Não Twitter O método de compartilhamento do conteúdo.
content_type string Não imagem Tipo de conteúdo compartilhado.
content_id string Não C_12345 ID do conteúdo compartilhado.

Exemplo

gtag('event', 'share', {
  method: 'Twitter',
  content_type: 'image',
  content_id: 'C_12345',
});

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 Exemplo Descrição
method string Não Google Método usado para inscrição.

Exemplo

gtag('event', 'sign_up', {
  method: 'Google'
});

spend_virtual_currency

Esse evento avalia a venda de produtos virtuais no seu app e ajuda você a identificar quais são os itens mais procurados.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
item_name string Não Incentivo para iniciantes Nome do item para o qual a moeda virtual está sendo usada.
virtual_currency_name string Sim Pérolas Nome da moeda virtual.
value number Sim 5 Valor da moeda virtual.

Exemplo

gtag('event', 'spend_virtual_currency', {
  item_name: 'Starter Boost',
  virtual_currency_name: 'Gems',
  value: 5
});

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

gtag('event', 'tutorial_begin');

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

gtag('event', 'tutorial_complete');

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 Exemplo Descrição
achievement_id string Sim A_12345 ID da conquista que foi desbloqueada.

Exemplo

gtag('event', 'unlock_achievement', {
  achievement_id: 'A_12345'
});

view_cart

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

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Não USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'view_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

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 Exemplo Descrição
currency string Não USD Moeda dos itens associados ao evento, no formato ISO 4217 de três letras.
items Array<Item> Não Os itens do evento.
value number Não 7,77 O valor monetário do evento.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'view_item', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 9.99
});

view_item_list

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

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
items Array<Item> Não Os itens do evento.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'view_item_list', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: "Related Products",
    item_list_id: "IL_12345",
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

view_promotion

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

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
items Array<Item> Não Os itens do evento.
promotion_id string Não P_12345 ID de uma promoção de produto.
promotion_name string Não Promoção de verão Nome de uma promoção de produto.

Parâmetros do item

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

Código do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

item_name string Sim* jegging

Nome do item (específico do contexto).

*É preciso especificar item_id ou item_name para coletar dados do produto ou de impressões.

promotion_id string Sim* P_12345 ID de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
promotion_name string Sim* Promoção de verão Nome de uma promoção de produto. É preciso especificar promotion_id ou promotion name.
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
creative_name string Não summer_banner2 Nome do criativo usado em um espaço promocional.
creative_slot string Não featured_app_1 Nome do slot do criativo.
discount number Não 2,22 Valor monetário do desconto associado à compra.
index number Não 5 Índice do item em uma lista.
item_brand string Não Gucci Marca do item
item_category string Não calça Categoria do item (específica do contexto). Os valores de item_category2 a item_category5 também poderão ser usados se o item tiver muitas categorias.
item_list_name string Não Produtos relacionados Nome da lista em que o item foi apresentado ao usuário.
item_list_id string Não IL_12345 ID da lista em que o item foi apresentado ao usuário.
item_variant string Não Preto Variante do item
location_id string Não L_12345 Local associado ao evento. Preferencialmente, deve ser o código do lugar do Google que corresponde ao item associado, mas pode ser substituído por uma string personalizada de código do local.
tax number Não 1,11 Custo dos tributos associados a uma transação.
price number Não 9,99 O valor monetário do item em unidades do parâmetro de moeda especificado.
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'view_promotion', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    creative_slot: "featured_app_1",
    location_id: "L_12345",
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  promotion_id: "P_12345",
  promotion_name: "Summer Sale"
});