Addingwell

1Role / Objectif

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

• Injection automatique du DataLayer GA4 (11+ events e-commerce)
• Custom Pixel pour les events checkout (begin_checkout, purchase)
• Injection GTM sur toutes les pages du store
• Bypass adblockers via CDN proxy first-party
• Cookie restore pour contourner ITP Safari
• Hebergement du serveur sGTM (server-side GTM)

2Architecture

Ce qu'Addingwell installe automatiquement

Shopify Store
├── DataLayer GA4 (toutes les pages)
│   └── 11+ events e-commerce standards
├── Custom Pixel (checkout)
│   └── begin_checkout + purchase
├── GTM Web Container (injection)
│   └── Script injecte sur toutes les pages
├── CDN Proxy (bypass adblockers)
│   └── Domain first-party pour les scripts
├── Cookie Restore (ITP Safari)
│   └── Restauration cookies first-party
└── Serveur sGTM
    └── Custom domain + region configurable

Integration dans le stack

Shopify
  → Theme layer
    → Bridge Cookiebot → Shopify Privacy API
  → Addingwell
    → DataLayer GA4 + DataLayer Monitor (custom pixel)
    → GTM Web
      → Cookiebot CMP (Consent Mode v2, EEA + UK)
      → GA4 tag → sGTM
      → Meta Pixel → sGTM
      → Google Ads tag → sGTM
    → sGTM (Addingwell server)
      → GA4 (server)
      → Meta CAPI (server)
      → Google Ads Enhanced Conversions (server)
      → Attribution cookies (fbp, fbc, gclid, wbraid, gbraid)

Avantages

• Zero configuration theme — tout est automatique
• Compatible avec tous les themes Shopify
• Pas de code Liquid custom necessaire pour le tracking
• Mise a jour automatique quand Shopify change ses APIs
• Support natif des markets multi-devises

3Installation

Creer un compte et installer

1. 1Creer un compte sur addingwell.com (billing actif requis)
2. 2Installer le plugin Shopify depuis l'App Store Addingwell
3. 3Dans les settings du plugin, activer les features suivantes

Features a activer

Configurer le custom pixel checkout

1. 1Shopify Admin > Settings > Customer Events
2. 2Add custom pixel > coller le code fourni par Addingwell

Configurer le serveur sGTM

1. 1Creer le serveur dans le dashboard Addingwell
2. 2Custom domain : tags.ma-boutique.com (votre sous-domaine)
3. 3Region recommandee : Europe multi-region

Configurer le DNS (custom domain)

Le custom domain (ex: tags.ma-boutique.com) sert a la fois de endpoint sGTM et de CDN proxy pour GTM. Il permet le tracking first-party (bypass adblockers, ITP Safari).

4DataLayer GA4

Events e-commerce injectes

Structure d'un event

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
    }]
  }
})

Verification rapide

1. 1Ouvrir la Console du navigateur sur le store
2. 2Taper dataLayer et verifier les events
3. 3Naviguer : page → collection → produit → panier
4. 4Verifier page_view, view_item_list, view_item, add_to_cart

5Custom Pixel Checkout

Le checkout Shopify est isole (iframe). Addingwell utilise un Custom Pixel pour capturer les events checkout.

Events captures

• begin_checkout — debut du processus d'achat
• purchase — achat confirme avec transaction_id, value, items

Flux des events checkout

Shopify Checkout (iframe)
        ↓
Custom Pixel Addingwell
        ↓
dataLayer.push({ event: "purchase", ... })
        ↓
GTM Web Container
        ↓
GA4 → sGTM → Destinations

Injection GTM

Addingwell injecte automatiquement le snippet GTM Web sur toutes les pages du store Shopify.

• Pas besoin de modifier theme.liquid
• Injection optimisee (async, non-bloquante)
• Compatible avec tous les themes
• Mise a jour automatique du snippet
• Supporte le CDN proxy pour le bypass adblockers

Bypass Adblockers

