Eventos

add_payment_info

Esse evento indica que um usuário enviou as informações de pagamento.

Parâmetros

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

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 29,98 O valor monetário do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'add_to_cart', {
  currency: 'USD',
  items: [{
    id: "P12345",
    name: "Android Warhol T-Shirt",
    brand: "Google",
    category: "Apparel/T-Shirts",
    coupon: "SUMMER_DISCOUNT",
    list_name: "Search Results",
    list_position: 1,
    price: 14.99,
    quantity: 2,
    variant: "Black"
  }],
  value: 29.98
});

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 22 O valor monetário do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'add_to_wishlist', {
  currency: 'USD',
  items: [{
    id: "P12345",
    name: "Android Warhol T-Shirt",
    brand: "Google",
    category: "Apparel/T-Shirts",
    coupon: "SUMMER_DISCOUNT",
    list_name: "Search Results",
    list_position: 1,
    price: 14.99,
    quantity: 2,
    variant: "Black"
  }],
  value: 29.98
});

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
coupon string Não SUMMER_FUN Código do cupom usado em uma compra.
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 29,98 O valor monetário do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag("event", "begin_checkout", {
  value: 29.98,
  coupon: "SUMMER_DISCOUNT",
  currency: "USD",
  items: [
    {
      id: "P12345",
      name: "Android Warhol T-Shirt",
      list_name: "Search Results",
      brand: "Google",
      category: "Apparel/T-Shirts",
      coupon: "SUMMER_DISCOUNT",
      variant: "Black",
      list_position: 1,
      quantity: 2,
      price: 14.99
    }
  ]
});

checkout_progress

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
coupon string Não PROMO_VERAO 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.
checkout_option string Não Google Pay Forma de pagamento selecionada.
checkout_step number Não 1 Um número que representa uma etapa no processo de finalização da compra.
value number Não 22 O valor monetário do evento, em unidades do parâmetro de moeda especificado.
items Array<Item> Não Os itens do evento.

Parâmetros de item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag("event", "checkout_progress", {
  coupon: "SUMMER_DISCOUNT",
  currency: "USD",
  checkout_option: "Google Pay",
  checkout_step: 1,
  value: 29.98,
  items: [
    {
      id: "P12345",
      name: "Android Warhol T-Shirt",
      brand: "Google",
      category: "Apparel/T-Shirts",
      coupon: "SUMMER_DISCOUNT",
      list_name: "Search Results",
      list_position: 1,
      price: 14.99,
      quantity: 2,
      variant: "Black"
    }
  ]
});

exception

Um evento "exception" é registrado quando o fluxo normal da execução de um app é interrompido.

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
description string Não Há um campo obrigatório em branco. Descrição da exceção que ocorreu.
fatal boolean Não true Se a exceção era ou não fatal.

Exemplo

gtag('event', 'exception', {
  description: 'Missing required field.',
  fatal: true
});

generate_lead

Registre esse evento quando um lead for gerado para entender a eficácia das suas campanhas de reengajamento.

Nome Tipo Obrigatório Valor de exemplo Descrição
currency string Não USD A moeda do lead no formato ISO 4217 de três letras.
value string Não 99,99 O valor do lead.

Exemplo

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

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'
});

page_view

Este evento indica que um usuário viu uma página.

Nome Tipo Obrigatório Valor de exemplo Descrição
page_location string Não https://example.com URL da página.
page_path string Não /about Caminho para a página. Esse valor precisa começar com /.
page_title string Não Sobre O título da página.

Exemplo

gtag('event', 'page_view', {
  page_location: 'https://example.com/about',
  page_path: '/about',
  page_title: 'About'
});

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
affiliation string Não Google Store Uma afiliação de produto para designar uma empresa fornecedora ou loja física.
coupon string Não PROMO_VERAO 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.
shipping number Não 5,99 Custo do frete associado a uma transação.
tax number Não 2,43 Custo dos tributos associados a uma transação.
transaction_id string Não T12345 Identificador exclusivo de uma transação.
value number Não 22 O valor monetário do evento em unidades do parâmetro de moeda especificado.
items Array<Item> Não Os itens do evento.

