ga4e-commerce

Plan de marquage e-commerce GA4 : spec par événement

Plan de marquage e-commerce GA4 : déclencheur, paramètres requis, dataLayer et recette de chaque événement, de view_item_list à refund, selon Google.

Un plan de marquage e-commerce liste, étape par étape du tunnel d’achat, l’événement GA4 à envoyer, son déclencheur, ses paramètres requis et le contrôle qui prouve qu’il part. Le modèle ci-dessous couvre les onze événements e-commerce de la référence Google, du catalogue jusqu’au remboursement. Chaque fiche sert de contrat à remettre au développeur : il sait quoi pousser dans le dataLayer, et vous savez quoi vérifier. Pour contrôler après coup les pushes réellement envoyés, le protocole d’audit du dataLayer e-commerce reprend ces fiches comme référence.

Outils concernés Google Analytics 4 Google Tag Manager Google Ads BigQuery

Ce document n’est pas la méthode générale du plan de taggage GA4 : il décrit un parcours d’achat avec ses paramètres obligatoires, événement par événement. Si vous partez de zéro, mon setup GA4 commence par ce document, avant la moindre balise.

Le tunnel en un schéma

Le tunnel d'achat GA4 : onze événements par étape

Les événements sont regroupés par étape du parcours. Chaque événement part au moment où l'action a lieu, pas à chaque rendu de page.

Le schéma donne l’ordre du parcours. Un visiteur peut quitter à chaque étape, donc chaque événement doit exister seul, sans dépendre de l’étape précédente. Pour la logique complète du tunnel et des revenus, voir le tracking e-commerce avec GA4.

Règles communes à tous les événements

  • Nom exact : le nom recommandé par Google, en snake_case et en minuscules. Un second nom pour le même geste coupe les rapports en deux.
  • items : chaque article porte item_id ou item_name. La référence exige l’un des deux et recommande les deux.
  • currency et value : la référence les marque requis sous condition, ce qui veut dire que la devise est obligatoire dès qu’une valeur est envoyée (« currency is required if you set value »). Je les envoie sur chaque événement qui porte un montant.
  • Devise : code ISO 4217 sur trois lettres, en majuscules (EUR).
  • value : la référence décrit la valeur comme la somme de price × quantity sur les articles. Taxes et frais de port ont leurs propres paramètres (voir les pièges).
  • Aucune donnée personnelle dans items ni dans les paramètres : pas d’e-mail, de nom ni de téléphone.
  • Réinitialisation : ecommerce: null part avant chaque push e-commerce, comme dans les exemples GTM de Google, pour vider l’objet précédent. La page GA4 consultée ne le mentionne pas : c’est une pratique de mise en œuvre à valider dans la documentation GTM e-commerce.

Les exemples ci-dessous suivent le format dataLayer GTM de la documentation Google, avec les paramètres dans l’objet ecommerce. Pour mettre en place la couche de données elle-même, voir le guide dataLayer GTM avec exemples CMS.

Les onze événements, un par un

view_item_list

  • Déclencheur. La liste de produits s’affiche : catégorie, résultats de recherche, carrousel.
  • Requis. items. currency est requis dès qu’une valeur est envoyée ; je l’envoie partout.
  • Recommandés. item_list_id et item_list_name, présents dans les exemples Google.
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'view_item_list',
  ecommerce: {
    currency: 'EUR',
    item_list_id: 'cat_vestes',
    item_list_name: 'Vestes',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', item_category: 'Vestes', price: 49.9 }]
  }
});

Recette. Dans DebugView, le nombre d’articles correspond aux produits réellement affichés, dans le même ordre.

select_item

  • Déclencheur. Clic sur un produit dans une liste, pas sur un lien du menu.
  • Requis. items.
  • Recommandés. item_list_id et item_list_name, pour savoir depuis quelle liste le clic vient.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'select_item',
  ecommerce: {
    currency: 'EUR',
    item_list_id: 'cat_vestes',
    item_list_name: 'Vestes',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9 }]
  }
});

Recette. L’article envoyé est celui sur lequel on a cliqué, pas le premier de la liste.

view_item

  • Déclencheur. Chargement de la fiche produit, une fois par affichage.
  • Requis. currency et value (requis ensemble), items.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'view_item',
  ecommerce: {
    currency: 'EUR',
    value: 49.9,
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', item_category: 'Vestes', price: 49.9, quantity: 1 }]
  }
});

Recette. value égal au prix affiché sur la fiche, et item_id identique à celui qui apparaîtra à l’achat.

add_to_cart

  • Déclencheur. Ajout confirmé par le panier côté serveur ou son API, pas au simple clic sur le bouton. Cette règle est mon choix, pour éviter les ajouts fantômes ; la référence ne la prescrit pas.
  • Requis. currency, value, items.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'add_to_cart',
  ecommerce: {
    currency: 'EUR',
    value: 99.8,
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. Ajouter deux unités donne quantity à 2 et value à 99.8, pas à 49.9.

remove_from_cart

  • Déclencheur. Retrait d’une ligne, confirmé par le serveur.
  • Requis. currency, value, items.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'remove_from_cart',
  ecommerce: {
    currency: 'EUR',
    value: 49.9,
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 1 }]
  }
});

Recette. La valeur est positive et égale au montant retiré. La référence ne précise pas le signe ici : je le fixe dans le plan et je le fais valider.

