Addingwell

1Rô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)

2Architecture

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

3Installation

Créer un compte et installer le plugin

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

Fonctionnalités à activer

Configurer le pixel du tunnel de paiement

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

Configurer le serveur sGTM

1. 1Créez le serveur dans le tableau de bord Addingwell
2. 2Domaine personnalisé : tags.ma-boutique.com (votre sous-domaine)
3. 3Ré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).

4DataLayer 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. 1Ouvrez la console du navigateur sur la boutique
2. 2Tapez dataLayer et inspectez les événements
3. 3Naviguez : page → collection → produit → panier
4. 4Vérifiez page_view, view_item_list, view_item, add_to_cart

5Pixel 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

6Cookie 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.

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

8Configuration

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

Configuration du sGTM

9Vérification

Phase 1 : infrastructure Addingwell

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

Vérifier le DataLayer

1. 1Ouvrez la console du navigateur sur la boutique
2. 2Tapez dataLayer et inspectez les événements
3. 3Naviguez : page → collection → produit → panier
4. 4Vérifiez page_view, view_item_list, view_item, add_to_cart
5. 5Passez 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 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)

10Dépannage