Parâmetros de item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag("event", "purchase", {
  affiliation: "Google online store",
  coupon: "SUMMER_DISCOUNT",
  currency: "USD",
  shipping: 5.55,
  tax: 3.33,
  transaction_id: "T_1",
  value: 28.86,
  items: [
    {
      id: "P12345",
      name: "Android Warhol T-Shirt",
      coupon: "P12345_coupon",
      list_name: "Search Results",
      brand: "Google",
      category: "Apparel/T-Shirts",
      variant: "Black",
      list_position: 3,
      quantity: 1,
      price: 9.99
    },
    {
      id: "P12346",
      name: "Flame challenge TShirt",
      coupon: "P12346_coupon",
      list_name: "Search Results",
      brand: "MyBrand",
      category: "Apparel/T-Shirts",
      variant: "Red",
      list_position: 5,
      quantity: 1,
      price: 9.99
    }
  ]
});

refund

Esse evento indica que um reembolso foi emitido.

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.
shipping number Não 5,99 Custo do frete associado a uma transação.
tax number Não 2,43 Custo dos tributos associados a uma transação.
transaction_id string Não T12345 Identificador exclusivo de uma transação.
value number Não 22 O valor monetário do evento em unidades do parâmetro de moeda especificado.
items Array<Item> Não Os itens do evento.

Parâmetros de item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'refund', {
  coupon: "SUMMER_DISCOUNT",
  currency: "USD",
  shipping: 5.55,
  tax: 3.33,
  transaction_id: "T_1",
  value: 9.99 + 9.99 + 3.33 + 5.55,
  items: [
    {
      id: "P12345",
      coupon: "P12345_coupon",
      name: "Android Warhol T-Shirt",
      list_name: "Search Results",
      brand: "Google",
      category: "Apparel/T-Shirts",
      variant: "Black",
      list_position: 3,
      quantity: 1,
      price: 9.99
    },
    {
      id: "P12346",
      coupon: "P12346_coupon",
      name: "Flame challenge TShirt",
      list_name: "Search Results",
      brand: "MyBrand",
      category: "Apparel/T-Shirts",
      variant: "Red",
      list_position: 5,
      quantity: 1,
      price: 9.99
    }
  ]
});

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 29,98 O valor monetário do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'remove_from_cart', {
  currency: 'USD',
  items: [{
    id: "P12345",
    name: "Android Warhol T-Shirt",
    brand: "Google",
    category: "Apparel/T-Shirts",
    coupon: "SUMMER_DISCOUNT",
    list_name: "Search Results",
    list_position: 1,
    price: 14.99,
    quantity: 2,
    variant: "Black"
  }],
  value: 29.98
});

screen_view

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
screen_name string Não Sobre Nome da tela.

Exemplo

gtag('event', 'screen_view', {
  screen_name: 'About'
});

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.
items Array<Item> Não Os itens do evento. Envie somente items ou promotions.
promotions Array<Promotion> Não As promoções do evento. Envie somente items ou promotions.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Parâmetros da promoção

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P_12345

ID da promoção.

*É preciso especificar id ou name.
name string Sim* Promoção de verão

Nome da promoção.

*É preciso especificar id ou name.
creative_name string Não summer_banner_2 O nome do criativo.
creative_slot string Não banner_slot_1 O nome do slot do criativo.

Exemplo

Como enviar itens

gtag('event', 'select_content', {
  content_type: "product",
  items: [
    {
      id: "P12345",
      name: "Android Warhol T-Shirt",
      list_name: "Search Results",
      brand: "Google",
      category: "Apparel/T-Shirts",
      coupon: "SUMMER_SALE",
      variant: "Black",
      list_position: 1,
      quantity: 2,
      price: 2
    }
  ]
});

