In questa pagina viene descritto come utilizzare gtag.js per raccogliere i dati di e-commerce avanzato. Se hai configurato Google Analytics in gtag.js e hai attivato l'e-commerce avanzato in Google Analytics, puoi utilizzare gtag.js per inviare a Google Analytics dati sulle impressioni, sui dati di prodotto, sulle promozioni e sulle azioni.
Azioni e tipi di dati per l'e-commerce avanzato
Puoi inviare diversi tipi di dati di e-commerce:
Dati sulle impressioni
Rappresenta le informazioni su un prodotto che è stato visualizzato. È definito impressionFieldObject
e contiene i seguenti valori:
Chiave | Tipo di valore | Obbligatorio | Descrizione |
---|---|---|---|
id |
testo | *Sì |
L'ID prodotto o lo SKU (ad es. P67890).
* È necessario impostare un valore tra |
name |
testo | *Sì |
Il nome del prodotto (ad es. T-shirt Android).
* È necessario impostare un valore tra |
list |
testo | No | L'elenco o la raccolta a cui appartiene il prodotto (ad es. Risultati di ricerca) |
list_name |
testo | No | L'elenco o la raccolta a cui appartiene il prodotto (ad es. Risultati di ricerca) |
brand |
testo | No | Il brand associato al prodotto (ad es. Google). |
category |
testo | No |
La categoria a cui appartiene il prodotto (ad es. Abbigliamento). Utilizza / come delimitatore per specificare fino a cinque livelli di gerarchia (ad es. Abbigliamento/Uomo/T-shirt).
|
variant |
testo | No | La variante del prodotto (ad es. nero). |
position |
numero intero | No | La posizione del prodotto in un elenco o in una raccolta (ad es. 2). |
list_position |
numero intero | No | La posizione del prodotto in un elenco o in una raccolta (ad es. 2). |
price |
numero | No | Il prezzo di un prodotto (ad es. 29,20). |
Dati prodotto
I dati di prodotto rappresentano i singoli prodotti che sono stati visualizzati, aggiunti al carrello e così via. Sono definiti productFieldObject
e contengono i seguenti valori:
Chiave | Tipo di valore | Obbligatorio | Descrizione |
---|---|---|---|
id |
testo | *Sì |
L'ID prodotto o lo SKU (ad es. P67890).
* È necessario impostare un valore tra ID o |
name |
testo | *Sì |
Il nome del prodotto (ad es. T-shirt Android).
* È necessario impostare un valore tra ID o |
brand |
testo | No | Il brand associato al prodotto (ad es. Google). |
category |
testo | No | La categoria a cui appartiene il prodotto (ad es. Abbigliamento). Utilizza / come delimitatore per specificare fino a cinque livelli di gerarchia (ad es. Abbigliamento/Uomo/T-shirt). |
variant |
testo | No | La variante del prodotto (ad es. nero). |
price |
numero | No | Il prezzo di un prodotto (ad es. 29,20). |
quantity |
numero intero | No | La quantità di un prodotto (ad es. 2). |
coupon |
testo | No | Il codice coupon associato a un prodotto (ad es. SUMMER_SALE13). |
position |
numero intero | No | La posizione del prodotto in un elenco o in una raccolta (ad es. 2). |
list_position |
numero intero | No | La posizione del prodotto in un elenco o in una raccolta (ad es. 2). |
Dati della promozione
Rappresenta le informazioni su una promozione che è stata visualizzata. Si riferisce a un promoFieldObject
e contiene i seguenti valori:
Chiave | Tipo di valore | Obbligatorio | Descrizione |
---|---|---|---|
id |
testo | *Sì |
L'ID promozione (ad es. PROMO_1234).
* È necessario impostare un valore tra |
name |
testo | *Sì |
Il nome della promozione (ad es. Saldi estivi).
* È necessario impostare un valore tra |
creative |
testo | No | La creatività associata alla promozione (ad esempio, estate_banner2). |
creative_name |
testo | No | Il nome della creatività (ad esempio, estate_banner2). |
position |
testo | No | La posizione della creatività (ad esempio banner_slot_1). |
creative_slot |
testo | No | Il nome dell'area creatività (ad es. banner_slot_1). |
Dati azione
Rappresenta le informazioni su un'azione correlata all'e-commerce avvenuta.
È denominato actionFieldObject
e contiene i seguenti valori:
Chiave | Tipo di valore | Obbligatorio | Descrizione |
---|---|---|---|
id |
testo | *Sì |
L'ID transazione (ad es. T1234).
* Obbligatorio se il tipo di azione è |
affiliation |
testo | No | Il negozio o l'affiliazione da cui si è verificata la transazione (ad es. Google Store). |
revenue |
numero | No |
Specifica le entrate totali o il totale complessivo associati alla transazione (ad es. 11,99). Questo valore può includere spedizione, costi fiscali o altri aggiustamenti alle entrate totali da includere nel calcolo delle entrate. |
valore | numero | No | Valore (ovvero entrate) associato all'evento. |
tax |
numero | No | L'imposta totale associata alla transazione. |
shipping |
numero | No | Il costo di spedizione associato alla transazione. |
coupon |
testo | No | Coupon della transazione utilizzato con la transazione. |
list |
testo | No | L'elenco a cui appartengono i prodotti associati. Campo facoltativo. |
items |
array | No | L'array contenente i prodotti associati. |
step |
numero intero | No | Un numero che rappresenta un passaggio della procedura di pagamento. Facoltativo nelle azioni "checkout". |
checkout_step |
numero intero | No | Un numero che rappresenta un passaggio della procedura di pagamento. |
option |
testo | No |
Campo aggiuntivo per le azioni checkout e checkout_option che può descrivere le informazioni sulle opzioni nella pagina di pagamento, ad esempio il metodo di pagamento selezionato.
|
checkout_option |
testo | No | Opzione di pagamento (ovvero il metodo di pagamento selezionato). |
Chiave | Tipo di valore | Obbligatorio | Descrizione |
---|---|---|---|
coupon |
stringa | No | Codice coupon per un articolo acquistabile. |
Azioni del prodotto e della promozione
Le azioni specificano come interpretare i dati sui prodotti e sulle promozioni che invii a Google Analytics.
Azione | Evento | Descrizione |
---|---|---|
click |
Un clic sul link di un prodotto o di un prodotto per uno o più prodotti. | |
detail |
Una visualizzazione dei dettagli del prodotto. | |
add |
Aggiunta di uno o più prodotti a un carrello degli acquisti. | |
remove |
Rimuovi uno o più prodotti da un carrello degli acquisti. | |
checkout |
Avvio della procedura di pagamento per uno o più prodotti. | |
checkout_option |
Invio del valore dell'opzione per un determinato passaggio di pagamento. | |
purchase |
Vendita di uno o più prodotti. | |
refund |
Il rimborso di uno o più prodotti. | |
promo_click |
Un clic su una promozione interna. | |
add_to_cart |
Un utente aggiunge uno o più prodotti a un carrello degli acquisti. | |
begin_checkout |
Un utente avvia la procedura di pagamento per uno o più prodotti. | |
checkout_progress |
Un utente completa i passaggi di pagamento dopo il primo passaggio di pagamento. | |
purchase |
Un utente completa un acquisto. | |
refund |
Un utente riceve un rimborso per uno o più prodotti. | |
remove_from_cart |
Un utente rimuove uno o più prodotti da un carrello degli acquisti. | |
select_content |
Un utente fa clic sul link a un prodotto o a un prodotto. | |
set_checkout_option |
Il passaggio di pagamento che un utente sta completando. | |
view_item |
Un utente visualizza i dettagli di un prodotto. | |
view_item_list |
Un utente visualizza un elenco di uno o più prodotti. | |
view_promotion |
Un utente fa clic su una promozione interna. | |
view_refund |
Un utente visualizza un rimborso per uno o più prodotti. |
Esempi
Misurare le impressioni dei prodotti
Per misurare le impressioni dei prodotti, invia un view_item_list
con le informazioni
sul prodotto:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
Misurare i clic sui prodotti
Per misurare un clic su un prodotto, invia un evento select_content
, specifica product
come content_type
e fornisci le informazioni sul prodotto:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
Misurare le visualizzazioni dei dettagli dei prodotti
Dopo aver fatto clic su una scheda di prodotto, un utente potrebbe visualizzare la pagina dei dettagli del prodotto. Per misurare le visualizzazioni dei dettagli del prodotto, invia un evento view_item
con i dettagli del prodotto:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Misurare le aggiunte e le rimozioni dai carrelli degli acquisti
Per misurare l'aggiunta di un prodotto al carrello degli acquisti, invia un evento add_to_cart
con le informazioni sul prodotto:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Per misurare la rimozione di un prodotto da un carrello degli acquisti, invia un evento remove_from_cart
con le informazioni sul prodotto:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Misura i pagamenti
Per misurare ogni passaggio di una procedura di pagamento:
- Aggiungi il codice di misurazione per misurare ogni passaggio della procedura di pagamento.
- Se applicabile, aggiungi il codice di misurazione per registrare le opzioni di pagamento.
1. Misura i passaggi di pagamento
Per misurare il primo passaggio di pagamento, invia un evento begin_checkout
con gli elementi di pagamento:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
Per misurare ogni passaggio di pagamento successivo, invia un evento checkout_progress
con gli articoli di pagamento:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. Misurare le opzioni di pagamento
Per misurare un'opzione di pagamento, invia un evento set_checkout_option
con l'opzione di pagamento:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Misurare le impressioni della promozione
Per misurare le impressioni della promozione, invia un evento view_promotion
con informazioni
sulla promozione:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Misurare i clic sulle promozioni
Per misurare un clic sulla promozione, invia un evento select_content
e fornisci la promozione:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Misurare gli acquisti
Per misurare una transazione, invia un evento purchase
con gli elementi nella transazione:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
Misurare i rimborsi
Per misurare il rimborso totale di una transazione, invia un evento refund
con l'ID transazione:
gtag('event', 'refund', { "transaction_id": "T12345" })
Per misurare un rimborso parziale, invia un evento refund
con l'ID transazione e gli articoli da rimborsare:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});