E-commerce avanzato

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 id o name.

name testo *Sì

Il nome del prodotto (ad es. T-shirt Android).

* È necessario impostare un valore tra id o name.

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.

name testo *Sì

Il nome del prodotto (ad es. T-shirt Android).

* È necessario impostare un valore tra ID o name.

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 id o name.

name testo *Sì

Il nome della promozione (ad es. Saldi estivi).

* È necessario impostare un valore tra id o name.

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 è purchase o refund

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:

  1. Aggiungi il codice di misurazione per misurare ogni passaggio della procedura di pagamento.
  2. 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'
    }
  ]
});