Puoi configurare gli eventi di e-commerce per raccogliere informazioni sul comportamento di acquisto dei tuoi utenti. Gli eventi ti consentono di quantificare i prodotti più apprezzati e di vedere l'influenza delle promozioni e del posizionamento dei prodotti sulle entrate.
Questo articolo descrive ogni evento di e-commerce e quando configurarlo. Per un esempio dettagliato di come configurare un evento di e-commerce, consulta l'articolo Configurare un evento di acquisto.
Prima di iniziare
Assicurati di aver aggiunto il tag Google al tuo sito web e di poter accedere ad Analytics e al codice sorgente del sito web.
Suggerimenti
- Attivare la modalità di debug per visualizzare gli eventi in tempo reale e risolvere più facilmente i problemi
- Esamina i limiti delle metriche e delle dimensioni personalizzate quando invii parametri personalizzati con eventi di e-commerce.
- Imposta
currency
quando invii i dati relativi alle entratevalue
per garantire che le metriche relative alle entrate vengano calcolate correttamente - Imposta ogni parametro di e-commerce per il quale disponi di dati, indipendentemente dal fatto che sia facoltativo
- Utilizza il sito web di e-commerce di esempio per vedere un esempio di come codificare il tuo sito web.
Implementazione
Una tipica implementazione e-commerce misura tutte le azioni riportate di seguito:
- Selezionare un articolo da un elenco
- Visualizzazione dei dettagli di un articolo
- Aggiungere/rimuovere un prodotto da un carrello degli acquisti
- Avvio della procedura di pagamento
- Effettuare acquisti o rimborsi
- Applicare promozioni
Alla base di queste azioni ci sono i prodotti e i servizi che vendi. Puoi rappresentare i prodotti e i servizi come un array di elementi che possono essere aggiunti agli eventi di e-commerce. Puoi includere fino a 27 parametri personalizzati nell'array di articoli, oltre ai parametri obbligatori.
L'esempio seguente mostra come creare la raccolta di items
a cui viene fatto riferimento in questa guida. L'array items
può includere fino a 200 elementi.
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,
quantity: 2
}
]
Eseguire la migrazione da un'implementazione e-commerce di UA
Se hai già implementato l'e-commerce per Universal Analytics, per eseguire la migrazione a Google Analytics 4 puoi eseguire una delle seguenti operazioni:
- Utilizzare l'implementazione e-commerce di UA per completare gli eventi e-commerce GA4
- Sostituisci l'implementazione dell'e-commerce UA con gli eventi e-commerce GA4
- Inviare i dati di e-commerce ad Analytics tramite le implementazioni di UA e GA4
Per informazioni su come eseguire la transizione dell'implementazione dell'e-commerce da Universal Analytics a Google Analytics 4, consulta la guida alla migrazione dell'e-commerce a GA4 per il tag Google.
Selezionare un articolo da un elenco
Quando a un utente viene visualizzato un elenco di risultati, invia un evento view_item_list
che includa un parametro array items
contenente gli elementi visualizzati. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "view_item_list", {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google 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
}
]
});
Dopo che un utente seleziona un elemento dall'elenco, invia l'evento select_item
con l'elemento selezionato in un parametro array items
. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "select_item", {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google 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
}
]
});
Visualizza dettagli elemento
Per misurare quante volte i dettagli di un articolo vengono visualizzati, invia un evento view_item
ogni volta che un utente visualizza la schermata dei dettagli di un articolo. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "view_item", {
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
}
]
});
Aggiungere o rimuovere un articolo da un carrello degli acquisti
Misura un articolo aggiunto al carrello degli acquisti inviando un evento add_to_cart
con gli articoli pertinenti in un array items
. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "add_to_cart", {
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
}
]
});
Puoi anche misurare quando un articolo viene aggiunto a una lista desideri inviando un evento add_to_wishlist
con gli articoli pertinenti in un array items
. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "add_to_wishlist", {
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
}
],
});
Quando un utente visualizza successivamente il carrello, invia l'evento view_cart
con tutti gli articoli contenuti nel carrello. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "view_cart", {
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
}
]
});
Per misurare il momento in cui un utente rimuove un articolo da un carrello, invia l'evento remove_from_cart
. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "remove_from_cart", {
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
}
]
});
Avviare la procedura di pagamento
Misura il primo passaggio di una procedura di pagamento inviando un evento begin_checkout
con uno o più articoli definiti con i campi pertinenti. In questa fase è anche possibile aggiungere un coupon all'intero ordine aggiungendolo all'evento o applicandolo a un particolare elemento aggiungendolo a elementi specifici nell'array items
. Per maggiori dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "begin_checkout", {
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
}
]
});
Quando un utente procede al passaggio successivo della procedura di pagamento e aggiunge le informazioni di spedizione, invia un evento add_shipping_info
. Utilizza il parametro
shipping_tier
per specificare l'opzione di consegna dell'utente, ad esempio "via terra", "aereo"
o "giorno successivo". Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "add_shipping_info", {
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
}
]
});
Invia l'evento add_payment_info
quando un utente invia i suoi dati di pagamento.
Se applicabile, includi payment_type
in questo evento per il metodo di pagamento scelto. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "add_payment_info", {
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
}
]
});
Effettuare un acquisto o emettere un rimborso
Misura un acquisto inviando un evento purchase
con uno o più articoli definiti con i campi pertinenti. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "purchase", {
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
}]
});
Misura i rimborsi inviando un evento refund
con l'elemento transaction_id
pertinente specificato e uno o più elementi definiti con item_id
e quantity
. Ti
ti consigliamo di includere le informazioni sugli articoli nell'evento refund
per visualizzare
le metriche sui rimborsi a livello di articolo in Analytics.
Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "refund", {
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
}
]
});
Applica promozioni
L'e-commerce include il supporto per la misurazione delle impressioni e dei clic delle promozioni interne, ad esempio i banner visualizzati per promuovere una vendita.
Le impressioni della promozione vengono in genere misurate con la visualizzazione della schermata iniziale inviando l'evento view_promotion
con un parametro items per specificare l'articolo promosso. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "view_promotion", {
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
}
]
});
Per indicare che un utente ha fatto clic su una promozione, invia un evento select_promotion
con l'articolo in questione come parametro articolo. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.
gtag("event", "select_promotion", {
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
}
],
});