Eventos do Google Analytics 4

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "add_payment_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  payment_type: "Credit Card",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
shipping_tier	string	Não	Terrestre	Tipo de frete (por exemplo, Ground, Air, Next-day) selecionado para a entrega do item comprado.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "add_shipping_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  shipping_tier: "Ground",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "add_to_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "add_to_wishlist", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "begin_checkout", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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	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	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir value.

Exemplo

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

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

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	Valor de exemplo	Descrição
level_name	string	Não	O início da jornada...	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 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

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 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

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	Valor de 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	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

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	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas corretamente.
transaction_id	string	Sim	T_12345	Identificador exclusivo de uma transação.
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 será obrigatório se você definir value.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "purchase", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 21.09,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 2.22,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    },
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 7,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "black",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

refund

Esse evento indica que um reembolso foi emitido.

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir value.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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. * O parâmetro items é obrigatório para reembolsos parciais, mas pode ser omitido para reembolsos totais.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

Reembolso total

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11
});

Reembolso parcial

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "remove_from_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

search

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	Valor de exemplo	Descrição
search_term	string	Sim	camisetas	Termo que foi pesquisado.

Exemplo

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

select_content

Esse evento indica que um usuário selecionou 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
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Será ignorado se o parâmetro for 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. Será ignorado se o parâmetro for definido no nível do item.
items	Array<Item>	Sim*		Itens do evento. * A matriz de items precisa ter um único elemento que representa o item selecionado. Se vários elementos forem definidos, somente o primeiro em items será usado.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "select_item", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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. Será ignorado se o parâmetro for definido no nível do item.
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao evento. Será ignorado se o parâmetro for definido no nível do item.
location_id	string	Não	L_12345	Código do local. Será ignorado se o parâmetro for definido no nível do item.
promotion_id	string	Não	P_12345	Código da promoção associada ao evento. Será ignorado se o parâmetro for definido no nível do item.
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao evento. Será ignorado se o parâmetro for 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "select_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ],
});

share

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

Parâmetros

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

Exemplo

gtag("event", "share", {
  method: "Twitter",
  content_type: "image",
  item_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	Valor de 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 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	Pérolas	Nome da moeda virtual.
item_name	string	Não	Incentivo para iniciantes	Nome do item em que a moeda virtual está sendo usada.

Exemplo

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

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	Valor de 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 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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "view_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 definido, o parâmetro currency no nível do item será ignorado. Se não definido, a moeda do primeiro item no parâmetro items será usada. * Se você definir value, o parâmetro currency será necessário para que as métricas de receita sejam computadas 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ê marcar o evento como uma conversão, é recomendável definir value. * O parâmetro currency será obrigatório se você definir 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "view_item", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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. Será ignorado se o parâmetro for 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. Será ignorado se o parâmetro for 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	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "view_item_list", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Será ignorado se o parâmetro for definido no nível do item.
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao evento. Será ignorado se o parâmetro for definido no nível do item.
location_id	string	Não	L_12345	Código do local. Será ignorado se o parâmetro for definido no nível do item.
promotion_id	string	Não	P_12345	Código da promoção associada ao evento. Será ignorado se o parâmetro for definido no nível do item.
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao evento. Será ignorado se o parâmetro for definido no nível do item.
items	Array<Item>	Sim*		Itens do evento. * A matriz de items precisa ter um único elemento que representa o item associado à promoção. Se vários elementos forem definidos, somente o primeiro em items será usado.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	Código do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Os parâmetros affiliation no nível do evento e do item são independentes.
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.
currency	string	Não	USD	Moeda no formato ISO 4217 de três letras. Se definido, o parâmetro currency no nível do evento será ignorado. Não é possível usar várias moedas por evento. Todos os itens precisam ter a mesma moeda.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	Google	Marca do item.
item_category	string	Não	Vestuário	Categoria do item. Se usada como parte de uma hierarquia de categorias ou taxonomia, será 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	Equipe	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 será ignorado. Se não definido, será 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 será ignorado. Se não definido, será 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	L_12345	Local associado ao item. É recomendável usar o ID do lugar do Google que corresponde ao item associado. Também é possível utilizar um código de local personalizado. Se definido, o parâmetro location_id no nível do evento será ignorado. Se não definido, será usado o parâmetro location_id no nível do evento (quando presente).
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	Código da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento será ignorado. Se não definido, será 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 será ignorado. Se não definido, será usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item.

Exemplo

gtag("event", "view_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ]
});