Couche de données e-commerce — socle de traçage (gratuit)

Guide utilisateur — Couche de données e-commerce (socle)

Ce module ne se voit pas. Il ne pose ni écran ni menu : il met à disposition, dans chaque page de la boutique, ce qui s'y passe, pour qu'un module de traçage puisse le lire.

1. Vérifier qu'il fonctionne

Ouvrez une fiche produit de la boutique, affichez le code source de la page et cherchez dyo-datalayer-event. Vous devez y voir un bloc de ce genre :

{"event": "view_item",
 "ecommerce": {"currency": "EUR", "value": 24.9,
               "items": [{"item_id": "GAL-01", "item_name": "Galet gravé",
                          "price": 24.9, "quantity": 1.0,
                          "item_category": "Décoration"}]}}

Si le bloc est là, le socle fait son travail. S'il manque, c'est que le module n'est pas installé sur ce site — vérifiez le site actif en multi-sites.

2. Les événements émis

3. Pourquoi les prix sont justes

Les valeurs viennent du modèle Odoo, pas du texte affiché. Une remise, une taxe incluse ou une devise secondaire donnent donc le bon montant. Un traceur qui lit le prix dans la page se trompe sur les trois — c'est la cause la plus fréquente d'un chiffre d'affaires mesuré qui ne correspond à rien.

4. Lire la couche depuis votre propre code

document.addEventListener("dyo-datalayer", (e) => {
    console.log(e.detail.event, e.detail.ecommerce);
});

L'écouteur reçoit aussi ce qui a été poussé avant son chargement : window.dyoDataLayer conserve la file.

5. Le consentement

window.dyoConsentement() rend l'état au moment de l'appel :

{ analytics: false, marketing: false }

Le socle ne décide pas à la place du traceur : il expose l'état, le traceur choisit d'envoyer ou non. C'est ce qui permet à chaque module de suivre sa propre politique.

Ce que le module ne fait pas

Il n'envoie rien à personne — c'est ce qui lui permet de tourner sur Odoo Online. Il ne pose pas de bandeau de consentement : Odoo en fournit un.