Eventos

add_payment_info

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

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. * Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
payment_type	string	Não	Cartão de crédito	Forma de pagamento escolhida.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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 Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. * Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
shipping_tier	string	Não	Terrestre	Tipo de frete (por exemplo, Ground, Air, Next-day) selecionado para a entrega do item comprado.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

campaign_details

Use este evento para enviar os detalhes da campanha que serão usados em eventos futuros.

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
campaign_id	string	Não	google_1234	O ID da campanha.
campaign	string	Não	Summer_fun	O nome usado para identificar uma promoção ou campanha estratégica específica.
source	string	Não	google	A origem do tráfego da campanha (por exemplo, Google, e-mail etc.).
medium	string	Não	cpc	A mídia da campanha (por exemplo, e-mail, custo por clique etc.).
term	string	Não	summer+travel	O termo da campanha usado com a pesquisa paga para fornecer as palavras-chave dos anúncios.
content	string	Não	logolink	Conteúdo da campanha usado para testes A/B e anúncios com segmentação por conteúdo para diferenciar anúncios ou links que direcionam ao mesmo URL.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

earn_virtual_currency

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

Parâmetros

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

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

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. * Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

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

Parâmetros

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

Parâmetros

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
transaction_id	string	Sim	T_12345	Identificador exclusivo de uma transação. O parâmetro transaction_id evita duplicar eventos de uma compra.
value	number	Sim*	12,21	Valor monetário do evento. * O parâmetro value é necessário para gerar relatórios importantes e preencher o público-alvo preditivo dos compradores. * O parâmetro currency é obrigatório quando você define value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
shipping	number	Não	3,33	Custo de frete associado a uma transação.
tax	number	Não	1,11	Custo dos tributos associados a uma transação.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 12.21,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

refund

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

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
currency	string	Sim*	USD	Moeda dos itens associados ao evento, no formato ISO 4217 de três letras. * Se você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
transaction_id	string	Sim	T_12345	Identificador exclusivo de uma transação.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
shipping	number	Não	3,33	Custo de frete associado a uma transação.
tax	number	Não	1,11	Custo dos tributos associados a uma transação.
items	Array<Item>	Não*		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 12.21,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

search

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

Parâmetros

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

Parâmetros

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_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. Ignorado quando o parâmetro é definido no nível do item.
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item.
items	Array<Item>	Sim*		Itens do evento. * A matriz do parâmetro items precisa ter um único elemento que representa o item selecionado. Quando há vários elementos definidos, só o primeiro em items é usado.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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. Ignorado quando o parâmetro é definido no nível do item.
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao evento. Ignorado quando o parâmetro é definido no nível do item.
promotion_id	string	Não	P_12345	ID da promoção associada ao evento. Ignorado quando o parâmetro é definido no nível do item.
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao evento. Ignorado quando o parâmetro é definido no nível do item.
items	Array<Item>	Não		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "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	Pedras preciosas	Nome da moeda virtual.
item_name	string	Não	Incentivo para iniciantes	Nome do item em que a moeda virtual está sendo usada.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "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 sugeridos para esse evento.

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "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.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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 você definir value, será necessário usar o parâmetro currency para que as métricas de receita sejam calculadas corretamente.
value	number	Sim*	7,77	Valor monetário do evento. * O parâmetro value costuma ser necessário para gerar relatórios importantes. Se você marca o evento como uma conversão, é recomendável definir value. * O parâmetro currency é obrigatório quando você define value.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "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. Ignorado quando o parâmetro é definido no nível do item.
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item.
items	Array<Item>	Sim		Itens do evento.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

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

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Ignorado quando o parâmetro é definido no nível do item.
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao evento. Ignorado quando o parâmetro é definido no nível do item.
promotion_id	string	Não	P_12345	ID da promoção associada ao evento. Ignorado quando o parâmetro é definido no nível do item.
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao evento. Ignorado quando o parâmetro é definido no nível do item.
items	Array<Item>	Sim*		Itens do evento. * A matriz do parâmetro items precisa ter um único elemento que representa o item associado à promoção. Quando há vários elementos definidos, só o primeiro em items é usado.

Parâmetros do item

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
item_id	string	Sim*	SKU_12345	ID do item. *É preciso especificar item_id ou item_name.
item_name	string	Sim*	Camiseta Stan and Friends	Nome do item. *É preciso especificar item_id ou item_name.
affiliation	string	Não	Google Store	Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item.
coupon	string	Não	SUMMER_FUN	Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
creative_name	string	Não	summer_banner2	Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente).
creative_slot	string	Não	featured_app_1	Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado. Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente).
discount	number	Não	2,22	Valor do desconto monetário 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. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria.
item_category2	string	Não	Adulto	Hierarquia da segunda categoria ou taxonomia adicional do item.
item_category3	string	Não	Camisas	Hierarquia da terceira categoria ou taxonomia adicional do item.
item_category4	string	Não	Gola redonda	Hierarquia da quarta categoria ou taxonomia adicional do item.
item_category5	string	Não	Manga curta	Hierarquia da quinta categoria ou taxonomia adicional do item.
item_list_id	string	Não	related_products	ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
item_list_name	string	Não	Produtos relacionados	Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
item_variant	string	Não	verde	Variante, código exclusivo ou descrição do item para detalhes/opções adicionais.
location_id	string	Não	ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco)	O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item.
price	number	Não	9,99	Valor monetário do item em unidades do parâmetro de moeda especificado.
promotion_id	string	Não	P_12345	ID da promoção associada ao item. Se definido, o parâmetro promotion_id no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_id no nível do evento (quando presente).
promotion_name	string	Não	Promoção de verão	Nome da promoção associada ao item. Se definido, o parâmetro promotion_name no nível do evento é ignorado. Se não foi definido, é usado o parâmetro promotion_name no nível do evento (quando presente).
quantity	number	Não	1	Quantidade do item. Se não for definido, quantity vai usar o valor "1".

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

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "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": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

Registre esse evento quando os resultados de uma pesquisa aparecerem para o usuário. Você pode ativar o evento "view_search_results" para a coleta automática com a Medição otimizada de eventos no Google Analytics.

Parâmetros

Nome	Tipo	Obrigatório	Valor de exemplo	Descrição
search_term	string	Não	Roupas	Termo usado na pesquisa.

Enviar evento

Use este evento no Criador de eventos do GA4

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});