Questi eventi ti consentono di misurare funzionalità e comportamenti aggiuntivi e generare report più utili in Google Analytics 4. Poiché questi eventi richiedono un contesto aggiuntivo per essere significativi, non vengono inviati automaticamente. Utilizza questo documento per vedere i parametri obbligatori e facoltativi per ogni evento.
add_payment_info
Questo evento indica che un utente ha inviato i propri dati di pagamento durante una procedura di pagamento e-commerce.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* 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> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
add_payment_info
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}coupon
- {{Coupon e-commerce}}payment_type
- {{Tipo di pagamento e-commerce}}- Trigger: l'evento è uguale a add_payment_info
Configurazione trigger:
- 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 le proprie informazioni di spedizione durante una procedura di pagamento e-commerce.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* 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 | Trasporto terrestre |
Livello di spedizione (ad es. Ground , Air ,
Next-day ) selezionato per la consegna dell'articolo acquistato.
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
add_shipping_info
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}coupon
- {{Coupon e-commerce}}shipping_tier
- {{Livello di spedizione e-commerce}}- Trigger: l'evento è uguale a add_shipping_info
Configurazione trigger:
- 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 al carrello per l'acquisto.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
add_to_cart
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}- Trigger: l'evento è uguale a add_to_cart
Configurazione trigger:
- 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 articolo è stato aggiunto a una lista desideri. Utilizza questo evento per identificare gli articoli regalo popolari nella tua app.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
add_to_wishlist
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}- Trigger: l'evento è uguale a add_to_wishlist
Configurazione trigger:
- 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
Questo evento indica che un utente ha avviato una procedura di pagamento.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* 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> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
begin_checkout
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}coupon
- {{Coupon e-commerce}}- Trigger: evento è uguale a start_checkout
Configurazione trigger:
- 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
}
]
}
});
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 la tua economia virtuale.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
virtual_currency_name |
string |
No | Gem | Nome della valuta virtuale. |
value |
number |
No | 5 | Il valore della valuta virtuale. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
earn_virtual_currency
- Parametri evento (nome parametro - valore):
virtual_currency_name
- Gemmevalue
- 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 un modulo). Registra questi dati per comprendere l'efficacia delle tue campagne di marketing e quanti clienti interagiscono nuovamente con la tua attività dopo il remarketing per i clienti.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
generate_lead
- Parametri evento (nome parametro - valore):
currency
- $value
- 99,99- Attiva l'evento quando è stato generato un lead
join_group
Registra questo evento quando un utente entra a far parte di un gruppo, ad esempio una gilda, una squadra o una famiglia. Usa 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
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
join_group
- Parametri evento (nome parametro - valore):
group_id
- G_12345- Attivare l'evento quando un utente entra in 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 | Impostato su true se il livello è stato completato correttamente. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
level_end
- Parametri evento (nome parametro - valore):
level_name
- Il viaggio inizia...- operazione riuscita - vero
- Si attiva quando un giocatore ha raggiunto 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
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione 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 inizia un nuovo livello (ad es. la pagina iniziale del livello)
level_up
Questo evento indica che un giocatore è salito di livello in una partita. Utilizzalo per valutare la distribuzione dei livelli della tua base utenti e identificare i livelli difficili da completare.
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
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione 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 dei tag
Configurazione 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. Utilizza questo evento per comprendere il rendimento degli utenti nel tuo gioco e correlare i punteggi migliori con i segmenti di pubblico o i comportamenti.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
score |
number |
Yes | 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
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione 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 ha acquistato uno o più articoli.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
transaction_id |
string |
Yes | T_12345 | L'identificatore univoco di una transazione. Il parametro transaction_id ti consente di evitare di ricevere 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> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione 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
- Imposte 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
- {{Tasse e-commerce}}shipping
- {{Spedizione e-commerce}}currency
- {{Valuta e-commerce}}coupon
- {{Coupon e-commerce}}- Trigger: evento uguale a acquisto
Configurazione trigger:
- 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
}]
}
});
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ì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
transaction_id |
string |
Yes | T_12345 | L'identificatore univoco di una transazione. |
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* 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 articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
refund
- Variabili del livello dati (nome - Nome variabile del livello dati):
- Articoli e-commerce -
ecommerce.items
- ID transazione e-commerce -
ecommerce.transaction_id
- Valore e-commerce -
ecommerce.value
- Imposte 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
- {{Tasse e-commerce}}shipping
- {{Spedizione e-commerce}}currency
- {{Valuta e-commerce}}coupon
- {{Coupon e-commerce}}- Trigger: l'evento è uguale al rimborso
Configurazione trigger:
- 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
Questo evento indica che un articolo è stato rimosso da un carrello.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
remove_from_cart
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}- Trigger: l'evento è uguale a remove_from_cart
Configurazione trigger:
- 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. Ad esempio, puoi inviare questo evento quando un utente visualizza una pagina dei risultati di ricerca dopo aver eseguito una ricerca.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
search_term |
string |
Yes | T-shirt | Termine cercato. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
search
- Parametri evento (nome parametro - valore):
search_term
- t-shirt- Si attiva quando un utente esegue 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 contenuti popolari e categorie di contenuti sul tuo sito web o nella 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 | Identificatore per i contenuti selezionati. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
select_content
- Parametri evento (nome parametro - valore):
content_type
- prodottocontent_id
- C_12345- Trigger: l'evento è uguale a select_content
select_item
Questo evento indica che un articolo è 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 articoli dell'evento. * L'array items dovrebbe avere un singolo
elemento, che rappresenta l'elemento selezionato. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in items .
|
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
select_item
- Variabili del livello dati (nome - Nome variabile del livello dati):
- Articoli e-commerce -
ecommerce.items
- ID elenco di articoli per l'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 articoli e-commerce}}item_list_name
- {{Nome elenco articoli e-commerce}}- Trigger: evento è uguale a select_item
Configurazione trigger:
- 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 della creatività promozionale associata all'evento. Ignorata se impostata a livello di articolo. |
promotion_id |
string |
No | P_12345 |
L'ID della promozione associata 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 articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Variabili del livello dati (nome - Nome variabile del livello dati):
- Nome creatività e-commerce -
ecommerce.creative_name
- Area creatività e-commerce -
ecommerce.creative_slot
- ID promozione e-commerce -
ecommerce.promotion_id
- Nome promozione e-commerce -
ecommerce.promotion_name
- Articoli e-commerce -
ecommerce.items
- Parametri evento (nome parametro - valore):
creative_name
- {{Nome creatività e-commerce}}creative_slot
- {{Spazio 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'
- Trigger: evento è uguale a select_promotion
Configurazione trigger:
- 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
}
]
}
});
condivisione
Utilizza questo evento quando un utente ha condiviso contenuti.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
method |
string |
No | Il metodo con cui vengono condivisi i contenuti. | |
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 dei tag
Configurazione 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. Utilizza questo evento per comprendere i diversi comportamenti degli utenti che hanno eseguito l'accesso e quelli che non l'hanno eseguito.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
method |
string |
No | Il metodo utilizzato per la registrazione. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
sign_up
- Parametri evento (nome parametro - valore):
method
- Google- Si attiva quando un utente ha creato un account
spend_virtual_currency
Questo evento misura la vendita di beni virtuali nella tua app e ti aiuta a identificare quali beni virtuali sono più popolari.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
value |
number |
Yes | 5 | Il valore della valuta virtuale. |
virtual_currency_name |
string |
Yes | Gem | Nome della valuta virtuale. |
item_name |
string |
No | Booster iniziale | Il nome dell'articolo per il quale viene utilizzata la valuta virtuale. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
spend_virtual_currency
- Parametri evento (nome parametro - valore):
value
- 5virtual_currency_name
- Gemmeitem_name
- Booster iniziale- Si attiva quando qualcuno acquista un bene virtuale
tutorial_begin
Questo evento indica l'inizio della procedura di onboarding. Utilizzalo in una canalizzazione con tutorial_complete per capire quanti utenti completano il tutorial.
Parametri
Nessun parametro per questo evento.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
tutorial_begin
- Si attiva quando qualcuno inizia la procedura di onboarding
tutorial_complete
Questo evento indica il completamento della procedura di onboarding da parte dell'utente. Utilizzalo in una canalizzazione con tutorial_begin per capire quanti utenti completano il tutorial.
Parametri
Nessun parametro suggerito per questo evento.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
tutorial_complete
- Attivazione quando qualcuno completa la procedura di onboarding
unlock_achievement
Registra questo evento quando l'utente ha sbloccato un obiettivo. Questo evento può aiutarti a capire come gli utenti utilizzano il tuo gioco.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
achievement_id |
string |
Yes | A_12345 | ID dell'obiettivo raggiunto. |
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione 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
Questo evento indica che un utente ha visualizzato il carrello.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
view_cart
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}- Trigger: l'evento è uguale a view_cart
Configurazione trigger:
- 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. Utilizza questo evento per scoprire gli articoli più popolari visualizzati.
Parametri
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
currency |
string |
Sì* | € |
Valuta degli articoli associati all'evento nel formato ISO 4217 a tre lettere. * Se imposti value , currency è necessario per calcolare accuratamente le metriche relative alle entrate.
|
value |
number |
Sì* | 30,03 | Il valore monetario dell'evento. * Imposta value sulla somma di (price * quantity) per tutti gli elementi in
items . Non includere shipping o tax .
* value è in genere necessaria per generare report significativi.
Se contrassegna l'evento come conversione, ti consigliamo di impostare value .
* currency è obbligatorio se imposti value .
|
items |
Array<Item> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
view_item
- Variabili del livello dati (nome - Nome variabile del 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 e-commerce}}- Trigger: evento uguale a view_item
Configurazione trigger:
- 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 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> |
Yes | Gli articoli dell'evento. |
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
view_item_list
- Variabili del livello dati (nome - Nome variabile del livello dati):
- Articoli e-commerce -
ecommerce.items
- ID elenco di articoli per l'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 articoli e-commerce}}item_list_name
- {{Nome elenco articoli e-commerce}}- Trigger: evento uguale a view_item_list
Configurazione trigger:
- 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 in 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 della creatività promozionale associata all'evento. Ignorata se impostata a livello di articolo. |
promotion_id |
string |
No | P_12345 |
L'ID della promozione associata 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 articoli dell'evento. * L'array items dovrebbe avere un singolo
elemento, che rappresenta l'articolo associato alla promozione. Se vengono forniti più elementi, verrà utilizzato solo il primo elemento in items .
|
Parametri degli elementi
Nome | Tipo | Obbligatorio | Valore di esempio | Descrizione |
---|---|---|---|---|
item_id |
string |
Sì* | SKU_12345 |
L'ID dell'articolo.
*Uno dei valori |
item_name |
string |
Sì* | Maglietta Stan and Friends |
Il nome dell'articolo.
*Uno dei valori |
affiliation |
string |
No | Google Store |
Un'affiliazione di prodotto per indicare un'azienda di fornitura o la località di un negozio fisico. Nota: l'"affiliazione" è disponibile solo nell'ambito degli articoli. |
coupon |
string |
No | SUMMER_FUN | 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 creative_name a livello di evento, se
presente. |
creative_slot |
string |
No | featured_app_1 | Il nome dell'area della creatività promozionale associata all'articolo. Se impostato, il criterio creative_slot a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato creative_slot a livello di evento, se
presente. |
discount |
number |
No | 2,22 | 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 utilizzata nell'ambito di una gerarchia di categorie o di una tassonomia, 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 | 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 item_list_id a livello di evento, se
presente.
|
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 item_list_name a livello di evento, se
presente.
|
item_variant |
string |
No | verde | La variante, il codice univoco o la descrizione dell'articolo per ulteriori opzioni/dettagli dell'articolo. |
location_id |
string |
No | ChIJIQBpAG2ahYAR_6128GcTUEo (l'ID luogo di Google per San Francisco) |
La posizione fisica associata all'articolo (ad es. la sede fisica del negozio). Ti consigliamo di utilizzare
l'ID
luogo Google che corrisponde all'articolo associato. È possibile utilizzare anche un ID località personalizzato. Nota: l'attributo "location id" è disponibile solo nell'ambito degli articoli. |
price |
number |
No | 10,01 |
Il prezzo unitario monetario dell'elemento, espresso in unità del parametro currency specificato.
Se all'articolo viene applicato uno sconto, 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 associata all'articolo. Se impostato, il criterio promotion_id a livello di evento viene ignorato.
Se non viene configurato, viene utilizzato promotion_id a livello di evento, se
presente.
|
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 promotion_name a livello di evento, se
presente.
|
quantity |
number |
No | 3 |
Quantità articolo. |
items
.
Esempio
L'esempio seguente riguarda le implementazioni di Tag Manager:
Mostrami la configurazione dei tag
Configurazione tag:
- Tipo di tag: evento GA4
- Nome evento:
view_promotion
- Variabili del livello dati (nome - Nome variabile del livello dati):
- Nome creatività e-commerce -
ecommerce.creative_name
- Area creatività e-commerce -
ecommerce.creative_slot
- ID promozione e-commerce -
ecommerce.promotion_id
- Nome promozione e-commerce -
ecommerce.promotion_name
- Articoli e-commerce -
ecommerce.items
- Parametri evento (nome parametro - valore):
creative_name
- {{Nome creatività e-commerce}}creative_slot
- {{Spazio creatività e-commerce}}promotion_id
- {{ID promozione e-commerce}}promotion_name
- {{Nome promozione e-commerce}}items
- {{Articoli e-commerce}}- Trigger: evento è uguale a view_promotion
Configurazione trigger:
- 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
}
]
}
});