Misura l'e-commerce

Puoi configurare gli eventi di e-commerce per raccogliere informazioni sul comportamento di acquisto degli utenti. Gli eventi ti consentono di quantificare i prodotti più popolari e vedere l'influenza delle promozioni e del posizionamento dei prodotti sulle entrate.

Questo articolo descrive ciascun evento di e-commerce e quando configurarlo. Per un esempio dettagliato di come configurare un evento di e-commerce, consulta 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 parametri ed eventi di e-commerce alla proprietà GA4:

1. Apri Google Tag Manager
2. Nell'area di lavoro, apri il menu Tag.
3. Crea un tag Nuovo. Fai clic sulla casella Configurazione tag e seleziona il tag Google Analytics: evento GA4.
4. In Nome evento, utilizza la variabile integrata {{Event}}. Verrà utilizzato il nome dell'evento e-commerce GA4 inviato utilizzando l'API gtag.js.
5. In Altre impostazioni > E-commerce, seleziona Invia dati di e-commerce.
6. Per 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. Vedi tutti i tipi di attivatori disponibili.
8. Assegna un nome al tag e salvalo.

Consigli

• Attiva la modalità di debug per visualizzare gli eventi in tempo reale e risolvere più facilmente i problemi.
• Esamina i limiti di dimensioni e metriche personalizzate quando invii parametri personalizzati con eventi di e-commerce
• Imposta currency quando invii dati di value (entrate) per garantire che le metriche delle entrate siano calcolate correttamente
• Imposta ogni parametro di e-commerce per cui disponi di dati, indipendentemente dal fatto che il parametro sia facoltativo
• Per vedere un esempio di come aggiungere i tag al tuo sito web, consulta il sito web di e-commerce di esempio.

Implementazione

Un'implementazione di e-commerce standard misura le seguenti azioni:

• Selezionare un elemento da un elenco
• Visualizza dettagli elemento
• Aggiungere/rimuovere un prodotto dal carrello
• Avvia la procedura di pagamento
• Effettuare acquisti o rimborsi
• Applicare promozioni

Il cuore di queste azioni sono i prodotti e i servizi che vendi. Puoi rappresentare prodotti e servizi come array di articoli che possono essere aggiunti a eventi di e-commerce. Oltre ai parametri prescritti, nell'array di articoli puoi includere fino a 27 parametri personalizzati.

L'esempio seguente mostra come creare la raccolta di items a cui si fa 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: 9.99,
      quantity: 1
    },
    {
      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: 20.99,
      quantity: 1
    }
]

Eseguire la migrazione da un'implementazione dell'e-commerce UA

Se hai già implementato l'e-commerce per Universal Analytics, puoi eseguire una delle seguenti operazioni per eseguire la migrazione a Google Analytics 4:

• Utilizza la tua implementazione dell'e-commerce UA per completare gli eventi di e-commerce GA4
• Sostituire l'implementazione dell'e-commerce UA con gli eventi di 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 inviare un evento di e-commerce al livello dati. La cancellazione dell'oggetto impedirà a più eventi di e-commerce in una pagina di interessarsi a vicenda.

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

Seleziona un elemento da un elenco

Quando a un utente viene presentato un elenco di risultati, invia un evento view_item_list che include 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: view_item_list
• Variabili livello dati (Nome - Nome variabile livello dati):
• Articoli e-commerce - ecommerce.items
• ID elenco di articoli 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&&brrace;}
• item_list_name - {{Nome elenco e-commerce articolo}}
• Attivatore: evento uguale a view_item_list

Configurazione attivatore:

• 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: 9.99,
      quantity: 1
    },
    {
      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: 20.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }]
  }
});

Dopo che un utente ha selezionato 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: select_item
• Variabili livello dati (Nome - Nome variabile livello dati):
• Articoli e-commerce - ecommerce.items
• ID elenco di articoli 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&&brrace;}
• item_list_name - {{Nome elenco e-commerce articolo}}
• Trigger: l'evento è uguale a select_item

Configurazione attivatore:

• 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: 9.99,
      quantity: 1
    }
    ]
  }
});

Visualizza dettagli elemento

