Misurare l'e-commerce

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.

Hai 3 minuti? Aiutaci a migliorare la documentazione sull'e-commerce di GA4 partecipando a un breve sondaggio online.

Tag Google Tag Manager

Prima di iniziare

Aggiungere il tag di configurazione GA4 al sito web

Assicurati di aver aggiunto il tag Google Analytics: configurazione di GA4 al tuo sito web e di poter accedere ad Analytics e al codice sorgente del sito web.

Misurare gli eventi di e-commerce con il tag evento GA4

Per inviare eventi e parametri di e-commerce alla tua proprietà GA4:

1. Apri Google Tag Manager
2. Nell'area di lavoro, apri il menu Tag.
3. Crea un nuovo tag. Fai clic sulla casella Configurazione tag e seleziona il tag Google Analytics: evento GA4.
4. Per Nome evento, utilizza la variabile integrata {{Event}}. Verrà utilizzato il nome dell'evento di e-commerce GA4 inviato tramite l'API gtag.js.
5. In Altre impostazioni > E-commerce, seleziona Invia dati e-commerce.
6. In Origine dati, seleziona Livello dati.
7. Configura un attivatore per l'evento GA4, ad esempio quando un utente fa clic su un pulsante di pagamento. Visualizza tutti i tipi di attivatori disponibili.
8. Assegna un nome al tag e salva.

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 entrate value 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

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 Google Tag Manager.

Cancella l'oggetto e-commerce

Ti consigliamo di utilizzare il comando seguente per cancellare l'oggetto e-commerce prima di eseguire il push di un evento di e-commerce al livello dati. La cancellazione dell'oggetto impedirà a più eventi e-commerce di una pagina di influire gli uni sugli altri.

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }]
  }
});

Nota: l'evento purchase sostituisce ecommerce_purchase ed è diverso dall'evento in_app_purchase, che viene registrato automaticamente.

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

Nota: l'evento di rimborso sostituisce ecommerce_refund.

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

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.

Nota: l'opzione Invia dati e-commerce può essere utilizzata in alternativa alla seguente configurazione di tag.

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
    }
    ]
  }
});

Utilizza una variabile JavaScript personalizzata

Se il tuo sito web non supporta un livello dati, puoi utilizzare una variabile JavaScript personalizzata per chiamare una funzione che restituisce l'oggetto dati di e-commerce. Questo oggetto deve utilizzare la sintassi del livello dati mostrata in precedenza in questa guida, ad esempio:

// A Custom JavaScript Variable that returns an ecommerceData object
// that follows the data layer syntax.
function getEcommerceData() {
  var ecommerceProductData = [
    {
      item_name: "Stan and Friends Tee",
      item_id: "SKU_12345",  // ID is required.
      // Rest of the product data should follow the data layer syntax.
    },
    // Multiple products may be included.
  ];
  return ecommerceProductData;
}

Se scegli di utilizzare una variabile JavaScript personalizzata, puoi utilizzarla come faresti per il livello dati: puoi fornire il valore del parametro 'items' come parametro evento nella configurazione del tag.

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: qualsiasi
• Leggi i dati dalla variabile: {{gaEcommerceData}}
• Trigger: l'evento è uguale a gtm.dom

Impostazioni delle variabili gaEcommerceData

• Tipo di variabile: JavaScript personalizzato
• Corpo della funzione: utilizza l'esempio riportato sopra

Nota: la configurazione del tag di esempio utilizza Pronto per DOM (gtm.dom) per attivare il tag evento Google Analytics 4. Devi usare DOM Ready quando vuoi caricare tutti gli elementi di una pagina prima di inviare un evento, in modo da poter recuperare i valori dal Document Object Model (DOM). Ad esempio, puoi utilizzare DOM Ready per l'evento view_item_list in modo che gli elementi visualizzati da un utente vengano caricati prima di inviare l'evento.