Addingwell

Série Tracking · Infrastructure · environ 15 min de lecture.

Identifiants nécessaires pour ce guide :

Rôle et objectif

Addingwell est le plugin d'infrastructure qui automatise toute la couche technique du tracking sur Shopify :

• Injection automatique du DataLayer GA4 (au moins 11 événements e-commerce)
• Pixel personnalisé pour les événements du tunnel de paiement (begin_checkout, purchase)
• Injection de GTM sur toutes les pages de la boutique
• Contournement des bloqueurs de publicité grâce à un proxy CDN first-party
• Cookie restore pour contourner l'ITP de Safari
• Hébergement du serveur sGTM (GTM côté serveur)

Architecture

Ce qu'Addingwell installe automatiquement

Boutique Shopify
├── DataLayer GA4 (toutes les pages)
│   └── 11+ événements e-commerce standards
├── Pixel personnalisé (tunnel de paiement)
│   └── begin_checkout + purchase
├── Conteneur GTM Web (injection)
│   └── Script injecté sur toutes les pages
├── Proxy CDN (contournement des bloqueurs)
│   └── Domaine first-party pour les scripts
├── Cookie Restore (ITP Safari)
│   └── Restauration des cookies first-party
└── Serveur sGTM
    └── Domaine personnalisé + région au choix

Sa place dans le dispositif de tracking

Shopify
  → Couche thème
    → Passerelle Cookiebot → Shopify Privacy API
  → Addingwell
    → DataLayer GA4 + DataLayer Monitor (pixel personnalisé)
    → GTM Web
      → Cookiebot CMP (Consent Mode v2, EEE + Royaume-Uni)
      → balise GA4 → sGTM
      → Meta Pixel → sGTM
      → balise Google Ads → sGTM
    → sGTM (serveur Addingwell)
      → GA4 (serveur)
      → Meta CAPI (serveur)
      → Google Ads Enhanced Conversions (serveur)
      → Cookies d'attribution (fbp, fbc, gclid, wbraid, gbraid)

Avantages

• Aucune configuration dans le thème : tout est automatique
• Compatible avec tous les thèmes Shopify
• Aucun code Liquid personnalisé à écrire pour le tracking
• Se met à jour tout seul quand Shopify fait évoluer ses API
• Prise en charge native des marchés multidevises

Installation

Créer un compte et installer le plugin

1. Créez un compte sur addingwell.com (facturation active obligatoire)
2. Installez l'app Addingwell depuis le Shopify App Store
3. Dans les paramètres du plugin, activez les fonctionnalités ci-dessous

Fonctionnalités à activer

Configurer le pixel du tunnel de paiement

1. Admin Shopify > Paramètres > Événements clients
2. Cliquez sur « Ajouter un pixel personnalisé », puis collez le code fourni par Addingwell

Configurer le serveur sGTM

1. Créez le serveur dans le tableau de bord Addingwell
2. Domaine personnalisé : tags.ma-boutique.com (votre sous-domaine)
3. Région recommandée : Europe multi-region

Configurer le DNS (domaine personnalisé)

Le domaine personnalisé (p. ex. tags.ma-boutique.com) sert à la fois de point d'entrée au sGTM et de proxy CDN pour GTM. C'est lui qui rend possible le tracking first-party (contournement des bloqueurs de publicité et de l'ITP de Safari).

DataLayer GA4

Événements e-commerce injectés

Structure d'un événement

dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "EUR",
    value: 49.90,
    items: [{
      item_id: "SKU-001",
      item_name: "T-Shirt Premium",
      price: 49.90,
      quantity: 1
    }]
  }
})

Vérification rapide

1. Ouvrez la console du navigateur sur la boutique
2. Tapez dataLayer et inspectez les événements
3. Naviguez : page → collection → produit → panier
4. Vérifiez page_view, view_item_list, view_item, add_to_cart

Pixel du tunnel de paiement

Le tunnel de paiement Shopify est isolé dans un iframe. Addingwell passe donc par un pixel personnalisé pour en capter les événements.

Événements captés

• begin_checkout : le processus d'achat commence
• purchase : achat confirmé, avec transaction_id, value, items

Parcours des événements du tunnel de paiement

Tunnel de paiement Shopify (iframe)
        ↓
Pixel personnalisé Addingwell
        ↓
dataLayer.push({ event: "purchase", ... })
        ↓
Conteneur GTM Web
        ↓
GA4 → sGTM → destinations

Injection de GTM

Addingwell injecte automatiquement le snippet GTM Web sur toutes les pages de la boutique Shopify.

• Aucune modification de theme.liquid
• Injection optimisée (asynchrone, non bloquante)
• Compatible avec tous les thèmes
• Le snippet se met à jour tout seul
• Fonctionne avec le proxy CDN qui contourne les bloqueurs de publicité

Contourner les bloqueurs de publicité

Requête classique (bloquée)
  navigateur → googletagmanager.com ✗ (bloqueur)