Como enviar promoções

gtag('event', 'select_content', {
  content_type: "product",
  promotions: [
    {
      id: 'P_12345' ,
      name: 'Summer Sale',
      creative_name: 'summer_banner_2',
      creative_slot: 'banner_slot_1'
    }
  ]
});

set_checkout_option

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
checkout_step number Não 1 Um número que representa uma etapa no processo de finalização da compra.
checkout_option string Não Google Pay Informações da opção de finalização de compra, como a forma de pagamento selecionada.
value number Não 3 O valor da opção de finalização da compra.

Exemplo

gtag('event', 'set_checkout_option', {
  checkout_step: 1,
  checkout_option: 'Google Pay',
  value: 3
});

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", {
  content_type: 'image',
  item_id: 'C_12345',
  method: 'Twitter'
});

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'
});

timing_complete

Parâmetros

Nome Tipo Obrigatório Valor de exemplo Descrição
name string Não load Um nome para identificar a variável que está sendo registrada.
value number Não 3549 O tempo decorrido em milissegundos para informar ao Google Analytics.

Exemplo

gtag("event", "timing_complete", {
  name: 'load',
  value: 3549
});

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
items Array<Item> Não Os itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'view_item', {
  items: [{
    id: "P12345",
    name: "Android Warhol T-Shirt",
    brand: "Google",
    category: "Apparel/T-Shirts",
    coupon: "SUMMER_DISCOUNT",
    list_name: "Search Results",
    list_position: 1,
    price: 14.99,
    quantity: 2,
    variant: "Black"
  }]
});

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 Valor de exemplo Descrição
items Array<Item> Não Os itens do evento.

Parâmetros do item

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P12345

O ID de um item.

*É preciso especificar id ou name.
name string Sim* Camiseta Android Warhol

O nome de um item.

*É preciso especificar id ou name.
brand string Não Google A marca do item.
category string Não Roupas/Camisetas

A categoria do item.

Use / como delimitador para especificar até cinco níveis de hierarquia.

coupon string Não PROMO_VERAO O código do cupom associado a um item.
list_name string Não Resultados da pesquisa O nome da lista em que o item foi exibido.
list_position number Não 1 A posição do item em uma lista ou conjunto.
price number Não 14,99 O preço do item.
quantity number Não 2 A quantidade do item.
variant string Não Preto A variante do item.

Exemplo

gtag('event', 'view_item_list', {
  items: [{
    id: "P12345",
    name: "Android Warhol T-Shirt",
    brand: "Google",
    category: "Apparel/T-Shirts",
    coupon: "SUMMER_DISCOUNT",
    list_name: "Search Results",
    list_position: 1,
    price: 14.99,
    quantity: 2,
    variant: "Black"
  }]
});

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
promotions Array<Promotion> Não As promoções do evento.

Parâmetros da promoção

Nome Tipo Obrigatório Valor de exemplo Descrição
id string Sim* P_12345

ID da promoção.

*É preciso especificar id ou name.
name string Sim* Promoção de verão

Nome da promoção.

*É preciso especificar id ou name.
creative_name string Não summer_banner_2 O nome do criativo.
creative_slot string Não banner_slot_1 O nome do slot do criativo.

Exemplo

gtag('event', 'view_promotion', {
  promotions: [{
    id: 'P_12345' ,
    name: 'Summer Sale',
    creative_name: 'summer_banner_2',
    creative_slot: 'banner_slot_1'
  }]
});

view_search_results

Registre esse evento quando os resultados de uma pesquisa forem exibidos aos usuários.

Parâmetros

Nome Tipo Obrigatório Exemplo Descrição
search_term string Não Roupas Termo usado na pesquisa.
items Array<Item> Não Os itens 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 da moeda especificada
currency string Não USD É a moeda, no formato ISO 4217 de três letras.

Exemplo

gtag('event', 'view_search_results', {
  search_term: 'Clothing'
});