E-commerce GA4 (analytics.js – E-commerce standard): envoyer les événements d'e-commerce GA4

Ce guide explique comment migrer une implémentation d'e-commerce standard existante pour analytics.js Universal Analytics afin d'utiliser des événements d'e-commerce Google Analytics 4.

Consultez le Centre de migration pour les développeurs afin d'obtenir des ressources et des guides de migration supplémentaires.

Résultat

Si vous suivez ce guide, votre nouvelle intégration Google Analytics 4 enverra les événements d'e-commerce GA4 à une nouvelle propriété GA4 et à une propriété Universal Analytics existante. La propriété Universal Analytics existante recevra les données d'e-commerce GA4, mais les rapports ne seront pas modifiés.

La migration se déroule en deux phases:

  • Migrer les transactions UA vers un événement d'achat GA4
    • L'e-commerce standard pour Universal Analytics accepte l'envoi de données sur les transactions et les articles. La migration vers un événement purchase Google Analytics 4 offrira des fonctionnalités équivalentes.
  • (Facultatif) Mesurer des événements d'e-commerce GA4 supplémentaires

Avant de commencer

  1. Vérifiez que votre implémentation actuelle est décrite comme suit:

    • Vous utilisez une propriété Universal Analytics.
      • Si votre propriété dispose d'un ID de suivi, il s'agit d'Universal Analytics.
    • Votre site utilise la bibliothèque analytics.js pour envoyer des événements d'e-commerce.

  2. Consultez les options de migration pour l'implémentation de l'e-commerce afin d'en savoir plus sur les avantages et les inconvénients propres à chaque option. Vérifiez que vous souhaitez vraiment suivre ce guide afin d'utiliser les événements d'e-commerce Google Analytics 4 pour votre intégration Universal Analytics existante.

  3. Consultez la documentation de référence sur la compatibilité des événements pour découvrir comment l'événement d'achat GA4 est traduit lorsqu'il est envoyé à une propriété UA.

Compromis et considérations

Examinez les informations ci-dessous pour bien comprendre les conséquences de l'utilisation d'événements d'e-commerce Google Analytics 4 avec votre implémentation de l'e-commerce Universal Analytics.

Avantages Inconvénients
  • Affichez les données d'e-commerce dans les rapports GA4 et Universal Analytics.
  • La migration vers l'événement purchase de GA4 fournira des rapports UA complets sur l'e-commerce.
  • Tâches supplémentaires pour migrer d'analytics.js vers gtag.js. Nous vous recommandons de migrer toutes les mesures personnalisées d'analytics.js vers gtag.js (par exemple, les événements, les pages vues, le calendrier, etc.).

Implémentation

1. Migrez les mesures UA d'analytics.js vers gtag.js

Pour envoyer des événements d'e-commerce GA4, vous devez migrer d'analytics.js vers gtag.js, y compris toute mesure personnalisée.

En règle générale, la migration comprend les étapes suivantes:

  1. Supprimez l'extrait analytics.js.
  2. Installez la balise Google (gtag.js) et configurez-la avec l'ID de suivi de votre propriété UA.
  3. Migrez votre code de mesure personnalisé d'analytics.js vers gtag.js. Les sections ci-dessous décrivent comment migrer une transaction e-commerce standard. Consultez Migration des mesures pour obtenir de l'aide générale sur la migration d'autres scénarios de mesure.

Avant: balise analytics.js

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');    // Universal Analytics property.
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

Après: balise Google (gtag.js)

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');    // Universal Analytics property.
</script>

2. Mettez à jour votre implémentation de l'e-commerce pour envoyer des événements GA4.

Mettez à jour votre implémentation d'e-commerce existante pour passer des événements d'e-commerce Universal Analytics aux événements Google Analytics 4. Une fois cette étape terminée, votre propriété Universal Analytics recevra un événement purchase GA4. Consultez la section Compromis et considérations pour comprendre les implications de cette mise à jour.

L'exemple ci-dessous montre comment migrer un événement de transaction d'e-commerce standard analytics.js vers un événement d'e-commerce purchase GA4 équivalent, compatible avec Universal Analytics.

Avant: transaction e-commerce standard UA (analytics.js)

L'exemple suivant illustre une implémentation de l'e-commerce analytics.js standard pour une transaction comportant deux articles:

// Add the transaction.
ga('ecommerce:addTransaction', {
  id: '1234',     // Transaction ID.
  affiliation: 'Google Store',
  revenue: '29.97',
  shipping: '5.25',
  tax: '2.42'
});

