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 tuoi prodotti più popolari e vedere l'influenza delle promozioni e del posizionamento dei prodotti sulle entrate.

Questo documento descrive ogni evento di e-commerce e quando configurarlo. Per un esempio passo passo su 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 Google Analytics partecipando a un breve sondaggio online.

gtag.js 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à Google Analytics:

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. Per Nome evento, utilizza la variabile incorporata {{Event}}. Verrà utilizzato il nome dell'evento e-commerce di Google Analytics 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. Scopri tutti i tipi di attivatori disponibili.

8. Assegna un nome al tag e salva il tag.

Consigli

• Attiva la modalità di debug per visualizzare gli eventi in tempo reale e risolvere i problemi.
• Esamina i limiti delle dimensioni e delle metriche personalizzate quando invii parametri personalizzati con gli eventi di e-commerce.
• Imposta currency quando invii i dati value (entrate) per assicurarti che le metriche relative alle entrate vengano calcolate correttamente.
• Imposta ogni parametro di e-commerce per cui disponi di dati, indipendentemente dal fatto che sia facoltativo.
• Utilizza il sito web di e-commerce di esempio per vedere un esempio di come taggare il tuo sito web.

Implementazione

Una tipica implementazione e-commerce misura tutte le azioni elencate di seguito:

• Selezionare un elemento da un elenco
• Visualizzare i dettagli di un articolo
• Aggiunta/rimozione di un prodotto da un carrello degli acquisti
• Avviare la procedura di pagamento
• Eseguire 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 puoi aggiungere agli eventi di e-commerce. Puoi includere fino a 27 parametri personalizzati nell'array items, oltre ai parametri obbligatori.

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: 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
    }
]

Seleziona un articolo da un elenco

Quando a un utente viene presentato un elenco di risultati, invia un evento view_item_list incluso 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.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: view_item_list
• Variabili del livello dati (nome - Nome variabile livello dati):
• Articoli e-commerce - ecommerce.items
• ID elenco di articoli e-commerce: ecommerce.item_list_id
• Nome elenco articoli e-commerce - ecommerce.item_list_name
• Parametri evento (Nome parametro - Valore):
• items - {{Ecommerce Items}}
• item_list_id - {{Ecommerce Item List ID}}
• item_list_name - {{Ecommerce Item List Name}}
• Attivazione: evento uguale a view_item_list

Configurazione dell'attivatore:

• Tipo di trigger: 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 dell'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.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: select_item
• Variabili del livello dati (Nome - Nome variabile livello dati):
• Articoli e-commerce - ecommerce.items
• ID elenco di articoli e-commerce: ecommerce.item_list_id
• Nome elenco articoli e-commerce - ecommerce.item_list_name
• Parametri evento (Nome parametro - Valore):
• items - {{Ecommerce Items}}
• item_list_id - {{Ecommerce Item List ID}}
• item_list_name - {{Ecommerce Item List Name}}
• Attivazione: evento uguale a select_item

Configurazione dell'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: 10.01,
      quantity: 3
    }
    ]
  }
});

Visualizza dettagli elemento

Per misurare quante volte vengono visualizzati i dettagli degli articoli, 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.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: view_item
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• Attivazione: evento uguale a view_item

Configurazione attivatore:

• Tipo di trigger: 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 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 di e-commerce può essere utilizzata in alternativa alla seguente configurazione del tag.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: add_to_cart
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• Attivazione: evento uguale a add_to_cart

Configurazione dell'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: 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 il momento in cui un articolo 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 dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: add_to_wishlist
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• Attivazione: evento uguale a add_to_wishlist

Configurazione dell'attivatore:

• Tipo di trigger: 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 al suo interno. 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 dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: view_cart
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• Attivazione: evento uguale a view_cart

Configurazione dell'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: 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 quando 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: remove_from_cart
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• Attivazione: evento uguale a remove_from_cart

Configurazione dell'attivatore:

