Klaviyo
Guide technique du CRM e-mail et SMS pour Shopify : intégration native, événements, consentement, flows, attribution et vérification.
1Rôle et objectif
Klaviyo est le CRM e-mail et SMS connecté nativement à Shopify. Il collecte les données clients et les événements e-commerce qui alimentent les flows marketing automatisés.
- E-mails automatisés (bienvenue, abandon de panier, post-achat, reconquête)
- SMS marketing et transactionnels
- Segmentation avancée, fondée sur le comportement
- Attribution e-mail et SMS (chiffre d'affaires attribué aux campagnes)
- Intégration native Shopify (GTM inutile)
Klaviyo passe par l'intégration native Shopify, et non par GTM. Il ne fait pas partie du flux DataLayer → GTM → sGTM : c'est une destination autonome.
Sa place dans le dispositif
| Destination | Type | Consentement |
|---|---|---|
| GA4 | Transport sGTM | analytics_storage |
| Meta CAPI | Balise sGTM | ad_storage, ad_user_data |
| Google Ads Enhanced Conv. | Balise sGTM | ad_storage, ad_user_data |
| Klaviyo | Intégration native Shopify | ad_storage |
Flows essentiels
| Flow | Déclencheur | Effet attendu |
|---|---|---|
| Série de bienvenue (Welcome Series) | Subscribed to List | Accueil et première conversion |
| Abandon de panier | Added to Cart → pas de Placed Order | Récupération de chiffre d'affaires |
| Abandon du tunnel de paiement | Started Checkout → pas de Placed Order | Récupération de chiffre d'affaires |
| Post-achat | Placed Order | Avis clients, upsell, fidélisation |
| Reconquête (Winback) | Placed Order → inactif depuis 60 j ou plus | Réactivation des clients |
| Abandon de navigation (Browse Abandon) | Viewed Product → pas d'Add to Cart | Intérêt pour le produit |
Segments clés
- Engaged (ouverture ou clic dans les 30 derniers jours)
- VIP (3 commandes ou plus, ou 500 € ou plus)
- At Risk (aucune commande depuis 60 jours)
- Churned (aucune commande depuis 120 jours)
- New Subscribers (inscrits dans les 7 derniers jours)
Attribution e-mail et SMS
Klaviyo s'attribue une conversion lorsque le destinataire a ouvert ou cliqué pendant la fenêtre d'attribution.
| Type | Fenêtre par défaut | Condition |
|---|---|---|
| E-mail ouvert | 5 jours | Ouverture + commande |
| E-mail cliqué | 5 jours | Clic + commande |
| SMS cliqué | 5 jours | Clic + commande |
| Flow | 5 jours | Dernier e-mail ou SMS du flow |
Double attribution
Klaviyo et GA4 ou Meta peuvent s'attribuer la même conversion. C'est normal : chaque plateforme a son propre modèle d'attribution. N'additionnez jamais le chiffre d'affaires de plusieurs plateformes.
2Architecture
Intégration native ou sGTM
Contrairement à GA4, Meta CAPI et Google Ads, qui passent par la chaîne DataLayer → GTM → sGTM, Klaviyo s'appuie sur une intégration native Shopify, indépendante du reste.
Dispositif de tracking sGTM : Shopify → Addingwell → DataLayer → GTM Web → sGTM ├── GA4 (transport côté serveur) ├── Meta CAPI (Full CAPI, serveur uniquement) └── Google Ads Enhanced Conversions Klaviyo (indépendant) : Shopify → Intégration native ├── API Shopify (commandes, clients, produits) ├── App embed (tracking sur le site) ├── Web pixels (tunnel de paiement, soumis au consentement) └── Webhooks (expéditions, remboursements)
Klaviyo ne demande aucune configuration dans GTM : l'app Shopify gère toute l'intégration. Son seul lien avec le dispositif de tracking, c'est le consentement, via la passerelle Cookiebot → Privacy API.
3Intégration native Shopify
Flux de données
Boutique Shopify ├── API Shopify (commandes, clients, produits) │ └── Synchronisation automatique vers Klaviyo │ ├── App embed Klaviyo (vitrine) │ └── Active l'identification (Identify) et le tracking sur le site │ ├── Web pixels Klaviyo (tunnel de paiement) │ └── Événements du paiement (via la Shopify Privacy API) │ └── Webhooks Shopify → Klaviyo └── Commandes, expéditions, remboursements
Ce que Klaviyo reçoit de Shopify
- Le catalogue produits (synchronisation automatique)
- L'historique des commandes (importé à l'installation)
- Les profils clients (e-mail, nom, adresse)
- Les événements en temps réel (Placed Order, Started Checkout, etc.)
- Les données d'expédition et de remboursement
Étapes d'installation
Web pixels Klaviyo
L'app installe automatiquement les web pixels Klaviyo. Ils suivent les événements du tunnel de paiement dans la sandbox Shopify.
- Started Checkout : le client entre dans le tunnel de paiement
- Order Completed : achat confirmé (dédupliqué avec l'API)
Les web pixels dépendent de la Shopify Privacy API. La passerelle Cookiebot décide de leur activation via setTrackingConsent.
4Consentement et confidentialité
Architecture du consentement
Cookiebot (CMP dans GTM)
↓
Passerelle → Shopify Privacy API
↓
setTrackingConsent({ marketing: true/false })
↓
Web pixels Klaviyo activés / bloquésL'app embed se charge avant le consentement
L'app embed Klaviyo se charge avant le consentement (environ 16 requêtes). Ces premières requêtes sont techniques, pas marketing. La passerelle Cookiebot → Shopify Privacy API décide ensuite quels web pixels peuvent se déclencher.
Ce que le consentement contrôle
| Élément Klaviyo | Consentement requis | Sans consentement |
|---|---|---|
| App embed (Active on Site, Viewed Product) | Non | Fonctionne toujours |
| Web pixels du tunnel de paiement | Oui (marketing) | Bloqués |
| Synchronisation API (Placed Order, profils) | Non | Côté serveur Shopify |
| E-mails transactionnels | Non | Envoi garanti |
| E-mails marketing | Opt-in e-mail requis | Sans rapport avec la CMP |
Consentement par destination (dans tout le dispositif)
| Destination | Signaux requis | Catégorie Cookiebot |
|---|---|---|
| GA4 | analytics_storage | Statistics |
| Meta CAPI | ad_storage, ad_user_data | Marketing |
| Google Ads | ad_storage, ad_user_data | Marketing |
| Klaviyo | ad_storage | Marketing |
| Cookiebot | Aucun | Necessary |
Le consentement recueilli par la CMP (Cookiebot) contrôle les web pixels Klaviyo. Il ne bloque ni la synchronisation par l'API Shopify, ni les e-mails. L'opt-in e-mail est un consentement distinct, recueilli par le formulaire Klaviyo.
5Événements et données
Événements Klaviyo
| Événement Klaviyo | Source | Description |
|---|---|---|
| Active on Site | App embed | Visiteur actif sur la boutique |
| Viewed Product | App embed | Consultation d'une fiche produit |
| Added to Cart | App embed | Ajout au panier |
| Started Checkout | Web pixel | Entrée dans le tunnel de paiement |
| Placed Order | API Shopify | Commande confirmée |
| Ordered Product | API Shopify | Détail par produit commandé |
| Fulfilled Order | Webhook Shopify | Commande expédiée |
| Cancelled Order | Webhook Shopify | Commande annulée |
| Refunded Order | Webhook Shopify | Commande remboursée |
Différence avec GA4
Les événements Klaviyo sont indépendants du DataLayer GTM. Klaviyo a sa propre collecte, via l'app embed et l'API Shopify : il n'y a donc pas de doublon.
Données natives et enrichissement
| Donnée | Source native | Enrichissement possible |
|---|---|---|
| E-mail, nom, adresse | API Shopify | Déjà complet |
| Historique des commandes | API Shopify (import de l'historique) | Déjà complet |
| Navigation sur le site | App embed | Déjà complet |
| Événements du tunnel de paiement | Web pixel | Soumis au consentement |
| UTM / source d'attribution | Non natif | Via des propriétés personnalisées ou des déclencheurs de flow |
| Score d'engagement | Calculé par Klaviyo | Segments personnalisés |
6Configuration
Prérequis
- Compte Klaviyo actif
- App Klaviyo installée sur Shopify
- Intégration Shopify connectée dans Klaviyo
- App embed activée dans le thème (Boutique en ligne → Thèmes → Personnaliser)
Étapes
- 1Installer l'app Klaviyo depuis le Shopify App Store
- 2Connecter la boutique dans Klaviyo → Integrations → Shopify
- 3Activer l'app embed dans l'éditeur de thème
- 4Vérifier l'import de l'historique des commandes
- 5Configurer les flows essentiels (bienvenue, abandon, post-achat)
- 6Vérifier que la passerelle de consentement Cookiebot fonctionne
Klaviyo ne demande aucune configuration dans GTM : l'app Shopify gère toute l'intégration. Son seul lien avec le dispositif de tracking, c'est le consentement, via la passerelle Cookiebot → Privacy API.
7Vérification
Vérifier l'intégration
- 1Klaviyo → Integrations → Shopify : vérifier que le statut indique « Connected » (connecté)
- 2Vérifier le nombre de profils synchronisés (il doit correspondre au nombre de clients Shopify)
- 3Vérifier que l'historique des commandes a bien été importé
Vérifier les événements
- 1Naviguer sur la boutique (connecté avec un e-mail connu)
- 2Klaviyo → Analytics → Activity Feed
- 3Vérifier Active on Site et Viewed Product après la navigation
- 4Ajouter un produit au panier → vérifier Added to Cart
- 5Passer une commande test → vérifier Placed Order
Vérifier le consentement
- 1Refuser le consentement dans Cookiebot
- 2Naviguer et vérifier que les web pixels sont bloqués
- 3Vérifier que l'app embed fonctionne toujours (Active on Site)
- 4Accepter le consentement → les web pixels doivent se réactiver
Checklist de la phase 3 : destinations (Klaviyo)
8Dépannage
Vérifier :
- 1Intégration Shopify connectée et active
- 2App embed activée dans l'éditeur de thème
- 3Aucun conflit avec un autre script Klaviyo
- 4Navigation en étant connecté avec un e-mail connu de Klaviyo
Vérifier :
- Web pixel Klaviyo actif dans Paramètres → Événements clients
- Consentement marketing accordé (passerelle Cookiebot → Privacy API)
- Visiteur identifié (e-mail connu) pour le suivi du tunnel de paiement
Causes normales :
- Double attribution Klaviyo + GA4 ou Meta (chaque plateforme a son modèle)
- Fenêtres d'attribution différentes (5 j chez Klaviyo, 7 j chez Meta)
- Ne jamais additionner le chiffre d'affaires de plusieurs plateformes
- Prendre Shopify comme référence pour le chiffre d'affaires total
Explication :
- L'app embed Klaviyo se charge au premier rendu, avant que le consentement ne soit donné. C'est le comportement normal.
- La passerelle Cookiebot → Shopify Privacy API contrôle le consentement des web pixels Klaviyo.
- Vérifiez que le snippet cookie-consent_boostecom.liquid est installé et que setTrackingConsent est appelé après CookiebotOnConsentReady.
Vérifiez la couche que vous venez d'installer
Scannez la boutique : 41 contrôles lisent ce qu'elle envoie maintenant à GA4, Meta et Google Ads.