view_cart

  • Déclencheur. Affichage de la page ou du tiroir panier.
  • Requis. currency, value, items.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'view_cart',
  ecommerce: {
    currency: 'EUR',
    value: 99.8,
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. value est égal à la somme de price × quantity des lignes affichées.

begin_checkout

  • Déclencheur. Arrivée sur la première étape de la commande.
  • Requis. currency, value, items. Recommandé. coupon si un code est appliqué.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'begin_checkout',
  ecommerce: {
    currency: 'EUR',
    value: 99.8,
    coupon: 'AUTOMNE10',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. Recharger la même étape ne renvoie pas l’événement. Ce contrôle se fait à la main, car il dépend du comportement du site.

add_shipping_info

  • Déclencheur. Validation de l’étape livraison, avec le mode choisi.
  • Requis. currency, value, items. Recommandé. shipping_tier, le libellé du mode choisi (présent dans l’exemple Google).
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'add_shipping_info',
  ecommerce: {
    currency: 'EUR',
    value: 99.8,
    shipping_tier: 'Livraison standard',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. Changer de mode de livraison fait changer shipping_tier.

add_payment_info

  • Déclencheur. Validation de l’étape paiement, avec le moyen choisi.
  • Requis. currency, value, items. Recommandé. payment_type, le libellé du moyen (carte, virement, etc.).
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'add_payment_info',
  ecommerce: {
    currency: 'EUR',
    value: 99.8,
    payment_type: 'carte',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. payment_type contient un libellé de moyen, jamais un numéro de carte ni un IBAN.

purchase

  • Déclencheur. Première présentation de la confirmation d’une commande validée côté serveur, une seule fois par transaction_id.
  • Requis. transaction_id, value, currency, items. Recommandés. tax, shipping, coupon, listés dans la référence.
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'T-20261118-0042',
    value: 99.8,
    tax: 19.96,
    shipping: 4.9,
    currency: 'EUR',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 2 }]
  }
});

Recette. Recharger la page de confirmation n’envoie pas un second achat : la référence indique que transaction_id sert à éviter les doublons, et je le teste en rechargeant la page. Le même identifiant apparaît dans le back-office.

refund

  • Déclencheur. Remboursement ou annulation confirmé dans le back-office, jamais au clic du client sur « annuler ».
  • Requis. transaction_id de la commande d’origine, currency, value. Recommandé. items, pour voir les remboursements par article.

Un remboursement se valide dans le back-office, hors de la session du client. Le push ci-dessous ne convient donc que si l’écran du back-office charge GTM. Sinon, envoyez les mêmes paramètres de serveur à serveur avec le Measurement Protocol, puis faites valider cette architecture par votre développeur.

window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'refund',
  ecommerce: {
    transaction_id: 'T-20261118-0042',
    value: 49.9,
    currency: 'EUR',
    items: [{ item_id: 'SKU-123', item_name: 'Veste imperméable', price: 49.9, quantity: 1 }]
  }
});

Recette. Le transaction_id correspond à un achat existant, et le montant est celui réellement remboursé.

Les pièges à trancher avant la recette

  • transaction_id : généré par la commande côté serveur, jamais par la page. Le même identifiant sert à purchase et à refund.
  • Devise : EUR sur chaque événement qui porte un montant. La référence exige la devise dès qu’une valeur part.
  • value HT ou TTC : la référence dit que value est la somme de price × quantity, sans shipping ni tax. Je retiens donc hors taxes et hors frais de port. Faites tout de même valider ce choix par la personne qui tient le chiffre d’affaires, puis comparez avec le back-office sur une période.
  • Remise : décidez si price est le prix catalogue ou le prix net, et écrivez le choix dans la colonne source du plan.
  • item_id cohérent : le même identifiant produit dans view_item, add_to_cart et purchase. Une variante qui change d’identifiant crée deux produits dans les rapports.
  • Remboursements : un remboursement partiel envoie les articles concernés et leurs quantités, pas toute la commande. La référence ne tranche pas le signe de value : je le fixe positif dans le plan, à valider avant la recette finale.
  • ecommerce: null : à vérifier dans le Preview GTM sur chaque événement, pas seulement sur la page de confirmation.

Tableau récapitulatif

ÉvénementDéclencheurRequisContrôle de recette
view_item_listListe de produits affichéeitemsArticles = produits visibles
select_itemClic sur un produit de listeitemsArticle cliqué
view_itemFiche produit chargéecurrency, value, itemsvalue = prix affiché
add_to_cartAjout confirmé par le serveurcurrency, value, itemsquantity et value cohérents
remove_from_cartRetrait confirmécurrency, value, itemsvalue positive du montant retiré
view_cartPanier affichécurrency, value, itemsvalue = somme price × quantity
begin_checkoutPremière étape de commandecurrency, value, itemsUne fois par tunnel
add_shipping_infoÉtape livraison validéecurrency, value, itemsshipping_tier = mode choisi
add_payment_infoÉtape paiement validéecurrency, value, itemspayment_type sans donnée bancaire
purchaseCommande confirmée côté serveurtransaction_id, value, currency, itemsPas de doublon au rechargement
refundRemboursement confirmétransaction_id, value, currencytransaction_id existant

currency et value sont requis sous condition : ils vont ensemble dès qu’un montant part.

Remettez ce tableau et les blocs de code à votre développeur, puis demandez une recette sur un achat test : Preview GTM pour le déclenchement, DebugView pour les paramètres. Si vous voulez qu’un consultant pose ce plan complet avec son setup, c’est le périmètre du setup GA4.

Sources

Consultées le 18 novembre 2026.

Ron Kopelman

Besoin d'aide sur ce sujet ?

Je peux vous accompagner sur la mise en place ou l'optimisation de votre tracking.