• Tipo di trigger: 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
    }
    ]
  }
});

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 con i campi pertinenti. Un coupon può anche essere aggiunto in questa fase all'intero ordine aggiungendolo all'evento o applicato a un determinato elemento aggiungendolo a elementi specifici nell'array items. Per 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.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: begin_checkout
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• coupon - {{Ecommerce Coupon}}
• Attivazione: evento uguale a begin_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: 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 "Trasporto terrestre", "Trasporto 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: add_shipping_info
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• coupon - {{Ecommerce Coupon}}
• shipping_tier - {{Ecommerce Shipping Tier}}
• Attivatore: evento uguale a add_shipping_info

Configurazione dell'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: 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 propri 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 di e-commerce può essere utilizzata in alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: add_payment_info
• Variabili del 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 - {{Ecommerce Items}}
• value - {{Ecommerce Value}}
• currency - {{Ecommerce Currency}}
• coupon - {{Ecommerce Coupon}}
• payment_type - {{Ecommerce Payment Type}}
• Attivazione: evento uguale a add_payment_info

Configurazione dell'attivatore:

• Tipo di trigger: 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 come alternativa alla seguente configurazione del tag.

Mostrami la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: purchase
• Articoli e-commerce - ecommerce.items
• ID transazione e-commerce: ecommerce.transaction_id
• Valore e-commerce - ecommerce.value
• Imposta per l'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 - {{Ecommerce Items}}
• transaction_id - {{Ecommerce Transaction ID}}
• value - {{Ecommerce Value}}
• tax - {{Ecommerce Tax}}
• shipping - {{Ecommerce Shipping}}
• currency - {{Ecommerce Currency}}
• coupon - {{Ecommerce Coupon}}
• Attivazione: evento uguale a purchase

Configurazione dell'attivatore:

• Tipo di trigger: 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 il transaction_id pertinente specificato e uno o più elementi definiti con item_id e quantity. Ti consigliamo di includere 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 come alternativa alla seguente configurazione del tag.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: refund
• Variabili del 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 per l'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 - {{Ecommerce Items}}
• transaction_id - {{Ecommerce Transaction ID}}
• value - {{Ecommerce Value}}
• tax - {{Ecommerce Tax}}
• shipping - {{Ecommerce Shipping}}
• currency - {{Ecommerce Currency}}
• coupon - {{Ecommerce Coupon}}
• Attivatore: evento uguale a refund

Configurazione dell'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: 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 refund sostituisce ecommerce_refund.

Applicare promozioni

L'e-commerce supporta la misurazione delle impressioni e dei clic delle promozioni interne, ad esempio dei banner mostrati per promuovere una vendita.

In genere, le impressioni delle promozioni vengono 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 di e-commerce può essere utilizzata in alternativa alla seguente configurazione del tag.

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Nome evento: view_promotion
• Variabili del livello dati (Nome - Nome variabile 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 - {{Ecommerce Creative Name}}
• creative_slot - {{Ecommerce Creative Slot}}
• promotion_id - {{Ecommerce Promotion ID}}
• promotion_name - {{Ecommerce Promotion Name}}
• items - {{Ecommerce Items}}
• Attivatore: evento uguale a view_promotion

Configurazione dell'attivatore:

• Tipo di trigger: 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 come parametro articolo. Per informazioni dettagliate sui parametri da inviare, consulta il riferimento sugli eventi.

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

Fammi vedere la configurazione del tag

Configurazione dei tag:

• Tipo di tag: Google Analytics: evento GA4
• Variabili del livello dati (Nome - Nome variabile 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 - {{Ecommerce Creative Name}}
• creative_slot - {{Ecommerce Creative Slot}}
• promotion_id - {{Ecommerce Promotion ID}}
• promotion_name - {{Ecommerce Promotion Name}}
• items - {{Ecommerce Items}}
• Tipo di variabile: variabile di livello dati - "ecommerce.items"
• Attivazione: evento uguale a select_promotion

Configurazione dell'attivatore:

• Tipo di trigger: 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
    }
    ]
  }
});

Utilizzare 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 con il livello dati: puoi fornire il valore del parametro items come parametro evento nella configurazione del tag.

Configurazione dei tag:

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

Impostazioni della variabile {{gaEcommerceData}}:

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

Nota :la configurazione del tag di esempio utilizza DOM Ready (gtm.dom) per attivare il tag evento Google Analytics: GA4. Devi utilizzare 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 articoli visualizzati da un utente vengano caricati prima di inviare l'evento.