Compatibilità degli eventi di e-commerce e riferimento alla traduzione (gtag.js)

Questo documento descrive la compatibilità e la conversione degli eventi di e-commerce tra Universal Analytics (UA) e Google Analytics 4 (GA4).

Contesto

Quando vengono inviati a una proprietà UA, gli eventi di e-commerce GA4 vengono convertiti automaticamente in eventi UA equivalenti. e quando invii eventi e-commerce UA a una proprietà GA4. Questo documento spiega come funziona la traduzione, la compatibilità degli eventi e gli eventuali compromessi che potresti dover fare quando fai affidamento sulla traduzione automatica.

Finalità

La traduzione tra eventi e-commerce UA e GA4 aiuta a:

• Facilità di implementazione: adotta l'e-commerce GA4 utilizzando l'implementazione UA esistente con un aggiornamento secondario della configurazione.
• Elimina la necessità del doppio tagging: puoi inviare gli stessi eventi di e-commerce a una proprietà UA e GA4. In questo modo è possibile passare a GA4 e mantenere l'implementazione dell'e-commerce UA, senza richiedere la manutenzione di una configurazione con due tag.

Compromissioni

La compatibilità offre la flessibilità necessaria per scegliere un percorso di migrazione a GA4 più appropriato per soddisfare i tuoi requisiti a breve e a lungo termine relativi alla manutenzione dell'implementazione UA.

La maggior parte degli eventi/parametri di e-commerce GA4 è compatibile con UA e viceversa. Per il numero ridotto di casi in cui esistono incompatibilità, a seconda della scelta di migrazione effettuata, i report sull'e-commerce di UA o GA4 potrebbero non essere compilati completamente con i dati.

È importante esaminare ogni opzione di migrazione per i dettagli sulla compatibilità e sulla configurazione richiesta.

Come funziona la traduzione

• Quando un evento di e-commerce GA4 viene inviato a una proprietà UA, viene convertito nell'evento di e-commerce UA (gtag.js) equivalente.
  • I parametri evento UA vengono compilati con i valori di parametri GA4 paragonabili. Se un parametro UA non può essere compilato da un evento GA4 (ovvero non esiste un parametro paragonabile), il parametro verrà omesso quando l'evento viene inviato alla proprietà UA.
• Quando un evento di e-commerce UA (gtag.js) viene inviato a una proprietà GA4, viene tradotto nell'evento di e-commerce GA4 equivalente.
  • I parametri evento GA4 vengono compilati con i valori di parametri UA paragonabili. Se un parametro GA4 non può essere compilato da un evento UA (ovvero non esiste un parametro equivalente), il parametro verrà omesso quando l'evento viene inviato alla proprietà GA4. In alcuni casi, se un parametro UA non ha un parametro GA4 confrontabile, il parametro verrà inviato con l'evento GA4 come parametro personalizzato.
• Tutte le traduzioni da GA4 a UA e viceversa vengono eseguite sul lato client.
• Le traduzioni di eventi/parametri sono abilitate per impostazione predefinita, non è richiesta alcuna configurazione utente e non possono essere disattivate.

Parametri paragonabili per UA e GA4

La tabella seguente mostra parametri di e-commerce paragonabili per Universal Analytics e Google Analytics 4.

Nota: una cella vuota nella tabella indica che non esiste un parametro simile.

Nome parametro Universal Analytics	Nome parametro Google Analytics 4	Note
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	Quando invii un evento UA a una proprietà GA4, questo valore di valuta verrà utilizzato per il parametro items[].currency di GA4.
	location_id
	payment_type
shipping	shipping
shipping_tier
tax	tax
transaction_id	transaction_id
value	value
items[]	items[]
items[].name	items[].item_name
items[].id	items[].item_id
	items[].affiliation
items[].brand	items[].item_brand
items[].category	items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5	La categoria dell'articolo. È possibile specificare fino a 5 livelli di gerarchia. Per informazioni dettagliate su come viene gestita la traduzione delle categorie tra gli eventi UA e GA4, consulta Traduzione dei parametri di categoria.
	items[].currency
items[].coupon	items[].coupon
	items[].discount
items[].list_name	items[].item_list_name
items[].list_position	items[].index
	items[].location_id
items[].price	items[].price
items[].quantity	items[].quantity
items[].variant	items[].item_variant
promotions[]		Per GA4, il valore items[] viene utilizzato con i parametri specifici della promozione come items[].promotion_id.
promotions[].id	items[].promotion_id	Questi parametri non vengono tradotti quando si invia un evento UA a GA4 o viceversa.
promotions[].name	items[].promotion_name	Questi parametri non vengono tradotti quando si invia un evento UA a GA4 o viceversa.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	Questi parametri non vengono tradotti quando si invia un evento UA a GA4 o viceversa.

Traduzione dei parametri di categoria

