L'e-commerce GA4 de bout en bout via votre conteneur serveur

GA4 alimente ses rapports e-commerce uniquement à partir des événements portant les noms recommandés. Les noms personnalisés comme productView ou checkout_step_2 sont enregistrés, mais n'apparaissent jamais comme vues de produit ou comme revenus. Utilisez exactement ces noms, en minuscules :

• view_item_list et select_item : un visiteur voit une liste de produits (page catégorie, résultats de recherche) et clique sur un produit de cette liste.
• view_item : une page détail produit.
• add_to_cart, remove_from_cart et view_cart : les actions sur le panier.
• begin_checkout, add_shipping_info et add_payment_info : les étapes du tunnel de commande.
• purchase : la commande finalisée.
• refund : un remboursement total ou partiel, en général envoyé depuis votre backend plutôt que depuis le navigateur.

Chaque événement contient un tableau items, et chaque article nécessite au moins item_id ou item_name. Quand un événement a une value, il lui faut aussi une currency (par exemple EUR), sinon GA4 ne peut pas la convertir en revenu. purchase et refund nécessitent en plus un transaction_id.

Chaque push se fait en deux temps : d'abord ecommerce: null, puis l'événement avec un nouvel objet ecommerce. Le dataLayer fusionne les objets : sans cette remise à zéro, les articles de l'événement précédent peuvent se retrouver dans le suivant, par exemple un produit de view_item qui atterrit dans add_to_cart.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'view_item',
  ecommerce: {
    currency: 'EUR',
    value: 129.90,
    items: [{ item_id: 'SKU-1', item_name: 'Shoes', item_brand: 'Acme', item_category: 'Footwear', price: 129.90, quantity: 1 }]
  }
});

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'add_to_cart',
  ecommerce: {
    currency: 'EUR',
    value: 129.90,
    items: [{ item_id: 'SKU-1', item_name: 'Shoes', price: 129.90, quantity: 1 }]
  }
});

Le push d'achat ajoute le transaction_id et la valeur totale de la commande. Générez-le sur la page de remerciement avec les vraies données de commande de votre boutique.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'T-10293',
    value: 129.90,
    currency: 'EUR',
    items: [{ item_id: 'SKU-1', item_name: 'Shoes', price: 129.90, quantity: 1 }]
  }
});

Dans le conteneur web, inutile de créer une balise par événement. Une seule balise Google Analytics: GA4 Event peut lire le nom de l'événement et les données e-commerce dans le dataLayer, et envoyer l'événement qui a été poussé, quel qu'il soit.

1. 1 Créez un déclencheur de type Custom Event. Comme nom d'événement, saisissez ^(view_item_list|select_item|view_item|add_to_cart|remove_from_cart|view_cart|begin_checkout|add_shipping_info|add_payment_info|purchase)$ et cochez Use regex matching.
2. 2 Créez une balise de type Google Analytics: GA4 Event. Saisissez votre ID de mesure G-XXXXXXXXXX (ou sélectionnez votre balise Google) et réglez Event Name sur la variable intégrée {{Event}}.
3. 3 Sous More Settings, ouvrez Ecommerce, cochez Send Ecommerce data et choisissez Data Layer comme source de données.
4. 4 Associez le déclencheur Custom Event, nommez la balise (par exemple GA4 - ecommerce) et enregistrez.

La balise passe par la même balise Google, dont le server_container_url est déjà réglé sur https://sgtm.example.com depuis la leçon 3 : chaque événement e-commerce arrive donc d'abord dans votre conteneur serveur.

Rien. Le client GA4 prend en charge les hits e-commerce comme n'importe quel autre événement GA4, et les articles voyagent dans le hit. La balise GA4 de la leçon 4, déclenchée sur Client Name égal à GA4, les transmet à Google Analytics avec value, currency et transaction_id.

Le conteneur serveur reste le bon endroit pour ajouter d'autres destinations. Une balise Meta Conversions API peut lire le même événement purchase, et la commande est ainsi envoyée à Meta à partir des mêmes données (la leçon 7 montre comment partager un event_id pour la déduplication). La balise de conversion Google Ads de la leçon suivante le lit aussi.

Google Analytics déduplique les événements purchase ayant le même transaction_id pour les données des flux web. Voyez-y un filet de sécurité, pas la solution. La source habituelle des doublons est la page de remerciement : un visiteur la recharge, y revient via l'historique du navigateur ou ouvre le lien de confirmation reçu par e-mail, et le push d'achat s'exécute de nouveau.

• N'affichez le push d'achat qu'au premier affichage de la page de remerciement. Gardez un indicateur sur la commande dans votre boutique (par exemple tracked_at) et sautez le push s'il est défini.
• Envoyez toujours un transaction_id réel et unique. Jamais une chaîne vide : GA4 traite tous les achats dont le transaction_id est une chaîne vide comme une seule transaction.
• Ne mettez pas de données personnelles comme l'adresse e-mail dans transaction_id. Utilisez le numéro de commande.
• Envoyez les remboursements avec le transaction_id de la commande d'origine, pour que GA4 puisse les rapprocher.

Testez à trois endroits, du serveur vers l'extérieur. Ouvrez le Preview dans les deux conteneurs et parcourez la boutique : consultez un produit, ajoutez-le au panier, passez à la caisse et passez une commande de test.

• Preview web : la balise GA4 - ecommerce se déclenche sur chaque événement e-commerce et pas sur les autres.
• Preview serveur : la requête part vers sgtm.example.com, et dans les données d'événement vous voyez items avec item_id, price et quantity, ainsi que value et currency.
• Preview serveur : la balise GA4 figure sous Tags Fired pour purchase.
• GA4 DebugView : les événements arrivent avec leurs paramètres et leurs articles.
• Rapports GA4 Monetization : les achats et les revenus apparaissent. Ces rapports peuvent mettre 24 à 48 heures à se remplir : ne les jugez pas le jour même.