Google Analytics 4 invia alcuni tipi di eventi automaticamente. Questa pagina descrivono gli eventi aggiuntivi facoltativi che puoi configurare per misurare comportamenti e generare report più utili per la tua attività. Queste funzionalità aggiuntive la configurazione degli eventi richiede più impegno, quindi Google Analytics 4 non può inviarli automaticamente. Per istruzioni passo passo su come Per configurare gli eventi consigliati e personalizzati per il tuo sito web o la tua app, consulta l'articolo Configurare eventi.
Per visualizzare i dettagli di ogni evento che puoi utilizzare, seleziona la piattaforma di gestione dei tag:
add_payment_info
Questo evento indica che un utente ha inviato i propri dati di pagamento in un procedura di pagamento e-commerce.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
coupon |
string |
No | SUMMER_FUN | Nome/codice del coupon associato all'evento. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
payment_type |
string |
No | Carta di credito | Il metodo di pagamento scelto. |
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
add_payment_info
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Coupon e-commerce -
ecommerce.coupon
- Tipo di pagamento e-commerce -
ecommerce.payment_type
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}coupon
- {{Coupon e-commerce}}payment_type
- {{Tipo di pagamento e-commerce}}- Attivatore: evento uguale ad add_payment_info
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
add_payment_info
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento indica che un utente ha inviato i propri dati di spedizione in un procedura di pagamento e-commerce.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
coupon |
string |
No | SUMMER_FUN | Nome/codice del coupon associato all'evento. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
shipping_tier |
string |
No | Suolo |
Il livello di spedizione (ad es. Ground , Air ,
Next-day ) selezionati per la consegna dell'articolo acquistato.
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
add_shipping_info
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Coupon e-commerce -
ecommerce.coupon
- Livello di spedizione e-commerce -
ecommerce.shipping_tier
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}coupon
- {{Coupon e-commerce}}shipping_tier
- {{Livello di spedizione e-commerce}}- Attivatore: event è uguale ad add_shipping_info
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
add_shipping_info
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento indica che un articolo è stato aggiunto a un carrello per l'acquisto.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
add_to_cart
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}- Attivatore: evento uguale ad add_to_cart
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
add_to_cart
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
L'evento indica che un elemento è stato aggiunto a una lista desideri. Usa questo evento per identificare gli articoli regalo più popolari nella tua app.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
add_to_wishlist
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}- Attivatore: evento uguale ad add_to_wishlist
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
add_to_wishlist
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
L'evento indica che un utente ha avviato una procedura di pagamento.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
coupon |
string |
No | SUMMER_FUN | Nome/codice del coupon associato all'evento. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
begin_checkout
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Coupon e-commerce -
ecommerce.coupon
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}coupon
- {{Coupon e-commerce}}- Attivazione: evento uguale a start_checkout
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
begin_checkout
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento misura quando un lead è stato convertito e chiuso (ad esempio tramite un acquisto).
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
close_convert_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03items
- {{Articoli e-commerce}}- Attivano l'evento quando l'utente è diventato un lead convertito (un cliente).
close_unconvert_lead
Questo evento misura quando un utente è contrassegnato come non lead convertito, insieme al motivo.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
unconvert_lead_reason |
string |
No | Non ho mai risposto | Il motivo per cui il lead non è stato convertito. |
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
close_unconvert_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03items
- {{Articoli e-commerce}}- Attiva l'evento quando un utente è contrassegnato come non lead convertito per uno dei vari motivi
disqualify_lead
Questo evento misura quando un utente viene contrassegnato come escluso per diventare lead, insieme al motivo della mancata idoneità.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
disqualified_lead_reason |
string |
No | Non voglio acquistare | Il motivo per cui un lead è stato contrassegnato come squalificato. |
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
disqualify_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03disqualified_lead_reason
- Nessun acquisto da effettuareitems
- {{Articoli e-commerce}}- Attiva l'evento quando un utente viene contrassegnato come squalificato per diventare lead per uno dei vari motivi
earn_virtual_currency
Questo evento misura quando a un utente viene assegnata una valuta virtuale in un gioco. Registra questo valore insieme a spend_virtual_currency per comprendere meglio i tuoi dell'economia virtuale.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
virtual_currency_name |
string |
No | Gem | Nome della valuta virtuale. |
value |
number |
No | 5 | Valore della valuta virtuale. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
earn_virtual_currency
- Parametri evento (nome parametro - valore):
virtual_currency_name
- Gemvalue
- 5- Attiva l'evento quando a qualcuno viene assegnata una valuta virtuale
generate_lead
Questo evento misura quando è stato generato un lead (ad esempio, tramite una ). Registra questi dati per capire l'efficacia delle tue campagne di marketing e il numero di clienti che interagiscono nuovamente con la tua attività dopo il remarketing nel clienti.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
lead_source |
string |
No | Fiere | L'origine del lead. |
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
generate_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03lead_source
- Fieraitems
- {{Articoli e-commerce}}- Attivare l'evento quando è stato generato un lead
join_group
Registra questo evento quando un utente si unisce a un gruppo, ad esempio una gilda, un team o una famiglia. Utilizza le funzionalità di questo evento per analizzare la popolarità di determinati gruppi o funzionalità social.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
group_id |
string |
No | G_12345 | L'ID del gruppo. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
join_group
- Parametri evento (nome parametro - valore):
group_id
- G_12345- Attiva l'evento quando un utente entra a far parte di un gruppo
level_end
Questo evento indica che un giocatore ha raggiunto la fine di un livello in un gioco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
level_name |
string |
No | Il viaggio inizia... | Il nome del livello. |
success |
boolean |
No | true | Imposta su true se il livello è stato completato correttamente. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
level_end
- Parametri evento (nome parametro - valore):
level_name
- Il viaggio inizia...- successo - vero
- Si attiva quando un giocatore raggiunge la fine di un livello (ad es.la pagina di conferma del livello).
level_start
Questo evento indica che un giocatore ha iniziato un livello in un gioco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
level_name |
string |
No | Il viaggio inizia... | Il nome del livello. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
level_start
- Parametri evento (nome parametro - valore):
level_name
- Il viaggio inizia...- Si attiva quando un utente avvia un nuovo livello (ad es. la pagina iniziale del livello)
level_up
Questo evento indica che un giocatore è salito di livello in un gioco. Utilizzala per valutare la distribuzione a livelli della tua base utenti e identifica i livelli difficili da completato.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
level |
number |
No | 5 | Il livello del personaggio. |
character |
string |
No | Giocatore 1 | Il personaggio che è salito di livello. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
level_up
- Parametri evento (nome parametro - valore):
level
- 5character
- Giocatore 1- Si attiva quando un giocatore sali di livello
accedere
Invia questo evento per indicare che un utente ha eseguito l'accesso al tuo sito web o alla tua app.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
method |
string |
No | Il metodo utilizzato per accedere. |
Esempio
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
login
- Parametri evento (nome parametro - valore):
method
- Google- Si attiva quando un utente ha eseguito l'accesso
post_score
Invia questo evento quando l'utente pubblica un punteggio. Usa questo evento per capire come il rendimento degli utenti nel tuo gioco e metti in relazione i punteggi migliori con i segmenti di pubblico i comportamenti dei modelli,
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
score |
number |
Sì | 10000 | Il punteggio da pubblicare. |
level |
number |
No | 5 | Il livello del punteggio. |
character |
string |
No | Giocatore 1 | Il personaggio che ha ottenuto il punteggio. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
post_score
- Parametri evento (nome parametro - valore):
score
-10.000level
- 5character
- Giocatore 1- Si attiva quando l'utente pubblica un punteggio
purchase
Questo evento indica quando un utente acquista uno o più articoli.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
transaction_id |
string |
Sì | T_12345 | L'identificatore univoco di una transazione. Il parametro transaction_id ti consente di evitare eventi duplicati per un acquisto. |
coupon |
string |
No | SUMMER_FUN | Nome/codice del coupon associato all'evento. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
shipping |
number |
No | 3,33 | Costo di spedizione associato a una transazione. |
tax |
number |
No | 1.11 | Oneri fiscali associati a una transazione. |
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
purchase
- Articoli e-commerce -
ecommerce.items
- ID transazione e-commerce -
ecommerce.transaction_id
- Valore e-commerce -
ecommerce.value
- Imposta per l'e-commerce -
ecommerce.tax
- Spedizione e-commerce -
ecommerce.shipping
- Valuta e-commerce -
ecommerce.currency
- Coupon e-commerce -
ecommerce.coupon
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}transaction_id
- {{ID transazione e-commerce}}value
- {{Valore e-commerce}}tax
- {{Imposta sull'e-commerce}}shipping
- {{Spedizione e-commerce}}currency
- {{Valuta di e-commerce}}coupon
- {{Coupon e-commerce}}- Attivazione: evento uguale all'acquisto
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
purchase
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento misura quando un utente viene contrassegnato come conforme ai criteri per diventare lead qualificato.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
qualify_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03items
- {{Articoli e-commerce}}- Attiva l'evento quando un utente viene contrassegnato come idoneo per diventare un lead qualificato
refund
Questo evento indica quando uno o più articoli vengono rimborsati a un utente.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
transaction_id |
string |
Sì | T_12345 | L'identificatore univoco di una transazione. |
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
coupon |
string |
No | SUMMER_FUN | Nome/codice del coupon associato all'evento. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
shipping |
number |
No | 3,33 | Costo di spedizione associato a una transazione. |
tax |
number |
No | 1.11 | Oneri fiscali associati a una transazione. |
items |
Array<Item>
|
No* | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
refund
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- ID transazione e-commerce -
ecommerce.transaction_id
- Valore e-commerce -
ecommerce.value
- Imposta per l'e-commerce -
ecommerce.tax
- Spedizione e-commerce -
ecommerce.shipping
- Valuta e-commerce -
ecommerce.currency
- Coupon e-commerce -
ecommerce.coupon
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}transaction_id
- {{ID transazione e-commerce}}value
- {{Valore e-commerce}}tax
- {{Imposta sull'e-commerce}}shipping
- {{Spedizione e-commerce}}currency
- {{Valuta di e-commerce}}coupon
- {{Coupon e-commerce}}- Attivatore: evento uguale al rimborso
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
refund
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
L'evento indica che un articolo è stato rimosso da un carrello.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
remove_from_cart
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}- Attivatore: evento uguale a remove_from_cart
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
remove_from_cart
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Registra questo evento per indicare quando l'utente ha eseguito una ricerca. Puoi utilizzare questo evento per identificare ciò che gli utenti cercano sul tuo sito web o nella tua app. Per Ad esempio, puoi inviare questo evento quando un utente visualizza una pagina dei risultati di ricerca dopo eseguire una ricerca.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
search_term |
string |
Sì | t-shirt | Termine cercato. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
search
- Parametri evento (nome parametro - valore):
search_term
- t-shirt- Trigger attivato quando un utente effettua una ricerca sul tuo sito web
select_content
Questo evento indica che un utente ha selezionato alcuni contenuti di un determinato tipo. Questo evento può aiutarti a identificare i contenuti popolari e le categorie di contenuti su sul tuo sito web o sulla tua app.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
content_type |
string |
No | prodotto | Il tipo di contenuti selezionati. |
content_id |
string |
No | C_12345 | Un identificatore per i contenuti selezionati. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
select_content
- Parametri evento (nome parametro - valore):
content_type
- prodottocontent_id
- C_12345- Attivatore: evento uguale a select_content
select_item
Questo evento indica che un elemento è stato selezionato da un elenco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo. |
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo. |
items |
Array<Item> |
Sì* | Gli elementi dell'evento. * L'array items deve avere un solo
che rappresenta l'elemento selezionato. Se sono presenti più elementi
fornito, verrà utilizzato solo il primo elemento in items .
|
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
select_item
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- ID elenco di articoli e-commerce -
ecommerce.item_list_id
- Nome elenco di articoli e-commerce -
ecommerce.item_list_name
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}item_list_id
- {{ID elenco di articoli e-commerce}}item_list_name
- {{Nome elenco articoli e-commerce}}- Attivatore: evento uguale a select_item
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
select_item
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento indica che una promozione è stata selezionata da un elenco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Ignorata se impostata a livello di articolo. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
. Ignorata se impostata a livello di articolo. |
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'evento. Ignorata se impostata a livello di articolo. |
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'evento. Ignorata se impostata a livello di articolo. |
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Variabili del livello dati (nome - Nome variabile livello dati):
- Nome creatività e-commerce -
ecommerce.creative_name
- Area creatività e-commerce -
ecommerce.creative_slot
- ID promozione e-commerce -
ecommerce.promotion_id
- Nome della promozione e-commerce -
ecommerce.promotion_name
- Articoli e-commerce -
ecommerce.items
- Parametri evento (nome parametro - valore):
creative_name
- {{Nome creatività e-commerce}}creative_slot
- {{Area creatività e-commerce}}promotion_id
- {{ID promozione e-commerce}}promotion_name
- {{Nome promozione e-commerce}}items
- {{Articoli e-commerce}}- Tipo di variabile: variabile livello dati - "ecommerce.items"
- Attivatore: evento uguale a select_promotion
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
select_promotion
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
}
]
}
});
condividere
Utilizza questo evento quando un utente ha condiviso contenuti.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
method |
string |
No | Il metodo con cui i contenuti vengono condivisi. | |
content_type |
string |
No | immagine | Il tipo di contenuti condivisi. |
item_id |
string |
No | C_12345 | L'ID dei contenuti condivisi. |
Esempio
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
share
- Parametri evento (nome parametro - valore):
method
- Twittercontent_type
- immagineitem_id
- C_12345- Si attiva quando un utente ha condiviso contenuti
sign_up
Questo evento indica che un utente ha creato un account. Usa questo evento per Comprendere i diversi comportamenti degli utenti che hanno effettuato l'accesso e quelli che non l'hanno effettuato.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
method |
string |
No | Il metodo utilizzato per la registrazione. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
sign_up
- Parametri evento (Nome parametro - Valore):
method
- Google- Trigger attivato dalla registrazione di un account da parte di un utente
spend_virtual_currency
Questo evento misura la vendita di beni virtuali nella tua app e ti aiuta a identificare quali sono i prodotti virtuali più popolari.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
value |
number |
Sì | 5 | Valore della valuta virtuale. |
virtual_currency_name |
string |
Sì | Gem | Nome della valuta virtuale. |
item_name |
string |
No | Booster iniziale | Il nome dell'elemento per cui viene utilizzata la valuta virtuale. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
spend_virtual_currency
- Parametri evento (nome parametro - valore):
value
- 5virtual_currency_name
- Gemitem_name
- Boost iniziale- Si attiva quando qualcuno acquista un bene virtuale
tutorial_begin
L'evento rappresenta l'inizio della procedura di inserimento. Usa questo approccio in una canalizzazione con tutorial_complete per capire quanti utenti completano il tutorial.
Parametri
Non ci sono parametri per questo evento.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
tutorial_begin
- Si attiva quando qualcuno inizia la procedura di inserimento
tutorial_complete
Questo evento indica il completamento della procedura di onboarding da parte dell'utente. Usa questa in una canalizzazione con tutorial_begin per capire quanti utenti completano tutorial di Google Cloud.
Parametri
Nessun parametro suggerito per questo evento.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
tutorial_complete
- Si attiva quando qualcuno completa la procedura di inserimento
unlock_achievement
Registra questo evento quando l'utente ha sbloccato un obiettivo. Questo evento può aiutarti comprendi l'esperienza degli utenti con il tuo gioco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
achievement_id |
string |
Sì | A_12345 | ID dell'obiettivo raggiunto. |
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
unlock_achievement
- Parametri evento (nome parametro - valore):
achievement_id
- A_12345- Si attiva quando un utente ha sbloccato un obiettivo
view_cart
L'evento indica che un utente ha visualizzato il carrello.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
view_cart
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}- Attivatore: evento uguale a view_cart
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
view_cart
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento indica che alcuni contenuti sono stati mostrati all'utente. Usa questo evento per scopri gli articoli più popolari visualizzati.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
view_item
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- Valore e-commerce -
ecommerce.value
- Valuta e-commerce -
ecommerce.currency
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}value
- {{Valore e-commerce}}currency
- {{Valuta di e-commerce}}- Attivatore: event è uguale a view_item
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
view_item
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Registra questo evento quando all'utente viene presentato un elenco di elementi di un per una determinata categoria.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo. |
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Ignorata se impostata a livello di articolo. |
items |
Array<Item> |
Sì | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
view_item_list
- Variabili del livello dati (nome - Nome variabile livello dati):
- Articoli e-commerce -
ecommerce.items
- ID elenco di articoli e-commerce -
ecommerce.item_list_id
- Nome elenco di articoli e-commerce -
ecommerce.item_list_name
- Parametri evento (nome parametro - valore):
items
- {{Articoli e-commerce}}item_list_id
- {{ID elenco di articoli e-commerce}}item_list_name
- {{Nome elenco articoli e-commerce}}- Attivatore: evento uguale a view_item_list
Configurazione attivatore:
- Tipo di attivatore: evento personalizzato
- Nome evento:
view_item_list
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento indica che una promozione è stata visualizzata da un elenco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Ignorata se impostata a livello di articolo. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
. Ignorata se impostata a livello di articolo. |
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'evento. Ignorata se impostata a livello di articolo. |
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'evento. Ignorata se impostata a livello di articolo. |
items |
Array<Item> |
Sì* | Gli elementi dell'evento. * L'array items deve avere un solo
che rappresenta l'articolo associato alla promozione. Se più
vengono forniti, solo il primo elemento in items lo
.
|
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
view_promotion
- Variabili del livello dati (nome - Nome variabile livello dati):
- Nome creatività e-commerce -
ecommerce.creative_name
- Area creatività e-commerce -
ecommerce.creative_slot
- ID promozione e-commerce -
ecommerce.promotion_id
- Nome della promozione e-commerce -
ecommerce.promotion_name
- Articoli e-commerce -
ecommerce.items
- Parametri evento (nome parametro - valore):
creative_name
- {{Nome creatività e-commerce}}creative_slot
- {{Area creatività e-commerce}}promotion_id
- {{ID promozione e-commerce}}promotion_name
- {{Nome promozione e-commerce}}items
- {{Articoli e-commerce}}- Attivatore: evento uguale a view_promotion
Configurazione attivatore:
- Tipo di attivatore: Evento personalizzato
- Nome evento:
view_promotion
- Questo attivatore si attiva su: Tutti gli eventi personalizzati
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
Questo evento misura quando un utente contatta un rappresentante o viene contattato da un rappresentante.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | USD |
Valuta degli articoli associati all'evento, in
3 lettere
formato ISO 4217. * Se imposti value , il currency è obbligatorio
per calcolare con precisione le metriche relative alle entrate.
|
value |
number |
Sì* | 30:03 | Il valore monetario dell'evento. * Imposta value alla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* In genere il valore value è obbligatorio per generare report significativi.
Se segnali
l'evento come conversione, ti consigliamo di impostare
value .
* Il campo currency è obbligatorio se imposti value .
|
lead_status |
string |
No | Conversazioni avviate | Lo stato del lead. |
items |
Array<Item>
|
No | Gli elementi dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
ID dell'articolo.
*È obbligatorio specificare un valore tra |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*È obbligatorio specificare un valore tra |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per designare un'azienda fornitrice o un mattone e
negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito dell'articolo. |
coupon |
string |
No | SUMMER_FUN | Il nome/codice del coupon associato all'articolo. I parametri coupon a livello di evento e di articolo sono
indipendenti.
|
creative_name |
string |
No | summer_banner2 | Il nome della creatività promozionale. Se impostato, il criterio creative_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_name a livello di evento, se
presenti. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area creatività promozionale associata alla
molto utile. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore creative_slot a livello di evento, se
presenti. |
discount |
number |
No | 2,22 | Il valore dello sconto monetario unitario associato all'articolo. |
index |
number |
No | 5 | L'indice/la posizione dell'elemento in un elenco. |
item_brand |
string |
No | Il brand dell'articolo. | |
item_category |
string |
No | Abbigliamento | La categoria dell'articolo. Se utilizzato nell'ambito di una gerarchia di categorie tassonomia, questa sarà la prima categoria. |
item_category2 |
string |
No | Adulto | La seconda gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category3 |
string |
No | Camicie | La terza gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category4 |
string |
No | Troupe | La quarta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_category5 |
string |
No | A manica corta | La quinta gerarchia di categorie o tassonomia aggiuntiva per l'articolo. |
item_list_id |
string |
No | related_products | L'ID dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_id a livello di evento, se
presenti.
|
item_list_name |
string |
No | Prodotti correlati | Il nome dell'elenco in cui l'articolo è stato presentato all'utente. Se impostato, il criterio item_list_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore item_list_name a livello di evento, se
presenti.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per un articolo aggiuntivo dettagli/opzioni. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la posizione fisica
sede del negozio). Ti consigliamo di utilizzare
Google
ID posizione che corrisponde all'articolo associato. Una località personalizzata
È possibile usare anche l'ID. Nota: l'attributo "location id" [id località] è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10:01 |
Il prezzo unitario monetario dell'articolo, in unità della valuta specificata
.
Se si applica uno sconto all'articolo, imposta price sul prezzo unitario scontato e
specifica lo sconto sul prezzo unitario nel parametro discount .
|
promotion_id |
string |
No | P_12345 |
L'ID della promozione associato all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_id a livello di evento, se
presenti.
|
promotion_name |
string |
No | Saldi estivi |
Il nome della promozione associata all'articolo. Se impostato, il criterio promotion_name a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato il valore promotion_name a livello di evento, se
presenti.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
Il seguente esempio riguarda le implementazioni di Tag Manager:
Mostrami la configurazione del tag
Configurazione dei tag:
- Tipo di tag: evento GA4
- Nome evento:
working_lead
- Parametri evento (nome parametro - valore):
currency
- $value
-30,03lead_status
- Conversazioni avviateitems
- {{Articoli e-commerce}}- Attiva l'evento quando un utente contatta o viene contattato da un rappresentante