// Add the items belonging to the transaction.
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Android Warhol T-Shirt',
  sku: 'P12345',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '12.99',
  quantity: '2'
});
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Flame challenge T-Shirt',
  sku: 'P67890',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '3.99',
  quantity: '1'
});
ga('ecommerce:send');

Après: achat en ligne GA4 (gtag.js)

Lors de la migration d'un événement de transaction analytics.js vers un événement purchase GA4, les principales différences sont les suivantes:

  • GA4 comporte un seul événement purchase qui inclut tous les détails et tous les éléments liés à la transaction. analytics.js exécute plusieurs commandes d'e-commerce ga() pour capturer les mêmes informations.
  • GA4 dispose d'un seul champ transaction_id pour l'ensemble de l'événement. analytics.js exige que l'ID de transaction soit inclus dans chaque élément.
  • GA4 comporte plusieurs champs de catégorie d'article. analytics.js utilise un seul champ de catégorie avec un délimiteur / pour décrire les hiérarchies. Toutefois, les événements GA4 comportant plusieurs champs de catégorie d'article fonctionneront pour votre propriété UA en raison de la traduction des paramètres de catégorie.
 gtag('event', 'purchase', {
   currency: 'USD',
   transaction_id: '1234',    // Transaction ID.
   value: 29.97,
   affiliation: 'Google Store',
   shipping: 5.25,
   tax: 2.42,
   items: [
    {
      item_id: 'P12345',     // Item ID.
      item_name: 'Android Warhol T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 12.99,
      quantity: 2
    },
    {
      item_id: 'P67890',    // Item ID.
      item_name: 'Flame challenge T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 3.99,
      quantity: 1
    }
  ]
});

3. Créer et configurer une propriété GA4

Une fois que vous avez mis à jour votre implémentation de l'e-commerce pour envoyer des événements d'e-commerce GA4, effectuez l'une des options suivantes pour commencer à envoyer des données à une nouvelle propriété Google Analytics 4.

Option 1: Utiliser l'assistant de configuration GA4 et activer les site tags associés

L'assistant de configuration GA4 crée automatiquement une propriété GA4 et copie les paramètres suivants depuis votre propriété Universal Analytics: nom de la propriété, URL du site Web, fuseau horaire et paramètres de devise. Il peut également activer la fonctionnalité de site tag associé afin de réutiliser votre implémentation gtag.js Universal Analytics existante pour charger votre nouvelle propriété GA4.

Suivez les étapes décrites dans l'assistant de configuration GA4 pour créer et configurer une propriété Google Analytics 4. Veillez à cocher l'option Activer la collecte de données à l'aide de vos balises existantes pour utiliser la fonctionnalité de site tag associé.

Option 2: Mettre à jour votre extrait gtag.js

  1. Créez une propriété Google Analytics 4.
    • Utilisez l'assistant de configuration GA4 pour ajouter une propriété Google Analytics 4. Toutefois, décochez l'option Activer la collecte de données à l'aide de vos balises existantes lorsque vous y êtes invité lors de la configuration. Vous pouvez également créer une propriété Google Analytics 4 sans l'assistant de configuration GA4. L'assistant vous permet de copier certains paramètres de base de votre propriété Universal Analytics.
  2. Recherchez l'ID de balise de la propriété Google Analytics 4.
  3. Ajoutez la propriété Google Analytics 4 à votre extrait gtag.js existant à l'aide de la commande config avec l'ID de la balise.

Voici un exemple d'extrait gtag.js ayant configuré une propriété Universal Analytics et Google Analytics 4.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');         // Universal Analytics property.
  gtag('config', 'TAG_ID');  // Google Analytics 4 property.
</script>

4. (Facultatif) Mesurer d'autres événements d'e-commerce

Pour tirer pleinement parti des rapports sur l'e-commerce GA4, implémentez d'autres événements d'e-commerce GA4. Pour en savoir plus, consultez Google Analytics 4 E-commerce.

Si vous utilisez la configuration de l'extrait gtag.js par défaut, les événements GA4 seront envoyés à vos propriétés UA et GA4. Les événements GA4 envoyés à votre propriété UA seront traduits comme défini dans la documentation de référence sur la compatibilité des événements. Si vous préférez un comportement différent, vous pouvez utiliser la fonctionnalité Regrouper et acheminer les données de gtag.js pour contrôler les événements envoyés à votre propriété UA et GA4. Par exemple, vous pouvez envoyer l'événement purchase à vos propriétés UA et GA4, mais n'envoyer que d'autres événements d'e-commerce GA4 à votre propriété GA4.