Documentation de référence sur la compatibilité et la traduction des événements d'e-commerce (gtag.js)

Ce document décrit la compatibilité des événements d'e-commerce et la traduction entre Universal Analytics (UA) et Google Analytics 4 (GA4).

Contexte

Les événements d'e-commerce GA4 sont automatiquement convertis en événements UA équivalents lorsqu'ils sont envoyés à une propriété UA. La traduction se produit également lors de l'envoi d'événements d'e-commerce UA à une propriété GA4. Ce document explique le fonctionnement de la traduction, la compatibilité des événements et les compromis que vous pouvez avoir à faire lorsque vous utilisez la traduction automatique.

Objectif

La traduction entre les événements d'e-commerce UA et GA4 aide à:

• Facilité d'implémentation: adoptez l'e-commerce GA4 en utilisant votre implémentation UA existante avec une mise à jour mineure de la configuration.
• Élimination du besoin de double taggage: vous pouvez envoyer les mêmes événements d'e-commerce à une propriété UA et GA4. Cela permet de passer à GA4 et de conserver votre implémentation de l'e-commerce UA sans avoir à gérer une configuration à deux balises.

Compromis

La compatibilité vous permet de choisir le chemin de migration GA4 le plus approprié pour répondre à vos exigences à court et long terme concernant la gestion de votre implémentation UA.

La plupart des événements/paramètres d'e-commerce GA4 sont compatibles avec UA, et inversement. Dans le petit nombre de cas où des incompatibilités existent, en fonction du choix de migration que vous choisissez, vos rapports sur l'e-commerce UA ou GA4 ne seront peut-être pas entièrement remplis de données.

Il est important de passer en revue chaque option de migration pour en savoir plus sur la compatibilité et la configuration requise.

Fonctionnement de la traduction