Requête via le proxy CDN (acceptée)
  navigateur → cdn.ma-boutique.com → googletagmanager.com ✓

• Proxy CDN first-party sur le domaine de la boutique
• Les scripts GTM et GA4 sont servis depuis ce même domaine
• Les bloqueurs de publicité laissent passer les requêtes first-party
• Vous récupérez 15 à 30 % de données qui seraient sinon perdues

Cookie Restore et attribution

Le problème de l'ITP de Safari

L'ITP de Safari limite à 7 jours (voire 24 h dans certains cas) la durée de vie des cookies first-party posés en JavaScript. Les identifiants de tracking (_ga, _fbp, _fbc) expirent beaucoup trop vite.

La solution : Cookie Restore

• Addingwell intercepte les cookies avant leur expiration
• Il les réécrit via un endpoint côté serveur
• Les cookies posés côté serveur échappent à l'ITP
• Leur durée de vie retrouve sa valeur normale (2 ans pour _ga)

Cookies d'attribution (1P)

Addingwell conserve les cookies d'attribution en first-party (cookie restore). Ils résistent à l'ITP de Safari et aux purges du navigateur : l'attribution reste fiable.

DataLayer Monitor

Le DataLayer Monitor est un pixel personnalisé Shopify qui ajoute une couche d'observabilité au tracking. Il instrumente dataLayer.push() et gtag(), charge le snippet Addingwell et fournit des outils de débogage en temps réel.

Fonctionnalités

Installer le pixel personnalisé

1. Admin Shopify > Paramètres > Événements clients > Ajouter un pixel personnalisé
2. Nom : « AW × BE. DataLayer Monitor »
3. Autorisation : « Not required » (non requise), car le pixel s'appuie sur le Google Advanced Consent Mode via GTM
4. Vente de données : indiquez qu'il ne s'agit pas d'une vente de données
5. Collez le script DataLayer Monitor (v3.0.0)
6. Connectez le pixel, puis enregistrez

Configuration

Prérequis

• Compte Addingwell actif (facturation obligatoire)
• Boutique Shopify connectée
• ID du conteneur GTM Web (GTM-XXXXXXX)
• Domaine personnalisé configuré pour le proxy CDN et le sGTM (recommandé)

Étapes de configuration

1. Installez l'app Addingwell depuis le Shopify App Store
2. Connectez la boutique dans le tableau de bord Addingwell
3. Renseignez l'ID du conteneur GTM Web
4. Activez le proxy CDN (contournement des bloqueurs de publicité)
5. Activez Cookie Restore (contournement de l'ITP)
6. Créez le serveur sGTM et configurez le DNS du domaine personnalisé
7. Vérifiez que GTM est bien injecté sur la boutique

Configuration du sGTM

Vérification

Phase 1 : infrastructure Addingwell

1. Plugin Addingwell actif dans Shopify (Applications > Addingwell)
2. DataLayer GA4 présent : tapez dataLayer dans la console
3. Pixel de paiement personnalisé configuré dans Addingwell
4. Cookie restore actif : champ shopify_y présent dans le DataLayer
5. Requêtes sGTM first-party visibles dans l'onglet Réseau (domaine personnalisé)
6. Le domaine personnalisé du sGTM répond avec un statut 200

Vérifier le DataLayer

1. Ouvrez la console du navigateur sur la boutique
2. Tapez dataLayer et inspectez les événements
3. Naviguez : page → collection → produit → panier
4. Vérifiez page_view, view_item_list, view_item, add_to_cart
5. Passez une commande test jusqu'au bout → vérifiez begin_checkout et purchase

Vérifier GTM

• Ouvrez le mode Aperçu de GTM
• Les événements doivent apparaître dans le panneau de débogage
• Vérifiez que les variables ecommerce du dataLayer sont remplies

Vérifier le proxy CDN

• Ouvrez l'onglet Réseau (Network) du navigateur
• Les requêtes GTM et GA4 doivent pointer vers le domaine personnalisé
• Aucune requête directe vers googletagmanager.com

Vérifier les cookies d'attribution

• DevTools > Application > Cookies
• Vérifiez la présence de _fbp, _fbc et _gcl_aw (gclid)
• Les cookies doivent porter le domaine de la boutique (first-party)

Dépannage

Checklist Addingwell

• Plugin Addingwell installé et actif
• DataLayer GA4 visible dans la console (au moins 11 événements)
• Pixel de paiement personnalisé configuré (autorisation « Not required »)
• Conteneur GTM Web injecté sur toutes les pages
• Proxy CDN (contournement des bloqueurs) activé
• Cookie restore activé
• Serveur sGTM créé et DNS du domaine personnalisé configuré (CNAME)
• Le domaine personnalisé du sGTM répond avec un statut 200
• Cookies d'attribution présents (fbp, fbc, gclid)
• Pixel personnalisé DataLayer Monitor installé (facultatif)
• Mode Aperçu de GTM : événements visibles dans le panneau de débogage
• Commande test passée : begin_checkout et purchase confirmés

Et ensuite