Rédiger une spécification de dataLayer e-commerce que vos développeurs appliqueront

Ce que doit contenir chaque événement

• Le nom exact de l'événement, en snake_case, aligné sur la nomenclature GA4 quand elle existe.
• Le moment précis de la poussée : « au chargement du DOM de la page de confirmation », pas « après l'achat ».
• La structure JSON complète avec un exemple réel, valeurs comprises.
• Le type attendu de chaque paramètre et le comportement si la valeur est absente.
• La destination : quelles balises consomment cet événement.

Les événements du tunnel e-commerce

Le socle minimal : view_item_list, select_item, view_item, add_to_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase. Chacun transporte un objet items normalisé avec item_id, item_name, item_brand, item_category, price, quantity et, quand c'est possible, un index.

J'y ajoute systématiquement des dimensions métier qui n'existent pas dans le schéma standard : type de client (nouveau ou existant), mode de livraison, présence d'un code promotionnel, palier de marge du panier.

Les pièges classiques

• Pousser purchase à chaque rechargement de la page de confirmation, sans garde-fou sur l'identifiant de transaction.
• Envoyer un prix TTC dans un cas et HT dans un autre selon le parcours.
• Utiliser des identifiants produits différents de ceux du flux Merchant Center, ce qui rend impossible le remarketing dynamique.
• Vider le dataLayer entre deux événements sur les sites en rendu client, ce qui fait perdre le contexte.