• Lorsqu'un événement d'e-commerce GA4 est envoyé à une propriété UA, il est converti en événement d'e-commerce UA (gtag.js) équivalent.
  • Les paramètres d'événement UA sont renseignés avec des valeurs provenant de paramètres GA4 comparables. Si un paramètre UA ne peut pas être renseigné à partir d'un événement GA4 (c'est-à-dire s'il n'existe pas de paramètre comparable), il est omis lorsque l'événement est envoyé à la propriété UA.
• Lorsqu'un événement d'e-commerce UA (gtag.js) est envoyé à une propriété GA4, il est converti en événement d'e-commerce GA4 équivalent.
  • Les paramètres d'événement GA4 sont renseignés avec des valeurs provenant de paramètres UA comparables. Si un paramètre GA4 ne peut pas être renseigné à partir d'un événement UA (c'est-à-dire s'il n'existe pas de paramètre équivalent), il est omis lorsque l'événement est envoyé à la propriété GA4. Dans certains cas, si un paramètre UA n'a pas de paramètre GA4 comparable, il sera envoyé avec l'événement GA4 en tant que paramètre personnalisé.
• Toutes les traductions de GA4 vers UA et inversement sont effectuées côté client.
• La traduction d'événements/de paramètres est activée par défaut. Aucune configuration utilisateur n'est requise et ne peut pas être désactivée.

Paramètres comparables pour UA et GA4

Le tableau suivant présente des paramètres d'e-commerce comparables pour Universal Analytics et Google Analytics 4.

Remarque :Une cellule de tableau vide indique qu'il n'existe pas de paramètre comparable.

Nom du paramètre Universal Analytics	Nom du paramètre Google Analytics 4	Notes
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	Lorsque vous envoyez un événement UA à une propriété GA4, cette valeur de devise est utilisée pour le paramètre items[].currency de 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	Catégorie de l'article Vous pouvez spécifier jusqu'à cinq niveaux de hiérarchie. Consultez Traduction des paramètres de catégorie pour en savoir plus sur la traduction de catégories entre les événements UA et GA4.
	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[]		Pour GA4, items[] est utilisé avec des paramètres spécifiques à la promotion, tels que items[].promotion_id.
promotions[].id	items[].promotion_id	Ces paramètres ne sont pas traduits lorsque vous envoyez un événement UA à GA4, ou inversement.
promotions[].name	items[].promotion_name	Ces paramètres ne sont pas traduits lorsque vous envoyez un événement UA à GA4, ou inversement.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	Ces paramètres ne sont pas traduits lorsque vous envoyez un événement UA à GA4, ou inversement.

Traduction des paramètres de catégorie

La traduction du paramètre de catégorie est gérée comme un cas particulier lors de l'envoi d'événements GA4 à UA, ou inversement.

Pour Universal Analytics, lorsque vous définissez le paramètre items[].category, vous utilisez / comme délimiteur afin de spécifier jusqu'à cinq niveaux de hiérarchie. Dans Google Analytics 4, vous utilisez des paramètres de catégorie énumérés pour spécifier jusqu'à cinq niveaux de hiérarchie: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 et items[].item_category5.

Le comportement de la traduction de catégorie est le suivant:

• Pour les événements GA4 traduits en UA, les catégories énumérées seront combinées en un seul paramètre category, chaque catégorie étant délimitée par /.
• Pour les événements UA traduits dans GA4, la valeur du paramètre de catégorie est divisée pour renseigner les catégories GA4 énumérées correspondantes.
• Si vous avez l'intention d'envoyer des événements GA4 à UA, nous vous recommandons de ne pas utiliser le caractère / dans les valeurs de catégorie, car il sera interprété comme un délimiteur de catégorie lors de la traduction vers UA.
• Seuls les cinq premiers niveaux de catégorie seront utilisés, quel que soit le nombre défini.

Exemple de traduction de catégories

Les exemples suivants illustrent un paramètre de catégorie UA traduit en GA4. Le même principe s'applique lors de la traduction d'un événement GA4 en UA.

Un événement UA avec une catégorie qui définit cinq niveaux de hiérarchie:

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

Événement UA converti en événement GA4, avec des catégories énumérées:

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

Compatibilité entre les événements UA et GA4

Le tableau ci-dessous présente des événements d'e-commerce comparables pour Universal Analytics et Google Analytics 4, ainsi que le comportement de traduction lors de l'envoi d'un événement UA à GA4, et inversement.

Pour chaque ligne du tableau, chaque colonne fournit les informations suivantes:

• Les colonnes Événement UA et Événement GA4 indiquent des événements comparables en fonction de ce qu'ils sont destinés à mesurer.
• La section Paramètres liste les paramètres sans équivalent entre les événements UA et GA4 respectifs. GA4 uniquement liste les paramètres qui ne sont utilisés qu'avec l'événement GA4 et UA uniquement répertorie les paramètres qui ne sont utilisés qu'avec l'événement UA.
• Le comportement de traduction (envoi d'UA à GA4) décrit le comportement de traduction lors de l'envoi d'un événement UA à une propriété GA4. Les notes fournissent des détails sur les données envoyées, les différences par rapport à l'événement GA4 et les effets notables sur les rapports GA4.
• Le comportement de traduction (envoi de GA4 à UA) décrit le comportement de traduction lors de l'envoi d'un événement UA à une propriété GA4. Les notes fournissent des détails sur les données envoyées, les différences par rapport à l'événement UA et les effets notables sur les rapports UA.

Événement UA	Événement GA4	Paramètres	Comportement de la traduction (envoi d'UA vers GA4)	Comportement de la traduction (envoi de GA4 à UA)
view_item_list	view_item_list	GA4 uniquement: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés. Les paramètres GA4 uniquement ne sont pas envoyés. Le paramètre item_list_name au niveau de l'événement est ignoré. Seule la valeur item_list_name au niveau de l'article est envoyée. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.
select_content (items)	select_item	GA4 uniquement: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id UA uniquement: content_type	Non compatible. Un événement personnalisé select_content et un paramètre personnalisé content_type sont envoyés. Aucune donnée items n'est envoyée.	Non compatible. Un appel avec événement UA est envoyé avec general pour event_category et select_item pour event_action. Aucune donnée items n'est envoyée.
select_content (promotions)	select_promotion	GA4 uniquement: creative_name creative_slot location_id promotion_id promotion_name items UA uniquement: content_type promotions	Non compatible. Un événement personnalisé select_content est envoyé avec content_type et promotions en tant que paramètres personnalisés. Le paramètre personnalisé promotions ne contient aucune donnée utile.	Non compatible. Un appel avec événement UA est envoyé avec general pour event_category et select_promotion pour event_action. Aucune donnée promotions n'est envoyée.
view_item	view_item	GA4 uniquement: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés. L'exception est item_list_name, qui n'est pas envoyée. Parmi les paramètres GA4 uniquement, currency et value sont envoyés avec l'appel en tant que devise et revenus des transactions, respectivement. event_value est également défini sur le paramètre value sous la forme d'un entier. Notez que la traduction de GA4 vers UA inclut event_value, mais elle n'est généralement pas définie pour les appels UA. Les rapports UA contenant des données provenant de GA4 seront pour la plupart complets ou inchangés. Le nom de la liste d'articles sera manquant.
add_to_wishlist* *Les données items ne sont pas compatibles avec UA.	add_to_wishlist	GA4 uniquement: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Un appel avec événement équivalent est envoyé avec ecommerce sous la forme event_category, add_to_wishlist défini sur event_action et le paramètre value défini comme étant event_value. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés. Étant donné que cet événement n'est généralement pas compatible avec les rapports sur l'e-commerce UA, il n'aura aucun effet remarquable.
add_to_cart	add_to_cart	GA4 uniquement: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés*. Les paramètres GA4 uniquement ne sont pas envoyés. *item_list_name n'est pas envoyé, mais ce comportement est cohérent avec gtag.js (UA), qui n'envoie pas list_name. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.
remove_from_cart	remove_from_cart	GA4 uniquement: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés*. Les paramètres GA4 uniquement ne sont pas envoyés. *item_list_name n'est pas envoyé, mais ce comportement est cohérent avec gtag.js (UA), qui n'envoie pas list_name. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.
N/A	view_cart	L'événement n'est recommandé que pour GA4.	Non compatible*. *Il est peu probable que votre implémentation d'UA envoie cet événement, car il ne s'agit pas d'un événement recommandé. Pour vous assurer que les rapports GA4 sont complets, vous pouvez implémenter cet événement pour UA à l'aide du format GA4. Si vous implémentez l'événement GA4 pour UA, il apparaîtra en tant qu'événement sans données items, ce qui peut ne pas être très utile. Cela n'aura aucune incidence sur les rapports sur l'e-commerce UA.	Non compatible. Un appel avec événement est envoyé avec general comme event_category, view_cart comme event_action et le paramètre value comme event_value. Les données items ne sont pas envoyées. Étant donné que cet événement n'est généralement pas compatible avec les rapports sur l'e-commerce UA, il n'aura aucun effet remarquable.
begin_checkout	begin_checkout	GA4 uniquement: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés*. Les paramètres GA4 uniquement ne sont pas envoyés. *item_list_name n'est pas envoyé, mais ce comportement est cohérent avec gtag.js (UA), qui n'envoie pas list_name. begin_checkout équivaut en réalité à l'envoi d'un événement checkout_progress avec checkout_step défini sur 1. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.
add_payment_info	add_payment_info	GA4 uniquement: currency value coupon payment_type items UA: N/A: les paramètres ne sont pas acceptés.	Non compatible*. *UA n'étant pas compatible avec les paramètres de cet événement, aucun n'est envoyé. Cela fonctionnera, mais ne sera probablement pas très utile. Les rapports GA4 qui nécessitent des paramètres d'événement seront incomplets.	Compatible. Un appel avec événement équivalent est envoyé avec ecommerce sous la forme event_category, add_to_wishlist sous la forme event_action et le paramètre value (converti en entier) en event_value. Notez que la traduction de GA4 vers UA inclut event_value, mais elle n'est généralement pas définie pour les appels UA. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés. Étant donné que cet événement n'est généralement pas compatible avec les rapports sur l'e-commerce UA, il n'aura aucun effet notable.
N/A	add_shipping_info	L'événement n'est recommandé que pour GA4.	Non compatible*. *Il est peu probable que votre implémentation d'UA envoie cet événement, car il ne s'agit pas d'un événement recommandé. Pour vous assurer que les rapports GA4 sont complets, vous pouvez implémenter cet événement pour UA à l'aide du format GA4. Si vous implémentez l'événement GA4 pour UA, il apparaîtra en tant qu'événement sans données items, ce qui peut ne pas être très utile. Cela n'aura aucune incidence sur les rapports sur l'e-commerce UA.	Non compatible*. Un appel avec événement est envoyé avec general comme event_category, add_shipping_info comme event_action et le paramètre value (converti en entier) en event_value. Le paramètre currency de GA4 est envoyé avec l'appel en tant que devise. Étant donné que cet événement n'est généralement pas compatible avec les rapports sur l'e-commerce UA, il n'aura aucun effet notable.
checkout_progress set_checkout_option	N/A	Les événements ne sont recommandés que pour UA.	L'événement sera traité comme un événement personnalisé. Seuls les paramètres au niveau de l'événement seront envoyés. Aucune donnée items ne sera envoyée. Étant donné que ces événements ne sont généralement pas compatibles avec les rapports sur l'e-commerce GA4, ils n'auront aucun effet remarquable.	N/A
view_promotion	view_promotion	GA4 uniquement: creative_name creative_slot location_id promotion_id promotion_name items UA uniquement: promotions	Non compatible. Un événement personnalisé view_promotion est envoyé avec promotions comme paramètre personnalisé. Le paramètre personnalisé promotions ne contient aucune donnée utile.	Non compatible. Un appel avec événement UA est envoyé avec engagement en tant que event_category et view_promotion en tant que event_action. Aucune donnée promotions n'est envoyée. L'événement est marqué comme événement sans interaction.
purchase	purchase	GA4 uniquement: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. L'attribut currency au niveau de l'événement est utilisé, car l'attribut currency au niveau de l'article n'est pas accepté. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés*. Les paramètres GA4 uniquement ne sont pas envoyés. *item_list_name n'est pas envoyé, mais ce comportement est cohérent avec gtag.js (UA), qui n'envoie pas list_name. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.
refund	refund	GA4 uniquement: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	Compatible. Tous les paramètres UA sont traduits en équivalents GA4 et envoyés. L'attribut currency au niveau de l'événement est utilisé, car l'attribut currency au niveau de l'article n'est pas accepté. Les rapports GA4 qui nécessitent des paramètres GA4 uniquement seront incomplets.	Compatible. Les paramètres GA4 ayant un paramètre UA équivalent sont traduits et envoyés*. Les paramètres GA4 uniquement ne sont pas envoyés. *item_list_name n'est pas envoyé, mais ce comportement est cohérent avec gtag.js (UA), qui n'envoie pas list_name. Les rapports UA contenant les données de l'événement GA4 seront complets ou inchangés.