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.
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
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_idouitem_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
itemsni dans les paramètres : pas d’e-mail, de nom ni de téléphone. - Réinitialisation :
ecommerce: nullpart 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.currencyest requis dès qu’une valeur est envoyée ; je l’envoie partout. - Recommandés.
item_list_idetitem_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_idetitem_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.
currencyetvalue(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é.couponsi 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_idde 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 :
EURsur 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
valueest la somme de price × quantity, sansshippingnitax. 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
priceest 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énement | Déclencheur | Requis | Contrôle de recette |
|---|---|---|---|
| view_item_list | Liste de produits affichée | items | Articles = produits visibles |
| select_item | Clic sur un produit de liste | items | Article cliqué |
| view_item | Fiche produit chargée | currency, value, items | value = prix affiché |
| add_to_cart | Ajout confirmé par le serveur | currency, value, items | quantity et value cohérents |
| remove_from_cart | Retrait confirmé | currency, value, items | value positive du montant retiré |
| view_cart | Panier affiché | currency, value, items | value = somme price × quantity |
| begin_checkout | Première étape de commande | currency, value, items | Une fois par tunnel |
| add_shipping_info | Étape livraison validée | currency, value, items | shipping_tier = mode choisi |
| add_payment_info | Étape paiement validée | currency, value, items | payment_type sans donnée bancaire |
| purchase | Commande confirmée côté serveur | transaction_id, value, currency, items | Pas de doublon au rechargement |
| refund | Remboursement confirmé | transaction_id, value, currency | transaction_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.