Shopify

1Role / Objectif

Shopify est la source de toutes les donnees e-commerce. Le store genere les events utilisateur que le reste du stack (Addingwell, GTM, sGTM) collecte et distribue.

• Source des events e-commerce (page_view, add_to_cart, purchase...)
• Checkout proprietaire avec Custom Pixel API
• Shopify Privacy API pour le controle du consentement pixels
• Markets pour le multi-devises et multi-langues
• Customer Events pour les web pixels et custom pixels

2Architecture du Store

Couches du stack sur Shopify

Shopify Store
├── Theme (Storefront)
│   └── Pages publiques (home, collection, product, cart)
│
├── Checkout (iframe isole)
│   └── Extensible via Custom Pixels
│
├── Customer Events (Settings)
│   ├── Web Pixels (JS sandbox)
│   └── Custom Pixels (code libre)
│
├── Apps installees
│   ├── Addingwell (DataLayer + GTM + sGTM)
│   ├── Cookiebot (CMP via GTM)
│   └── Klaviyo (natif Shopify)
│
└── Privacy API
    └── Consent management pour les pixels

Points cles

• Le theme n'a aucun role dans le tracking (pas de code Liquid custom)
• Le checkout est isole — seuls les Custom Pixels y accedent
• Addingwell gere toute la couche DataLayer et GTM automatiquement
• La Privacy API controle uniquement les web/custom pixels Shopify

3Nettoyage Pre-installation

Avant d'installer le stack de tracking, il est indispensable de nettoyer les systemes existants. Deux systemes de tracking actifs en parallele = doublons d'events = donnees corrompues.

Apps a supprimer

Ou verifier

1. 1Shopify Admin > Settings > Apps and sales channels — desinstaller les apps tracking listees ci-dessus
2. 2Shopify Admin > Settings > Customer events (custom pixels) — supprimer les anciens custom pixels
3. 3theme.liquid — chercher et supprimer les patterns fbq('init', ...), gtag('config', ...) et tout script tracking injecte manuellement

Desactiver la confidentialite native Shopify

Aller dans Shopify Admin > Settings > Confidentialite des clients :

4DataLayer Events

Le DataLayer est genere automatiquement par Addingwell. Aucun code custom n'est necessaire dans le theme.

Events par page

5Checkout Extensibility

Le checkout Shopify est un iframe isole. Le JavaScript du theme ne peut pas y acceder directement. Shopify propose deux mecanismes pour le tracking checkout :

Custom Pixel Addingwell

Addingwell utilise un Custom Pixel pour capturer begin_checkout et purchase dans le checkout, puis les envoie au DataLayer GTM.

Checkout sandbox — limitation de test

6Web Pixels vs Custom Pixels

7Shopify Privacy API

Role

La Shopify Customer Privacy API controle quels web pixels et custom pixels sont autorises a fire. Elle est synchronisee avec Cookiebot via le bridge.

Flux de consentement

Cookiebot (CMP dans GTM)
        ↓
Bridge cookie-consent_boostecom.liquid
        ↓
Shopify.customerPrivacy.setTrackingConsent({
  marketing: true/false
})
        ↓
Web pixels fires / bloques

Ce que la Privacy API controle

8Markets & Multi-devises

Shopify Markets gere le multi-devises et multi-langues. Le tracking doit supporter les conversions dans la devise locale.

Impact sur le tracking

• Addingwell inclut la devise (currency) dans chaque event e-commerce
• Les valeurs (value, price) sont en devise locale du visiteur
• GA4 supporte nativement le multi-devises
• Meta CAPI recoit la devise correcte via sGTM
• Pas de configuration supplementaire necessaire

9Configuration

Pre-requis

• Store Shopify actif (plan Basic ou superieur)
• Acces admin avec permission Apps et Customer Events
• Domaine custom configure
• Nettoyage pre-installation effectue (voir section 3)

Apps a installer

1. 1Addingwell — DataLayer GA4, injection GTM, bypass adblockers, cookie restore
2. 2Cookiebot — CMP RGPD (banniere consent, configure via GTM)

Features Addingwell a activer

Custom Pixel checkout

1. 1Aller dans Shopify Admin > Settings > Customer Events
2. 2Add custom pixel > coller le code fourni par Addingwell
3. 3Permission : "Not required" (pas "Required") — le consent est gere par GTM, pas la Privacy API

Serveur sGTM

1. 1Creer le serveur dans Addingwell
2. 2Configurer le custom domain (ex: tags.ma-boutique.com)
3. 3Region recommandee : Europe multi-region
4. 4DNS : CNAME fourni par Addingwell > Server > Custom Domain

Verifications post-install

1. 1Addingwell connecte et actif dans le dashboard
2. 2Custom Pixel Addingwell present dans Settings → Customer Events
3. 3Permission Custom Pixel = "Not required"
4. 4Banniere Shopify native desactivee (Settings → Customer Privacy)
5. 5Bridge consent present dans theme.liquid (cookie-consent_boostecom.liquid)
6. 6DataLayer Monitor custom pixel installe dans Customer Events
7. 7Custom domain sGTM repond avec statut 200

10Verification

Verifier le DataLayer

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

Verifier les Custom Pixels

1. 1Admin Shopify → Settings → Customer Events
2. 2Verifier que le Custom Pixel Addingwell est present et actif
3. 3Verifier la permission = "Not required"
4. 4Verifier que le DataLayer Monitor est present et actif
5. 5Pas d'autre custom pixel en conflit

Verifier la Privacy API

1. 1Console navigateur → Shopify.customerPrivacy.getTrackingConsent()
2. 2Avant consent : marketing = "no_interaction"
3. 3Apres acceptation Cookiebot : marketing = "yes"
4. 4Apres refus Cookiebot : marketing = "no"

Test pre-consent (navigation privee)

1. 1Ouvrir le site en navigation privee
2. 2Cliquer "Tout refuser" dans la banniere Cookiebot
3. 3GTM Preview : verifier que seuls les tags Necessary se declenchent
4. 4Network : aucune requete vers GA4, Meta, Google Ads

Test post-consent

1. 1Ouvrir le site en navigation privee
2. 2Cliquer "Tout accepter" dans la banniere
3. 3GTM Preview : tags analytics et marketing doivent se declencher
4. 4GA4 DebugView : events visibles en temps reel

Test purchase — commande test

Effectuer un achat test, puis executer dans la console :

dataLayer.filter(e => e.event === 'purchase')

• transaction_id unique (aucun doublon)
• value correcte (prix total avec taxes et livraison)
• currency valide (ISO 4217 — ex : EUR, USD)
• items array complet avec tous les produits

Nettoyage final

Apres verification du stack, confirmer le nettoyage des elements qui peuvent interferer :

• App "Facebook & Instagram" supprimee (pixel Meta natif)
• App "Google & YouTube" supprimee (tracking Google natif)
• Anciennes apps tracking supprimees (Trackify, Pixel Perfect, Elevar, etc.)
• Aucun script tracking manuel dans le theme (liquid)
• Banniere cookies + page opposition Shopify desactivees (aucune region cochee)

11Troubleshooting