Requete normale (bloquee)
  browser → googletagmanager.com ✗ (adblocker)

Requete via CDN proxy (passe)
  browser → cdn.monstore.com → googletagmanager.com ✓

• CDN proxy first-party sur le domaine du store
• Les scripts GTM/GA4 sont servis depuis le meme domaine
• Les adblockers ne bloquent pas les requetes first-party
• Recuperation de 15-30% de donnees perdues

6Cookie Restore / Attribution

Probleme ITP Safari

Safari ITP limite les cookies first-party JavaScript a 7 jours (ou 24h dans certains cas). Les identifiants tracking (_ga, _fbp, _fbc) expirent trop vite.

Solution Cookie Restore

• Addingwell intercepte les cookies avant expiration
• Les cookies sont re-ecrits via un endpoint server-side
• Les cookies server-side ne sont pas affectes par ITP
• Duree de vie restauree a la valeur normale (2 ans pour _ga)

Cookies d'attribution (1P)

Les cookies d'attribution sont persistes en first-party par Addingwell (cookie restore). Ils survivent a ITP Safari et aux purges navigateur, assurant une attribution fiable.

7DataLayer Monitor

Le DataLayer Monitor est un Custom Pixel Shopify qui fournit une couche d'observabilite sur le tracking. Il instrumente dataLayer.push() et gtag(), charge le snippet Addingwell, et fournit des outils de debug en temps reel.

Fonctionnalites

Installation du Custom Pixel

1. 1Shopify Admin > Settings > Customer Events > Add custom pixel
2. 2Nom : "AW × BE — DataLayer Monitor"
3. 3Autorisation : "Non requise" — le pixel utilise le Google Advanced Consent Mode via GTM
4. 4Vente de donnees : "Pas une vente de donnees"
5. 5Coller le script DataLayer Monitor (v3.0.0)
6. 6Connecter le pixel > Save

8Configuration

Pre-requis

• Compte Addingwell actif (billing requis)
• Store Shopify connecte
• GTM Web Container ID (GTM-XXXXXXX)
• Custom domain configure pour le CDN proxy et sGTM (recommande)

Etapes de configuration

1. 1Installer l'app Addingwell depuis le Shopify App Store
2. 2Connecter le store dans le dashboard Addingwell
3. 3Renseigner le GTM Web Container ID
4. 4Activer le CDN proxy (bypass adblockers)
5. 5Activer le Cookie Restore (bypass ITP)
6. 6Creer le serveur sGTM + configurer le custom domain DNS
7. 7Verifier l'injection GTM sur le store

Configuration sGTM

9Verification

Phase 1 : Infrastructure Addingwell

1. 1Plugin Addingwell actif dans Shopify (Apps > Addingwell)
2. 2DataLayer GA4 present — taper dataLayer dans la console
3. 3Custom pixel checkout configure dans Addingwell
4. 4Cookie restore actif — champ shopify_y present dans le DataLayer
5. 5Requetes sGTM first-party visibles dans Network (custom domain)
6. 6Custom domain sGTM repond avec statut 200

Verifier le DataLayer

1. 1Ouvrir la console navigateur sur le store
2. 2Taper dataLayer et verifier les events
3. 3Naviguer : page → collection → produit → panier
4. 4Verifier page_view, view_item_list, view_item, add_to_cart
5. 5Completer un checkout test → verifier begin_checkout, purchase

Verifier GTM

• Ouvrir GTM Preview Mode
• Les events doivent apparaitre dans le debug panel
• Verifier que les variables ecommerce sont remplies

Verifier le CDN Proxy

• Ouvrir l'onglet Network du navigateur
• Les requetes GTM/GA4 doivent pointer vers le custom domain
• Pas de requete directe vers googletagmanager.com

Verifier les cookies d'attribution

• DevTools > Application > Cookies
• Verifier la presence de _fbp, _fbc, _gcl_aw (gclid)
• Les cookies doivent avoir le domaine du store (first-party)

10Troubleshooting