La traduzione del parametro di categoria viene gestita come un caso speciale quando vengono inviati eventi GA4 a UA o viceversa.

Per Universal Analytics, quando imposti il parametro items[].category, utilizzi / come delimitatore per specificare fino a cinque livelli di gerarchia. In Google Analytics 4, utilizzi i parametri di categoria enumerati per specificare fino a cinque livelli gerarchici: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 e items[].item_category5.

Il comportamento della traduzione delle categorie è il seguente:

• Per gli eventi GA4 convertiti in UA, le categorie elencate verranno combinate in un singolo parametro category, con ogni categoria delimitata da /.
• Per gli eventi UA convertiti in GA4, il valore del parametro della categoria verrà suddiviso per completare le categorie GA4 enumerate corrispondenti.
• Se intendi inviare eventi GA4 a UA, ti consigliamo di non utilizzare il carattere / nei valori delle categorie, poiché verrà interpretato come un delimitatore di categoria durante la traduzione in UA.
• Verranno utilizzati solo i primi 5 livelli di categoria, indipendentemente da quanti sono definiti.

Esempio di traduzione di categorie

I seguenti esempi mostrano un parametro di categoria UA convertito in GA4. Lo stesso principio vale per la traduzione di un evento GA4 in UA.

Un evento UA con una categoria che definisce cinque livelli di gerarchia:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

L'evento UA viene convertito in un evento GA4, con le categorie enumerate:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

Compatibilità tra gli eventi UA e GA4

La tabella seguente mostra eventi di e-commerce paragonabili per Universal Analytics e Google Analytics 4 e il comportamento di traduzione quando si invia un evento UA a GA4 e viceversa.

Per ogni riga della tabella, ogni colonna fornisce le seguenti informazioni:

• Le colonne evento UA ed evento GA4 indicano eventi paragonabili in base a ciò che sono destinati a misurare.
• La sezione Parametri elenca i parametri senza equivalenti tra i rispettivi eventi UA e GA4. Solo GA4 elenca i parametri utilizzati solo con l'evento GA4 e solo UA elenca i parametri utilizzati solo con l'evento UA.
• Il comportamento di traduzione (invio da UA a GA4) descrive il comportamento della traduzione quando si invia un evento UA a una proprietà GA4. Le note forniscono dettagli sui dati inviati, sulle differenze rispetto all'evento GA4 e su eventuali effetti degni di nota sui report GA4.
• Il comportamento di traduzione (invio di GA4 a UA) descrive il comportamento della traduzione quando si invia un evento UA a una proprietà GA4. Le note forniscono dettagli sui dati inviati, sulle differenze rispetto all'evento UA e su eventuali effetti degni di nota sui report UA.

