E-commerce GA4 (gtag.js): envoyer des événements GA4

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

Vous trouverez d'autres ressources et guides de migration dans le Centre de migration pour les développeurs.

Résultat

Après avoir suivi ce guide, vous allez implémenter les événements d'e-commerce Google Analytics 4 pour une nouvelle propriété GA4 et utiliser cette nouvelle implémentation pour renseigner vos rapports Universal Analytics existants. Votre implémentation Universal Analytics actuelle sera modifiée pour recevoir les données d'e-commerce GA4.

Avant de commencer

  1. Utilisez l'outil d'aide à la migration de l'e-commerce pour vérifier que les éléments suivants décrivent votre implémentation actuelle:

    • Vous utilisez une propriété Universal Analytics
    • Votre site utilise la bibliothèque gtag.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. Confirmez 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 gtag.js existante.

  3. Consultez la documentation de référence sur la compatibilité des événements pour découvrir comment les événements UA sont traduits lorsqu'ils sont envoyés à une propriété GA4.

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 gtag.js (Universal Analytics) existante.

Avantages Inconvénients
  • Vous pouvez consulter les données d'e-commerce dans vos rapports GA4 et Universal Analytics.
  • L'utilisation d'événements et de paramètres GA4 vous permet d'obtenir des rapports GA4 complets sur l'e-commerce.
  • Vous oblige à modifier vos événements d'e-commerce existants.
  • Tous les événements et paramètres GA4 n'ont pas d'équivalent dans Universal Analytics. Les paramètres shipping_tier, discount, currency, location_id, promotion_name et promotion_id n'ont pas d'équivalent Universal Analytics et n'apparaîtront pas dans vos rapports Universal Analytics.

Implémentation

1. Modifier votre implémentation de l'e-commerce

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 des événements d'e-commerce GA4. Consultez la section Compromis et considérations pour comprendre les implications de cette mise à jour.

Pour faciliter la mise à jour, utilisez les ressources suivantes:

2. 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>