Per misurare quante volte vengono visualizzati i dettagli dell'articolo, 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: view_item
• Variabili livello dati (Nome - Nome variabile 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_item

Configurazione attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Aggiungere o rimuovere un articolo da un carrello degli acquisti

Misura un articolo aggiunto a un 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: add_to_cart
• Variabili livello dati (Nome - Nome variabile 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 attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Puoi anche misurare quando un elemento viene aggiunto a una lista desideri inviando un evento add_to_wishlist con gli elementi 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: add_to_wishlist
• Variabili livello dati (Nome - Nome variabile 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 attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Quando in seguito un utente visualizza 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: view_cart
• Variabili livello dati (Nome - Nome variabile 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}}
• Attivatore: evento uguale a view_cart

Configurazione attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Per misurare quando un utente rimuove un articolo da un carrello, invia l'evento remove_from_cart. Per i dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: remove_from_cart
• Variabili livello dati (Nome - Nome variabile 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}}
• Attivatore: evento uguale a remove_from_cart

Configurazione attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Avvia la procedura di pagamento

Misura il primo passaggio di una procedura di pagamento inviando un evento begin_checkout con uno o più elementi definiti nei campi pertinenti. Un coupon può anche essere aggiunto in questa fase all'intero ordine aggiungendolo all'evento o applicandolo a un determinato elemento aggiungendolo a elementi specifici nell'array items. Per i dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: begin_checkout
• Variabili livello dati (Nome - Nome variabile 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: l'evento è uguale abegin_checkout

Configurazione attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Quando un utente va 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 "Trasporto terrestre", "Aereo" o "Giorno successivo". Per i dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: add_shipping_info
• Variabili livello dati (Nome - Nome variabile 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 attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Invia l'evento add_payment_info quando un utente invia i propri dati di pagamento. Se applicabile, includi payment_type con questo evento per il metodo di pagamento scelto. Per i dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: add_payment_info
• Variabili livello dati (Nome - Nome variabile 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;}
• pagamenti_type - {{Tipo di pagamento e-commerce}}
• Attivatore: evento uguale a add_payment_info

Configurazione attivatore:

• 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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del 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
• Imposta 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}}
• tasse - {{Tasse e-commerce}}
• shipping - {{Spedizione e-commerce}}
• currency - {{Valuta e-commerce}}
• coupon - {{Coupon e-commerce;}
• Trigger: l'evento è uguale all'acquisto

Configurazione attivatore:

• 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",
      value: 25.42,
      tax: 4.90,
      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: 9.99,
        quantity: 1
      },
      {
        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: 20.99,
        promotion_id: "P_12345",
        promotion_name: "Summer Sale",
        quantity: 1
      }]
  }
});

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 transaction_id specificato e uno o più elementi definiti con item_id e quantity. Ti consigliamo di includere le informazioni sull'articolo nell'evento refund per visualizzare le metriche sui rimborsi a livello di articolo in Analytics.

Per i dettagli sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: refund
• Variabili livello dati (Nome - Nome variabile livello dati):
• Articoli e-commerce - ecommerce.items
• ID transazione e-commerce - ecommerce.transaction_id
• Valore e-commerce - ecommerce.value
• Imposta 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}}
• tasse - {{Tasse e-commerce}}
• shipping - {{Spedizione e-commerce}}
• currency - {{Valuta e-commerce}}
• coupon - {{Coupon e-commerce;}
• Trigger: l'evento è uguale al rimborso

Configurazione attivatore:

• 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: 12.21,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

Nota: l'evento di rimborso sostituisce ecommerce_refund.

Applica promozioni

L'e-commerce include il supporto per misurare le impressioni e i clic di promozioni interne, ad esempio i banner visualizzati per promuovere una vendita.

In genere, le impressioni della promozione vengono misurate con la visualizzazione di schermata iniziale inviando l'evento view_promotion con un parametro articoli 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Nome evento: view_promotion
• Variabili livello dati (Nome - Nome variabile livello dati):
• Nome creatività di e-commerce - ecommerce.creative_name
• Area creatività di 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 - {{slot per le creatività e-commerce}}
• promotion_id - {{ID promozione e-commerce}}
• promotion_name - {{Nome promozione e-commerce}}
• items - {{Articoli e-commerce;
• Attivatore: evento uguale a view_promotion

Configurazione attivatore:

• 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: 9.99,
      quantity: 1
    }
    ]
  }
});

Per indicare che un utente ha fatto clic su una promozione, invia un evento select_promotion con questo articolo come parametro. Per informazioni dettagliate sui parametri da inviare, consulta la documentazione di riferimento sugli eventi.

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

Mostrami la configurazione del tag

Configurazione tag:

• Tipo di tag: evento GA4
• Variabili livello dati (Nome - Nome variabile livello dati):
• Nome creatività di e-commerce - ecommerce.creative_name
• Area creatività di 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 - {{slot per le creatività e-commerce}}
• promotion_id - {{ID promozione e-commerce}}
• promotion_name - {{Nome promozione e-commerce}}
• items - {{Articoli e-commerce;
• Tipo di variabile: Livello dati Variabile - 'ecommerce.items'
• Trigger: l'evento è uguale a select_promotion

Configurazione attivatore:

• 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: 9.99,
      quantity: 1
    }
    ]
  }
});

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 dovrebbe 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 una variabile JavaScript personalizzata, puoi utilizzarla allo stesso modo del 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: any
• Leggere i dati da Variabile: {{gaCommerceData}}
• Trigger: l'evento è uguale a gtm.dom

Impostazioni della variabile gaCommerceData

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

Nota: la configurazione del tag di esempio utilizza DOM Ready (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 recuperare i valori dal DOM (Document Object Model). Ad esempio, puoi utilizzare il protocollo DOM Ready per l'evento view_item_list in modo che gli elementi visualizzati da un utente vengano caricati prima di inviare l'evento.