O Google Analytics envia alguns tipos de evento automaticamente. Esta página descreve eventos adicionais opcionais que você pode configurar para medir o comportamento dos usuários e gerar relatórios mais úteis para sua empresa. Esses recursos É mais fácil configurar eventos desse tipo antes de usar. Por isso, o Google Ele não pode ser enviado automaticamente pelo Google Analytics 4. Para instruções detalhadas para configurar eventos recomendados e personalizados para seu site ou app, consulte Configurar eventos.
Para ver os detalhes de cada evento, selecione sua plataforma de gerenciamento de tags:
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
|
payment_type |
string |
Não | Cartão de crédito | Forma de pagamento escolhida. |
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
add_payment_info
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Cupom de e-commerce:
ecommerce.coupon
- Tipo de pagamento de e-commerce:
ecommerce.payment_type
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}coupon
– {{Cupom de e-commerce}}payment_type
– {{Tipo de pagamento de e-commerce}}- Acionador: "event" é igual a "add_payment_info"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
add_payment_info
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_payment_info",
ecommerce: {
currency: "USD",
value: 30.03,
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",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é 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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
add_shipping_info
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Cupom de e-commerce:
ecommerce.coupon
- Tipo de frete de e-commerce:
ecommerce.shipping_tier
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}coupon
– {{Cupom de e-commerce}}shipping_tier
- {{Nível de frete de e-commerce}}- Acionador: "event" é igual a "add_shipping_info"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
add_shipping_info
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_shipping_info",
ecommerce: {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
shipping_tier: "Ground",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
add_to_cart
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}- Acionador: "event" é igual a "add_to_cart"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
add_to_cart
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_to_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
add_to_wishlist
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}- Acionador: "event" é igual a "add_to_wishlist"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
add_to_wishlist
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "add_to_wishlist",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
begin_checkout
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Cupom de e-commerce:
ecommerce.coupon
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}coupon
– {{Cupom de e-commerce}}- Acionador: "event" é igual a "begin_checkout"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
begin_checkout
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "begin_checkout",
ecommerce: {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
close_convert_lead
Este evento mede quando um lead foi convertido e fechado (por exemplo, em uma 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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
close_convert_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03items
– {{Itens de e-commerce}}- Acionar o evento quando o usuário se tornar um lead convertido (um cliente)
close_unconvert_lead
Esse evento mede quando um usuário é marcado como não se tornando um lead convertido, junto com o motivo.
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
unconvert_lead_reason |
string |
Não | Nunca respondeu | Motivo pelo qual o lead não foi convertido. |
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
close_unconvert_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03items
– {{Itens de e-commerce}}- Acionar o evento quando um usuário for marcado como não se tornando um lead convertido por uma das várias razões
disqualify_lead
Esse evento determina quando um usuário é marcado como desqualificado para se tornar um lead junto com o motivo da desqualificação.
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
disqualified_lead_reason |
string |
Não | Não quero comprar | O motivo pelo qual um lead foi marcado como desqualificado. |
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
disqualify_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03disqualified_lead_reason
- Não quero compraritems
– {{Itens de e-commerce}}- Acionar o evento quando um usuário for marcado como desqualificado para se tornar um lead por uma das várias razões
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. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
earn_virtual_currency
- Parâmetros de evento (Nome do parâmetro - Valor):
virtual_currency_name
: pedras preciosasvalue
a 5- Acionar o evento quando alguém receber uma moeda virtual
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
lead_source |
string |
Não | Feira comercial | A origem do lead. |
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
generate_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03lead_source
- Feira de negóciositems
– {{Itens de e-commerce}}- Acionar o evento quando um lead for gerado
join_group
Registre esse evento quando um usuário entrar em um grupo, como uma associação, equipe ou família. Use esse evento para analisar a popularidade de determinados grupos ou recursos sociais.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
group_id |
string |
Não | G_12345 | ID do grupo. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
join_group
- Parâmetros de evento (Nome do parâmetro - Valor):
group_id
: G_12345- Acionar o evento quando um usuário entrar em um grupo
level_end
Este evento indica que um jogador chegou ao final de um nível em um jogo.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
level_name |
string |
Não | O início da jornada... | Nome do nível. |
success |
boolean |
Não | true | Defina como true se o nível tiver sido concluído. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
level_end
- Parâmetros de evento (Nome do parâmetro - Valor):
level_name
: a jornada começa...- success - true
- Acionar quando um jogador chegar ao fim de um nível (por exemplo, a página de confirmação do nível)
level_start
Esse evento indica que um jogador iniciou um nível em um jogo.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
level_name |
string |
Não | O início da jornada... | Nome do nível. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
level_start
- Parâmetros de evento (Nome do parâmetro - Valor):
level_name
: a jornada começa...- Acionar quando alguém iniciar um outro nível (por exemplo, a página inicial do nível)
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. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
level_up
- Parâmetros de evento (Nome do parâmetro - Valor):
level
a 5character
- Jogador 1- Acionar quando um jogador passar de nível
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 | Método usado para fazer login. |
Exemplo
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
login
- Parâmetros de evento (Nome do parâmetro - Valor):
method
- Google- Acionar quando um usuário fizer login
post_score
Envie esse evento quando o usuário registrar uma pontuação. Use esse evento para entender o desempenho dos usuários no seu jogo e correlacionar as maiores pontuações com os públicos-alvo ou comportamentos.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
score |
number |
Sim | 10.000 | Pontuação que será registrada. |
level |
number |
Não | 5 | Nível da pontuação. |
character |
string |
Não | Jogador 1 | Personagem que conseguiu a pontuação. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
post_score
- Parâmetros de evento (Nome do parâmetro - Valor):
score
– 10.000level
a 5character
- Jogador 1- Acionar quando o usuário postar uma pontuação
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.
|
value |
number |
Sim* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
transaction_id |
string |
Sim | T_12345 | Identificador exclusivo de uma transação. O parâmetro transaction_id evita duplicar eventos de uma compra. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
|
shipping |
number |
Não | 3,33 | Custo de frete associado a uma transação. |
tax |
number |
Não | 1,11 | Custo dos tributos associados a uma transação. |
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
purchase
- Itens de e-commerce:
ecommerce.items
- ID da transação de e-commerce:
ecommerce.transaction_id
- Valor de e-commerce:
ecommerce.value
- Tributo de e-commerce:
ecommerce.tax
- Frete de e-commerce:
ecommerce.shipping
- Moeda de e-commerce:
ecommerce.currency
- Cupom de e-commerce:
ecommerce.coupon
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}transaction_id
– {{ID da transação de e-commerce}}value
– {{Valor de e-commerce}}tax
– {{Taxa de e-commerce}}shipping
– {{Envio de e-commerce}}currency
– {{Moeda de e-commerce}}coupon
– {{Cupom de e-commerce}}- Acionador: "event" é igual a "purchase"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
purchase
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "purchase",
ecommerce: {
transaction_id: "T_12345",
// Sum of (price * quantity) for all items.
value: 72.05,
tax: 3.60,
shipping: 5.99,
currency: "USD",
coupon: "SUMMER_SALE",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
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: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
promotion_id: "P_12345",
promotion_name: "Summer Sale",
quantity: 2
}]
}
});
qualify_lead
Esse evento determina quando um usuário é marcado como atendendo aos critérios para se tornar lead qualificado.
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
qualify_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03items
– {{Itens de e-commerce}}- Acionar o evento quando um usuário for marcado como atendendo aos critérios para se tornar um lead qualificado
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao evento. Os parâmetros coupon no nível do evento e do item são independentes.
|
shipping |
number |
Não | 3,33 | Custo de frete associado a uma transação. |
tax |
number |
Não | 1,11 | Custo dos tributos associados a uma transação. |
items |
Array<Item>
|
Não* | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
refund
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- ID da transação de e-commerce:
ecommerce.transaction_id
- Valor de e-commerce:
ecommerce.value
- Tributo de e-commerce:
ecommerce.tax
- Frete de e-commerce:
ecommerce.shipping
- Moeda de e-commerce:
ecommerce.currency
- Cupom de e-commerce:
ecommerce.coupon
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}transaction_id
– {{ID da transação de e-commerce}}value
– {{Valor de e-commerce}}tax
– {{Taxa de e-commerce}}shipping
– {{Envio de e-commerce}}currency
– {{Moeda de e-commerce}}coupon
– {{Cupom de e-commerce}}- Acionador: "event" é igual a "refund"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
refund
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "refund",
ecommerce: {
currency: "USD",
transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
value: 30.03,
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",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
remove_from_cart
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}- Acionador: "event" é igual a "remove_from_cart"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
remove_from_cart
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "remove_from_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
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. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
search
- Parâmetros de evento (Nome do parâmetro - Valor):
search_term
- camisetas- Acionar quando um usuário pesquisar no seu site
select_content
Esse evento indica que um usuário selecionou conteúdo de um 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. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
select_content
- Parâmetros de evento (Nome do parâmetro - Valor):
content_type
– produtocontent_id
: C_12345- Acionador: "event" é igual a "select_content"
select_item
Esse evento indica que um item foi selecionado em uma lista.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item. |
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item. |
items |
Array<Item> |
Sim* | Itens do evento. * A matriz do parâmetro items precisa ter um único elemento que representa o item selecionado. Quando há vários elementos definidos, só o primeiro em items é usado.
|
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
select_item
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- ID da lista de itens de e-commerce:
ecommerce.item_list_id
- Nome da lista de itens de e-commerce:
ecommerce.item_list_name
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}item_list_id
– {{ID da lista de itens de e-commerce}}item_list_name
– {{Nome da lista de itens de e-commerce}}- Acionador: "event" é igual a "select_item"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
select_item
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "select_item",
ecommerce: {
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",
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: 10.01,
quantity: 3
}
]
}
});
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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
creative_name |
string |
Não | summer_banner2 | Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente). |
creative_slot |
string |
Não | featured_app_1 | Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente). |
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
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 | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Nome do criativo de e-commerce:
ecommerce.creative_name
- Slot do criativo de e-commerce:
ecommerce.creative_slot
- ID da promoção de e-commerce:
ecommerce.promotion_id
- Nome da promoção de e-commerce:
ecommerce.promotion_name
- Itens de e-commerce:
ecommerce.items
- Parâmetros de evento (Nome do parâmetro - Valor):
creative_name
– {{Nome do criativo de e-commerce}}creative_slot
– {{Slot de criativo de e-commerce}}promotion_id
– {{ID da promoção de e-commerce}}promotion_name
– {{Nome da promoção de e-commerce}}items
– {{Itens de e-commerce}}- Tipo de variável: camada de dados – 'ecommerce.items'
- Acionador: "event" é igual a "select_promotion"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
select_promotion
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "select_promotion",
ecommerce: {
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",
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: 10.01,
quantity: 3
}
]
}
});
share
Use esse evento quando um usuário compartilhar conteúdo.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
method |
string |
Não | Método de compartilhamento do conteúdo. | |
content_type |
string |
Não | imagem | Tipo de conteúdo compartilhado. |
item_id |
string |
Não | C_12345 | ID do conteúdo compartilhado. |
Exemplo
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
share
- Parâmetros de evento (Nome do parâmetro - Valor):
method
: Twittercontent_type
: imagemitem_id
: C_12345- Acionar quando um usuário compartilhar conteúdo
sign_up
Esse evento indica que um usuário se inscreveu em uma conta. Use o evento para entender os diferentes comportamentos de usuários conectados e desconectados.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
method |
string |
Não | Método usado para inscrição. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
sign_up
- Parâmetros de evento (Nome do parâmetro - Valor):
method
- Google- Acionar quando um usuário se inscrever em uma conta
spend_virtual_currency
Esse evento mede a venda de produtos virtuais no seu app e ajuda você a identificar os itens mais procurados.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
value |
number |
Sim | 5 | Valor da moeda virtual. |
virtual_currency_name |
string |
Sim | Pedras preciosas | Nome da moeda virtual. |
item_name |
string |
Não | Incentivo para iniciantes | Nome do item em que a moeda virtual está sendo usada. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
spend_virtual_currency
- Parâmetros de evento (Nome do parâmetro - Valor):
value
a 5virtual_currency_name
: pedras preciosasitem_name
: incentivo para iniciantes- Acionar quando alguém comprar um produto virtual
tutorial_begin
Esse evento indica o início do processo de integração. Use-o em um funil com tutorial_complete para entender quantos usuários concluem o tutorial.
Parâmetros
Não há parâmetros para esse evento.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
tutorial_begin
- Acionar quando alguém iniciar o processo de integração
tutorial_complete
Esse evento indica a conclusão do processo de integração do usuário. Utilize-o em um funil com tutorial_begin para entender quantos usuários concluem o tutorial.
Parâmetros
Não há parâmetros sugeridos para esse evento.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
tutorial_complete
- Acionar quando alguém concluir o processo de integração
unlock_achievement
Registre esse evento quando o usuário desbloquear uma conquista. O evento ajuda você a entender como os usuários estão explorando seu jogo.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
achievement_id |
string |
Sim | A_12345 | ID da conquista que foi desbloqueada. |
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
unlock_achievement
- Parâmetros de evento (Nome do parâmetro - Valor):
achievement_id
: A_12345- Acionar quando um usuário desbloquear uma conquista
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
view_cart
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}- Acionador: "event" é igual a "view_cart"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
view_cart
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_cart",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
view_item
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- Valor de e-commerce:
ecommerce.value
- Moeda de e-commerce:
ecommerce.currency
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}value
– {{Valor de e-commerce}}currency
– {{Moeda de e-commerce}}- Acionador: "event" é igual a "view_item"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
view_item
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_item",
ecommerce: {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
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: 10.01,
quantity: 3
}
]
}
});
view_item_list
Registre esse evento quando uma lista de itens de uma determinada categoria for exibida para o usuário.
Parâmetros
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item. |
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Ignorado quando o parâmetro é definido no nível do item. |
items |
Array<Item> |
Sim | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
view_item_list
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Itens de e-commerce:
ecommerce.items
- ID da lista de itens de e-commerce:
ecommerce.item_list_id
- Nome da lista de itens de e-commerce:
ecommerce.item_list_name
- Parâmetros de evento (Nome do parâmetro - Valor):
items
– {{Itens de e-commerce}}item_list_id
– {{ID da lista de itens de e-commerce}}item_list_name
– {{Nome da lista de itens de e-commerce}}- Acionador: "event" é igual a "view_item_list"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
view_item_list
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_item_list",
ecommerce: {
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",
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: 10.03,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
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: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
promotion_id: "P_12345",
promotion_name: "Summer Sale",
quantity: 2
}]
}
});
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_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
creative_name |
string |
Não | summer_banner2 | Nome do criativo promocional. Se definido, o parâmetro creative_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_name no nível do evento (quando presente). |
creative_slot |
string |
Não | featured_app_1 | Nome do slot do criativo promocional associado ao item. Se definido, o parâmetro creative_slot no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro creative_slot no nível do evento (quando presente). |
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
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 | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
view_promotion
- Variáveis da camada de dados (Nome: nome da variável da camada de dados):
- Nome do criativo de e-commerce:
ecommerce.creative_name
- Slot do criativo de e-commerce:
ecommerce.creative_slot
- ID da promoção de e-commerce:
ecommerce.promotion_id
- Nome da promoção de e-commerce:
ecommerce.promotion_name
- Itens de e-commerce:
ecommerce.items
- Parâmetros de evento (Nome do parâmetro - Valor):
creative_name
– {{Nome do criativo de e-commerce}}creative_slot
– {{Slot de criativo de e-commerce}}promotion_id
– {{ID da promoção de e-commerce}}promotion_name
– {{Nome da promoção de e-commerce}}items
– {{Itens de e-commerce}}- Acionador: "event" é igual a "view_promotion"
Configuração do acionador:
- Tipo de acionador: evento personalizado
- Nome do evento:
view_promotion
- Este acionador é disparado em: todos os eventos personalizados
dataLayer.push({ ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_promotion",
ecommerce: {
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",
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: 10.01,
quantity: 3
}
]
}
});
working_lead
Este evento mede quando um usuário entra em contato ou é contatado por um representante.
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* | 30,03 | Valor monetário do evento. * Defina value como a soma de (price * quantity) para todos os itens em
items . Não inclua shipping nem tax .
* O parâmetro value costuma ser necessário para gerar relatórios importantes.
Se você marcar
o evento como uma conversão, é recomendável definir
value
* O parâmetro currency é obrigatório quando você define value .
|
lead_status |
string |
Não | Conversas iniciadas | O status do lead. |
items |
Array<Item>
|
Não | Itens do evento. |
Parâmetros do item
Nome | Tipo | Obrigatório | Valor de exemplo | Descrição |
---|---|---|---|---|
item_id |
string |
Sim* | SKU_12345 |
ID do item.
*É preciso especificar |
item_name |
string |
Sim* | Camiseta Stan and Friends |
Nome do item.
*É preciso especificar |
affiliation |
string |
Não | Google Store |
Uma afiliação de produto para indicar uma empresa fornecedora ou loja física. Observação: "affiliation" está disponível apenas no escopo do item. |
coupon |
string |
Não | SUMMER_FUN | Nome/código do cupom associado ao item. Os parâmetros coupon no nível do evento e do item são independentes.
|
discount |
number |
Não | 2,22 | Valor do desconto monetário unitário associado ao item. |
index |
number |
Não | 5 | Índice/posição do item em uma lista. |
item_brand |
string |
Não | Marca do item. | |
item_category |
string |
Não | Vestuário | Categoria do item. Quando usada como parte de uma hierarquia de categorias ou taxonomia, é a primeira categoria. |
item_category2 |
string |
Não | Adulto | Hierarquia da segunda categoria ou taxonomia adicional do item. |
item_category3 |
string |
Não | Camisas | Hierarquia da terceira categoria ou taxonomia adicional do item. |
item_category4 |
string |
Não | Gola redonda | Hierarquia da quarta categoria ou taxonomia adicional do item. |
item_category5 |
string |
Não | Manga curta | Hierarquia da quinta categoria ou taxonomia adicional do item. |
item_list_id |
string |
Não | related_products | ID da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_id no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_id no nível do evento (quando presente).
|
item_list_name |
string |
Não | Produtos relacionados | Nome da lista em que o item foi apresentado ao usuário. Se definido, o parâmetro item_list_name no nível do evento é ignorado.
Se não foi definido, é usado o parâmetro item_list_name no nível do evento (quando presente).
|
item_variant |
string |
Não | verde | Variante, código exclusivo ou descrição do item para detalhes/opções adicionais. |
location_id |
string |
Não | ChIJIQBpAG2ahYAR_6128GcTUEo (o ID de lugar do Google para São Francisco) |
O local físico associado ao item, como a localização da filial da loja. É recomendável usar o ID de lugar do Google que corresponde ao item associado. Também é possível usar um ID de local personalizado. Observação: "location id" está disponível apenas no escopo do item. |
price |
number |
Não | 01/10 |
O preço unitário monetário do item, em unidades da moeda especificada
.
Se um desconto for aplicado ao item, defina price como o preço unitário com desconto e
especifique o desconto no preço unitário no parâmetro discount .
|
quantity |
number |
Não | 3 |
Quantidade do item. |
items
.
Exemplo
O exemplo a seguir é para implementações do Gerenciador de tags:
Mostrar a configuração da tag
Configuração da tag:
- Tipo de tag: evento do GA4
- Nome do evento:
working_lead
- Parâmetros de evento (Nome do parâmetro - Valor):
currency
: USDvalue
a 30/03lead_status
- Conversas iniciadasitems
– {{Itens de e-commerce}}- Acionar o evento quando um usuário entrar em contato ou for contatado por um representante