Evento UA	Evento GA4	Parametri	Comportamento di traduzione (invio da UA a GA4)	Comportamento della traduzione (invio di GA4 a UA)
view_item_list	view_item_list	Solo per GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati. I parametri solo GA4 non vengono inviati. Il parametro item_list_name a livello di evento viene ignorato; verrà inviato solo il parametro item_list_name a livello di articolo. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.
select_content (items)	select_item	Solo per GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id Solo UA: content_type	Non compatibile. Vengono inviati un evento personalizzato select_content e un parametro personalizzato content_type. Nessun dato su items inviato.	Non compatibile. Un hit da evento di UA viene inviato con generale come event_category e select_item come event_action. Nessun dato items inviato.
select_content (promotions)	select_promotion	Solo per GA4: creative_name creative_slot location_id promotion_id promotion_name items Solo UA: content_type promotions	Non compatibile. Viene inviato un evento personalizzato select_content con content_type e promotions come parametri personalizzati. Il parametro personalizzato promotions non contiene dati utili.	Non compatibile. Un hit da evento di UA viene inviato con generale come event_category e select_promotion come event_action. Nessun dato promotions inviato.
view_item	view_item	Solo per GA4: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati. L'eccezione è item_list_name, che non viene inviata. Dei parametri solo GA4, currency e value vengono inviati con l'hit rispettivamente come valuta ed Entrate da transazioni. Anche event_value è impostato sul parametro value, come numero intero. Tieni presente che la traduzione da GA4 a UA include event_value, ma di solito non è impostata per gli hit di UA. I report UA compilati con i dati di GA4 saranno per lo più completi / invariate. Manca il nome dell'elenco di articoli.
add_to_wishlist* *I dati di items non sono supportati per UA.	add_to_wishlist	Solo per GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. Un hit da evento equivalente viene inviato con ecommerce come event_category, add_to_wishlist come event_action e il parametro value come event_value. I report UA completati con i dati dell'evento GA4 saranno completi o invariati. Poiché questo evento non è generalmente supportato nei report sull'e-commerce di UA, non avrà alcun effetto rilevante.
add_to_cart	add_to_cart	Solo per GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati.* I parametri solo GA4 non vengono inviati. *Il valore item_list_name non viene inviato, ma questo comportamento è coerente con gtag.js (UA), che non invia list_name. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.
remove_from_cart	remove_from_cart	Solo per GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati.* I parametri solo GA4 non vengono inviati. *Il valore item_list_name non viene inviato, ma questo comportamento è coerente con gtag.js (UA), che non invia list_name. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.
N/A	view_cart	L'evento è consigliato solo per GA4.	Non compatibile*. *È improbabile che la tua implementazione di UA invii questo evento perché non è consigliato. Per assicurarti che i report GA4 siano completi, puoi implementare questo evento per UA utilizzando il formato GA4. Se implementi l'evento GA4 per UA, verrà visualizzato come evento senza dati items, il che potrebbe non essere molto utile. Questo non influirà sui report sull'e-commerce di UA.	Non compatibile. Un hit da evento viene inviato con general come event_category, view_cart come event_action e il parametro value come event_value. I dati relativi a items non vengono inviati. Poiché questo evento non è generalmente supportato nei report sull'e-commerce di UA, non avrà alcun effetto rilevante.
begin_checkout	begin_checkout	Solo per GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati.* I parametri solo GA4 non vengono inviati. *Il valore item_list_name non viene inviato, ma questo comportamento è coerente con gtag.js (UA), che non invia list_name. begin_checkout equivale a inviare un evento checkout_progress con checkout_step impostato su 1. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.
add_payment_info	add_payment_info	Solo per GA4: currency value coupon payment_type items UA: N/D: i parametri non sono supportati.	Non compatibile*. *Poiché UA non supporta i parametri per questo evento, non ne viene inviato nessuno. Funzionerà, ma probabilmente non sarà molto utile. I report GA4 che richiedono parametri evento saranno incompleti.	Compatibile. Un hit da evento equivalente viene inviato con ecommerce come event_category, add_to_wishlist come event_action e il parametro value (trasmesso a numero intero) come event_value. Tieni presente che la traduzione da GA4 a UA include event_value, ma di solito non è impostata per gli hit di UA. I report UA completati con i dati dell'evento GA4 saranno completi o invariati. Poiché questo evento non è generalmente supportato nei report sull'e-commerce di UA, non avrà alcun effetto rilevante.
N/A	add_shipping_info	L'evento è consigliato solo per GA4.	Non compatibile*. *È improbabile che la tua implementazione di UA invii questo evento perché non è consigliato. Per assicurarti che i report GA4 siano completi, puoi implementare questo evento per UA utilizzando il formato GA4. Se implementi l'evento GA4 per UA, verrà visualizzato come evento senza dati items, il che potrebbe non essere molto utile. Questo non influirà sui report sull'e-commerce di UA.	Non compatibile*. Un hit da evento viene inviato con general come event_category, add_shipping_info come event_action e il parametro value (trasmesso in numero intero) come event_value. Il parametro currency di GA4 viene inviato con l'hit come valuta. Poiché questo evento non è generalmente supportato nei report sull'e-commerce di UA, non avrà alcun effetto rilevante.
checkout_progress set_checkout_option	N/A	Gli eventi sono consigliati solo per UA.	L'evento verrà considerato come evento personalizzato. Verranno inviati solo i parametri a livello di evento. Non verranno inviati dati items. Poiché questi eventi non sono generalmente supportati nei report sull'e-commerce di GA4, non avranno effetti significativi.	N/A
view_promotion	view_promotion	Solo per GA4: creative_name creative_slot location_id promotion_id promotion_name items Solo UA: promotions	Non compatibile. Viene inviato un evento personalizzato view_promotion con promotions come parametro personalizzato. Il parametro personalizzato promotions non contiene dati utili.	Non compatibile. Un hit da evento di UA viene inviato con engagement come event_category e view_promotion come event_action. Nessun dato promotions inviato. L'evento viene contrassegnato come evento di non interazione.
purchase	purchase	Solo per GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. Viene utilizzato l'attributo currency a livello di evento perché l'elemento currency a livello di articolo non è supportato. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati.* I parametri solo GA4 non vengono inviati. *Il valore item_list_name non viene inviato, ma questo comportamento è coerente con gtag.js (UA), che non invia list_name. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.
refund	refund	Solo per GA4: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatibile. Tutti i parametri UA vengono convertiti in equivalenti GA4 e inviati. Viene utilizzato l'attributo currency a livello di evento perché l'elemento currency a livello di articolo non è supportato. I report GA4 che richiedono parametri solo GA4 saranno incompleti.	Compatibile. I parametri GA4 con un parametro UA equivalente vengono tradotti e inviati.* I parametri solo GA4 non vengono inviati. *Il valore item_list_name non viene inviato, ma questo comportamento è coerente con gtag.js (UA), che non invia list_name. I report UA completati con i dati dell'evento GA4 saranno completi o invariati.