Kowal Data Layer pour Magento 2
- Compatibilité
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0
- Hyva Theme
- Hyva Theme Redy
Description / Kowal Data Layer pour Magento 2
MAGENTO 2 · E-COMMERCE · GTM · ATTRIBUTION
Reliez les événements ecommerce à la source de la commande.
Kowal Data Layer
Préparez les données d’achat Magento pour GA4 et la configuration des tags publicitaires. Conservez le first touch et le last non-direct touch au niveau de la commande, puis vérifiez le déploiement des tags dans l’aperçu GTM.
Événements ecommerce · Exports GTM · Attribution dans le panneau
COMMENT CELA FONCTIONNE EN PRATIQUE
01 · Vous choisissez les données et les identifiants
Vous définissez item_id, la marque, la catégorie et le Store View.
02 · Vous configurez les tags et le consentement
Vous importez l’export GTM et le reliez au CMP.
03 · Vous vérifiez les événements et les commandes
Vous contrôlez les valeurs, les devises et l’attribution enregistrée.
Que gagne votre boutique ?
Découvrez les fonctionnalités, les usages et les paramètres du module.
Data Layer Magento 2 pour GA4, GTM et l’attribution des ventes
Kowal Data Layer crée une couche de données ecommerce cohérente directement depuis Magento 2. Il prend en charge l’ensemble du parcours d’achat, les intégrations via Google Tag Manager ainsi que l’enregistrement de la source d’une commande précise.
C’est une solution pour les boutiques qui souhaitent relier l’analytique GA4, les campagnes publicitaires et les données Magento sans ajouter manuellement des scripts aux éléments successifs du thème et du checkout.
Ecommerce GA4
Des événements de la liste de produits et de la PDP jusqu’à l’achat, en passant par le panier, la wishlist et le checkout.
Exports GTM prêts à l’emploi
Packages pour GA4, Google Ads, Meta, TikTok, Pinterest, Microsoft Ads et OpenAI Ads.
Attribution des commandes
First touch et last non-direct touch avec des informations sur la source, le medium, la campagne, la landing page et le referrer.
L’analytique ne doit pas bloquer les ventes
Le module a été conçu selon un modèle fail-safe. Les erreurs de couche de données ou d’attribution sont isolées et journalisées, mais elles ne doivent pas interrompre le panier, le checkout, la commande ni la redirection vers le paiement.
Événements ecommerce pris en charge
user_data, view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, add_to_wishlist, begin_checkout, add_shipping_info, add_payment_info, purchase et purchase_test.
Multistore et flux produits
La configuration par Store View permet d’adapter les identifiants, la devise, les noms, la catégorie et la marque. item_id peut correspondre aux identifiants utilisés dans Google Merchant Center, Meta Catalog et d’autres flux.
Consent Mode
Le module peut fonctionner avec Kowal Cookie Consent. Data Layer gère les données ecommerce, tandis que le CMP gère le consentement et le déclenchement des tags appropriés.
FAQ
Le module remplace-t-il Google Tag Manager ?
Non. Il prépare les données ecommerce et les exports de configuration prêts à utiliser dans GTM.
Fonctionne-t-il avec Varnish et FPC ?
Oui, la solution tient compte des boutiques utilisant le cache ainsi que des éléments dynamiques du checkout.
Enregistre-t-il la source de la commande dans Magento ?
Oui. L’attribution first touch et last non-direct touch est copiée du panier vers la commande.
Prend-il en charge les boutiques multistore ?
Oui. La configuration des identifiants et des données peut fonctionner au niveau du Store View.
Une erreur analytique peut-elle bloquer le checkout ?
L’architecture a été conçue pour isoler les erreurs analytiques du processus de vente.
L’export GTM est le point de départ du déploiement
Kowal → Data Layer → GTM Exports permet de télécharger un JSON pour la plateforme sélectionnée après configuration des identifiants. Importez le package dans le workspace GTM via Merge, vérifiez les tags et Preview, puis publiez la configuration seulement ensuite.
La mise à jour du module Magento ne met pas à jour les tags GTM importés précédemment. Téléchargez de nouveau l’export approprié lorsque sa logique change et vérifiez les doublons de tags et de conversions.
Attribution dans le panneau et limites de mesure
Data Layer → Customer Attribution affiche les commandes avec attribution enregistrée, y compris les achats invités. La grille dispose de filtres, du tri et de vues enregistrées ; l’accès nécessite une autorisation de rôle distincte.
Les sources UTM, les types de click ID, organic et referral sont reconnus sans enregistrer les query complets ni les click ID publicitaires bruts. Les données reflètent les entrées reconnues, et non une vision complète de tous les contacts client sur différents appareils.
Purchase et purchase_test de diagnostic
purchase_test dans le checkout REST standard signifie la création d’une commande, et non le paiement de l’achat. Les tags de conversion exportés l’ignorent. L’événement doit être activé séparément dans la configuration.
Les redirections vers des passerelles de paiement personnalisées peuvent nécessiter un adaptateur. Dans les logs var/log/kowal_datalayer.log, vous pouvez vérifier les erreurs ; le projet les isole du processus de vente.
Consentement, données privées et cache
Le CMP gère les consentements ainsi que la mise à jour de leur état. Lorsque Kowal Cookie Consent charge GTM, désactivez le second loader GTM dans Data Layer. L’export de tags seul ne remplace pas la configuration des consentements.
L’identité de l’utilisateur est récupérée depuis un endpoint privé afin de ne pas mélanger les données clients dans FPC. Pour un loader GTM externe, tenez compte de la disponibilité de user_data, des consentements appropriés et du résultat dans Preview.
Hyvä et cohérence des identifiants
Le package contient un Kowal_DataLayerHyva optionnel, activé avec Enable Hyva Integration pour le Store View approprié. L’adaptateur prend en charge private-content, les listes dynamiques et FormData.
Le checkout REST standard est couvert. Hyvä Checkout/Magewire et GraphQL nécessitent une intégration distincte. item_id dans l’export doit correspondre aux identifiants du flux ou du catalogue publicitaire approprié.
Installation via Composer
Package kowal/module-datalayer, module Kowal_DataLayer. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, prévoyez la compilation et le déploiement du contenu statique conformément au processus de la boutique.
De la configuration au résultat
1. Vous choisissez les données et les identifiants
Vous définissez item_id, la marque, la catégorie et le Store View.
2. Vous configurez les tags et le consentement
Vous importez l’export GTM et le reliez au CMP.
3. Vous vérifiez les événements et les commandes
Vous contrôlez les valeurs, les devises et l’attribution enregistrée.
De l’entrée depuis une campagne à la commande
Le client arrive depuis une campagne, consulte un produit et finalise son achat. Le module enregistre les sources reconnues dans le quote et les transfère vers la commande.
Dans le panneau, vous comparez first touch et last non-direct touch. Dans GTM Preview, vous vérifiez l’événement purchase avec la valeur, la devise et les articles.
Structurez les données ecommerce et l’attribution des ventes
Vous souhaitez adapter le module à votre boutique ? Demandez le déploiement de Kowal Data Layer et discutez de la configuration ou des extensions nécessaires.
Caractéristiques
| Hyva Theme | Hyva Theme Redy |
|---|---|
| Compatibilité avec le modèle | Hyvä, Luma / Blank, KOWAL |
Notice d'installation du module
Guide d’installation et de configuration
Exigences
- Magento Open Source / Adobe Commerce 2.4.x.
- PHP compatible avec la version de Magento utilisée.
- Accès Composer au dépôt privé du module.
- Module
kowal/base. - Autorisation d’exécuter
setup:upgrade, car le module ajoute des champs d’attribution aux tablesquoteetsales_order. - Conteneur web Google Tag Manager si la boutique doit utiliser les exports d’intégration prêts à l’emploi.
- Optionnel :
Kowal_CookieConsent, si la boutique l’utilise pour GTM et Consent Mode.
Installation avec Composer
Les données d’accès au dépôt Composer, soit l’adresse e-mail client et le token de licence, vous seront envoyées par e-mail après l’achat. Elles sont également disponibles dans le compte client après connexion sur kowal.store. Remplacez TWOJ_EMAIL_KLIENTA par l’adresse e-mail de votre compte et TWOJ_TOKEN par le token reçu. Exécutez les commandes dans le répertoire racine de Magento.
composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
composer require kowal/module-datalayer
php bin/magento module:enable Kowal_DataLayer
php bin/magento setup:upgrade
php bin/magento cache:flushLa commande setup:upgrade crée les colonnes :
quote.kowal_attribution_first;quote.kowal_attribution_last;sales_order.kowal_attribution_first;sales_order.kowal_attribution_last.
Les colonnes contiennent des données first-touch et last-touch sérialisées. Il ne faut pas les créer manuellement.
Mise à jour d’une installation existante
Avant de mettre à jour la production, effectuez une sauvegarde de la base de données conformément à la procédure du projet. Ensuite, mettez à jour le package et le schéma Magento :
composer update kowal/module-datalayer --with-dependencies
php bin/magento module:enable Kowal_DataLayer
php bin/magento setup:upgrade
php bin/magento cache:flushEn mode production, relancez la compilation DI et le déploiement des assets statiques. Cela est notamment requis pour le nouvel endpoint d’attribution, les observateurs quote/order et les changements dans le script frontend.
Dans l’environnement de production, si le projet l’exige, exécutez le déploiement Magento standard :
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flushAprès la mise à jour des autorisations ACL, l’administrateur peut devoir se reconnecter au panneau pour voir l’entrée Data Layer > GTM Exports.
Configuration de base
Panneau d’administration :
Stores > Configuration > Kowal > Kowal Data Layer
Menu :
kowal.store > Modules > Data Layer > Settings
General
Enable Module- activez le module pour le périmètre de configuration sélectionné.Debug Mode- activez uniquement pendant les tests et la vérification du déploiement.Render Mode- laissezServer and JavaScripts’il n’y a aucune raison de limiter le mode de fonctionnement.Missing Value Strategy- choisissez si les valeurs manquantes doivent être ignorées ou envoyées commeundefined.Clear Ecommerce Before Push- recommandé :Yes.Fail-safe Mode- recommandé :Yes; les processus critiques pour les ventes restent protégés même après la désactivation de cette option.Log Level- en production, recommandé :Errors only.Log Payloads- à activer uniquement temporairement.
Product Mapping
Product Identifier Attribute- choisissez l’attribut utilisé commeitem_id. Par défaut :sku.Brand Attribute- choisissez l’attribut fabricant/marque. Par défaut :manufacturer.Category Strategy- choisissez la méthode de construction deitem_category.Category Attribute- renseignez uniquement si la stratégie de catégorie utilise un attribut produit.Configurable Product Strategy- décidez s’il faut utiliser les données enfant/simple ou parent/configurable.Include Out Of Stock Products On Lists- concerne les événements de listes de produits.
Events
Activez les événements requis par le déploiement :
user_dataview_item_listselect_itemview_itemadd_to_cartremove_from_cartview_cartadd_to_wishlistbegin_checkoutadd_shipping_infoadd_payment_infopurchasepurchase_test, si la boutique utilise une page intermédiaire avant le paiement.
Privacy
Send User ID- envoie l’ID client Magento pour les clients connectés.Send Hashed Email- envoie uniquement le hash SHA-256 de l’e-mail. L’e-mail brut n’est pas transmis àdataLayer.
Attribution
Capture First and Last Touch Attribution enregistre la source d’entrée du client dans le quote et la commande. Paramètre recommandé : Yes.
Le paramètre fonctionne par store view. Après sa désactivation, le module n’enregistre plus de nouveaux touchpoints. Les données précédemment enregistrées dans les commandes existantes restent dans la base.
Le module reconnaît :
- les paramètres
utm_source,utm_medium,utm_campaign,utm_id,utm_term,utm_contentetutm_source_platform; - les types de click ID Google Ads, Microsoft Ads, Meta, TikTok, Pinterest, X et LinkedIn ;
- les entrées depuis les résultats de recherche organiques ;
- les referrals externes ;
- les entrées direct.
first_touch et last_touch sont enregistrés, c’est-à-dire la dernière source autre que direct. La simple navigation entre les sous-pages de la boutique ne remplace pas la source. Les referrals provenant d’adresses de paiement, de callbacks, de retours et de pages de succès sont ignorés afin que l’opérateur de paiement ne soit pas considéré comme la source de la vente.
La capture fonctionne sur deux axes :
- côté Magento pour les entrées standard non mises en cache ;
- via une requête navigateur légère pour les pages servies depuis FPC ou Varnish.
Les données sont conservées dans la session de checkout, enregistrées avec le quote et copiées vers l’order avant la validation de la commande. Le mécanisme couvre le frontend classique, le checkout AJAX/REST et les commandes créées à partir d’un quote contenant déjà une attribution.
Les valeurs brutes gclid, fbclid et des autres identifiants de clics ne sont pas enregistrées. Le module conserve uniquement le type de paramètre, par exemple gclid, et la classification de source résultante. Les query strings sont supprimées de la landing page et du referrer enregistrés.
L’attribution peut être vérifiée :
- dans la vue de commande, dans la section
Customer Attribution; - dans
dataLayer, dans la propriétéattributionde l’événementpurchase; - directement dans les colonnes
kowal_attribution_firstetkowal_attribution_lastdes tablesquoteetsales_order.
La capture de la source doit être prise en compte dans la documentation de confidentialité de la boutique conformément à la politique de déploiement. Le module ne crée pas son propre identifiant utilisateur à long terme et n’enregistre pas les valeurs de click ID, mais il stocke les métadonnées de campagne ainsi que la source de la commande.
Integrations
Integrate With Kowal Cookie Consent- activez si la boutique utiliseKowal_CookieConsent.Render GTM From DataLayer Module- laissezNosi GTM est déjà rendu par Cookie Consent ou par un autre module.Google Tag Manager ID- renseignez uniquement si le rendu de GTM depuis ce module est activé.purchase_test Redirect Rules- ajoutez uniquement les méthodes de paiement qui doivent utiliser la page intermédiairepurchase_test.
Modes de règles purchase_test :
Static URL- à utiliser uniquement pour les paiements avec une adresse opérateur fixe.URL Pattern- à utiliser lorsqu’un modèle d’URL avec les placeholders{order_id},{order_increment_id},{store_id}ou{quote_id}suffit.Adapter Required- à utiliser pour les passerelles qui génèrent une URL de transaction dynamique. Avant la mise en production, un adaptateur dédié doit être ajouté pour le module de paiement concerné.
GTM Export Identifiers
Dans cette section, saisissez les identifiants des services qui doivent être intégrés dans les fichiers JSON générés :
| Champ dans Magento | Valeur |
|---|---|
GA4 Measurement ID | identifiant au format G-XXXXXXXXXX |
Google Ads Conversion ID | identifiant au format AW-XXXXXXXXX |
Google Ads Purchase Conversion Label | libellé de l’action de conversion d’achat |
Meta Pixel ID | Pixel ID numérique |
TikTok Pixel ID | Pixel ID alphanumérique |
Pinterest Tag ID | Tag ID numérique |
Microsoft Ads UET Tag ID | UET Tag ID numérique |
Les champs peuvent être vides si la boutique n’utilise pas la plateforme concernée. L’enregistrement de la configuration vérifie le format de chaque valeur renseignée. Le bouton d’export vérifie uniquement l’ensemble requis par la plateforme sélectionnée ; par exemple, l’export GA4 n’exige donc pas de configuration Meta ni TikTok.
Après avoir renseigné les champs, cliquez sur Save Config, puis sur le bouton Download ... JSON approprié dans le champ Generate GTM Exports. Le fichier téléchargé contient déjà les identifiants finaux. Il n’est pas nécessaire de modifier les variables constantes après l’import dans GTM.
Configuration multistore
Configurez le module au niveau du store view si les boutiques diffèrent par :
- la langue ;
- la devise ;
- le flux publicitaire ;
- l’attribut d’identifiant produit ;
- l’attribut de marque ;
- la structure de catégories ;
- les méthodes de paiement ;
- les règles de capture d’attribution ;
- les identifiants de services utilisés dans les packages GTM importés.
Vérification du déploiement
- Ouvrez Google Tag Manager Preview.
- Vérifiez
dataLayerdans la console du navigateur ou avec l’extension DataLayer Checker. - Testez la page produit et l’événement
view_item. - Ouvrez une catégorie ou les résultats de recherche et vérifiez
view_item_list. - Cliquez sur un produit dans la liste et vérifiez
select_item. - Ajoutez un produit au panier et vérifiez
add_to_cart. - Modifiez la quantité ou supprimez un produit du panier et vérifiez
remove_from_cart. - Ajoutez un produit à la wishlist et vérifiez
add_to_wishlist. - Accédez au panier et au checkout, puis vérifiez
view_cartetbegin_checkout. - Enregistrez la méthode de livraison et de paiement, puis vérifiez
add_shipping_infoetadd_payment_info. - Passez une commande de test et vérifiez
purchase. - Rafraîchissez la page de succès et assurez-vous que
purchasen’est pas dupliqué. - Vérifiez
var/log/kowal_datalayer.log. - Dans une nouvelle fenêtre de navigation privée, ouvrez la boutique avec l’URL
?utm_source=test&utm_medium=cpc&utm_campaign=attribution_test. - Parcourez quelques sous-pages, ajoutez un produit au panier et passez commande.
- Dans la vue de commande, vérifiez la section
Customer Attributionainsi queattribution.first_touchetattribution.last_touchdans l’événementpurchase. - Confirmez que
first_touch.sourcea la valeurtest, quemediuma la valeurcpcet quecampaigna la valeurattribution_test. - Dans la même fenêtre et la même session, revenez sur la boutique depuis une autre source balisée et confirmez que
first_touchest resté inchangé, tandis quelast_toucha été mis à jour. - Si la boutique utilise une passerelle externe, confirmez au retour du paiement que le domaine de l’opérateur n’a pas remplacé la source de la commande.
Export de la configuration Google Tag Manager
Dans le panneau Magento, accédez à Stores > Configuration > Kowal > Kowal Data Layer > GTM Export Identifiers. Des packages distincts sont disponibles pour GA4, Google Ads, Meta, TikTok, Pinterest et Microsoft Ads.
- Choisissez le périmètre de configuration approprié :
Default Config, website ou store view. - Renseignez les identifiants des plateformes utilisées et enregistrez la configuration.
- Cliquez sur le bouton de téléchargement JSON de la plateforme choisie dans le champ
Generate GTM Exports. - Dans GTM, créez un nouveau workspace et sélectionnez
Admin > Import Container. - Indiquez le fichier téléchargé et utilisez le mode
Merge. - Passez en revue la liste des variables, règles et tags ajoutés, puis confirmez que les variables constantes contiennent les bons identifiants.
- Vérifiez les exigences de consentement et lancez GTM Preview.
- Publiez le conteneur uniquement après confirmation des événements dans l’outil de diagnostic de la plateforme.
Les noms des éléments sont précédés du préfixe Kowal - nazwa platformy, ce qui permet de combiner les packages dans un même conteneur. L’événement purchase_test n’est pas exporté comme conversion ; les ventes sont rapportées uniquement via purchase.
Si un champ requis est vide ou présente un format incorrect, le module ne générera pas l’export et affichera un message indiquant la valeur à corriger. Cela évite l’import accidentel d’un conteneur avec placeholder. La page alternative Kowal > Data Layer > GTM Exports reste disponible, mais elle utilise les valeurs du périmètre Default Config ; pour les déploiements multistore, les boutons de la configuration sont recommandés.
Les exports concernent le conteneur web et l’envoi browser-side. Ils ne remplacent pas les intégrations serveur, telles que Meta Conversions API ou TikTok Events API.
Consentements et publication GTM
- Les tags publicitaires requièrent
ad_storage,ad_user_dataetad_personalization. - GA4 utilise les mécanismes de consentement intégrés du Google tag.
- Si GTM rend
Kowal_CookieConsent, laissezRender GTM From DataLayer Moduledéfini surNo. - Ne publiez pas le conteneur sans vérifier Consent Mode, GTM Preview ainsi que le diagnostic des événements propre à la plateforme.
- Avec une CSP stricte, ajoutez les domaines de scripts et les endpoints des plateformes sélectionnées conformément à leur documentation.
Intégration purchase_test
Si la méthode de paiement redirige le client hors de la boutique et connaît l’URL cible de l’opérateur, l’intégration de paiement peut utiliser :
Kowal\DataLayer\Model\PurchaseTestRedirect::prepare($paymentRedirectUrl)La méthode renvoie l’URL de la page intermédiaire du module. La page intermédiaire envoie purchase_test, puis redirige le client vers l’opérateur de paiement. Si JavaScript ou DataLayer ne fonctionne pas, la redirection doit tout de même être effectuée.
Pour une intégration dans laquelle l’URL dépend de la commande ou du token de transaction, utilisez :
Kowal\DataLayer\Model\PurchaseTestRedirect::prepareForOrder($order, $fallbackRedirectUrl)Si la méthode est définie en mode Adapter Required, l’adaptateur doit implémenter :
Kowal\DataLayer\Api\PurchaseTestRedirectAdapterInterfaceL’adaptateur doit être enregistré dans DI comme élément du tableau adapters pour Kowal\DataLayer\Model\PurchaseTest\RedirectAdapterPool. L’adaptateur est l’emplacement approprié pour la logique dépendant d’un opérateur de paiement spécifique.
Diagnostic
Absence de la section Customer Attribution sur la commande
- Vérifiez que
Capture First and Last Touch Attributionest activé pour le store view approprié. - Confirmez l’exécution de
php bin/magento setup:upgradeet la présence des quatre colonnes d’attribution. - Videz le cache de configuration et de layout.
- Effectuez un test dans une nouvelle fenêtre de navigation privée avec une URL UTM balisée.
- Vérifiez
var/log/kowal_datalayer.logpour les messagesattribution capture failedouattribution assignment failed.
L’attribution fonctionne sans FPC, mais pas avec Varnish
- Vérifiez dans les outils de développement la requête POST vers
kowal_datalayer/attribution/capture. - Confirmez que la requête a le statut
200et qu’elle est exécutée vers le même domaine que la boutique. - Vérifiez que CSP, WAF ou les règles de reverse proxy ne bloquent pas l’endpoint.
- Après le déploiement, assurez-vous que le fichier actuel
view/frontend/web/js/data-layer.jsa été publié.
L’achat a une source d’opérateur de paiement incorrecte
Vérifiez si la commande a été créée à partir d’un quote contenant l’attribution avant la redirection. Les routes contenant payment, callback, return ou success ne doivent pas remplacer le last-touch par un referral. Si un module de paiement personnalisé utilise une autre séquence, vérifiez le moment de création de l’order et d’enregistrement du quote.
L’import GTM signale des conflits
Utilisez le mode Merge et examinez le détail des modifications. Les éléments des exports ont le préfixe Kowal - ... ; si des éléments modifiés portant le même nom existent dans le conteneur, choisissez consciemment de les écraser ou de les renommer. Après un changement de nom, vérifiez les références des tags aux variables et aux triggers.