GuideCRM~10 min

Klaviyo

Guide technique : CRM email et SMS pour Shopify. Integration native, events, consent, flows, attribution, verification.

Connectors0/1
Klaviyo Public API Key
Klaviyo > Settings > API Keys — ex : pk_xxxxx (integration native Shopify)

1Role / Objectif

Klaviyo est le CRM email/SMS connecte nativement a Shopify. Il collecte les donnees client et les events e-commerce pour alimenter les flows marketing automatises.

  • Emails automatises (welcome, abandon panier, post-achat, winback)
  • SMS marketing et transactionnel
  • Segmentation avancee basee sur le comportement
  • Attribution email/SMS (revenue attribue aux campagnes)
  • Integration native Shopify (pas besoin de GTM)

Klaviyo utilise l'integration native Shopify, pas GTM. Il ne fait pas partie du flux DataLayer → GTM → sGTM. C'est une destination autonome.

Place dans le stack

DestinationTypeConsent
GA4Transport sGTManalytics_storage
Meta CAPITag sGTMad_storage, ad_user_data
Google Ads Enhanced Conv.Tag sGTMad_storage, ad_user_data
KlaviyoIntegration native Shopifyad_storage

Flows essentiels

FlowTriggerImpact
Welcome SeriesSubscribed to ListOnboarding + premiere conversion
Abandon PanierAdded to Cart → pas de Placed OrderRecuperation revenue
Abandon CheckoutStarted Checkout → pas de Placed OrderRecuperation revenue
Post-AchatPlaced OrderReview, upsell, fidelisation
WinbackPlaced Order → inactif 60j+Reactivation clients
Browse AbandonViewed Product → pas de Add to CartEngagement produit

Segments cles

  • Engaged (ouvert/clique dans les 30j)
  • VIP (3+ commandes ou 500+ EUR)
  • At Risk (pas de commande depuis 60j)
  • Churned (pas de commande depuis 120j)
  • New Subscribers (inscrits dans les 7j)

Attribution Email / SMS

Klaviyo attribue une conversion si le destinataire a ouvert ou clique dans la fenetre d'attribution.

TypeFenetre par defautCondition
Email ouvert5 joursOuverture + commande
Email clique5 joursClic + commande
SMS clique5 joursClic + commande
Flow5 joursDernier email/SMS du flow

Double attribution

Klaviyo et GA4/Meta peuvent attribuer la meme conversion. C'est normal : chaque plateforme a son propre modele d'attribution. Ne pas additionner les revenus des differentes plateformes.

2Architecture

Native Shopify vs sGTM

Contrairement a GA4, Meta CAPI et Google Ads qui transitent par le stack DataLayer → GTM → sGTM, Klaviyo fonctionne via une integration native Shopify independante.

Stack tracking sGTM :
  Shopify → Addingwell → DataLayer → GTM Web → sGTM
    ├── GA4 (transport server-side)
    ├── Meta CAPI (Full CAPI, server-only)
    └── Google Ads Enhanced Conversions

Klaviyo (independant) :
  Shopify → Integration native
    ├── Shopify API (commandes, clients, produits)
    ├── App Embed (tracking onsite)
    ├── Web Pixels (checkout, soumis au consent)
    └── Webhooks (fulfillment, refunds)

Klaviyo n'a aucune configuration GTM. L'integration est entierement geree par l'app Shopify. Le seul lien avec le stack tracking est le consent via le bridge Cookiebot → Privacy API.

3Integration Native Shopify

Flux de donnees

Shopify Store
├── Shopify API (commandes, clients, produits)
│   └── Sync automatique vers Klaviyo
│
├── App Embed Klaviyo (storefront)
│   └── Active Identify, tracking on-site
│
├── Web Pixels Klaviyo (checkout)
│   └── Events checkout (via Shopify Privacy API)
│
└── Webhooks Shopify → Klaviyo
    └── Commandes, fulfillment, refunds

Ce que Klaviyo recoit de Shopify

  • Catalogue produits (sync automatique)
  • Historique commandes (backfill a l'installation)
  • Profils clients (email, nom, adresse)
  • Events en temps reel (Placed Order, Started Checkout...)
  • Donnees de fulfillment et refund

Etapes d'installation

1Installer l'app Klaviyo depuis le Shopify App Store
2Configurer la Public API Key dans l'app Klaviyo
3Verifier que l'app embed Klaviyo est active dans le theme
4Le bridge Cookiebot → Shopify Privacy API (Step 1.4) controle le consent pour Klaviyo

Web Pixels Klaviyo

Les web pixels Klaviyo sont automatiquement installes par l'app. Ils tracquent les events checkout dans le sandbox Shopify.

  • Started Checkout — debut du processus d'achat
  • Order Completed — achat confirme (deduplication avec API)

Les web pixels sont soumis a la Shopify Privacy API. Le bridge Cookiebot controle leur activation via setTrackingConsent.

Architecture consent

Cookiebot (CMP dans GTM)
        ↓
Bridge → Shopify Privacy API
        ↓
setTrackingConsent({ marketing: true/false })
        ↓
Web pixels Klaviyo actives / bloques

App Embed charge avant le consent

L'app embed Klaviyo charge avant le consent (~16 requetes). Les requetes initiales sont techniques (non-marketing). Le bridge Cookiebot → Shopify Privacy API controle ensuite quels web pixels peuvent fire.

Ce qui est controle par le consent

Element KlaviyoConsent requisSans consent
App embed (Active on Site, Viewed Product)NonFonctionne toujours
Web pixels checkoutOui (marketing)Bloque
Sync API (Placed Order, profils)NonServer-side Shopify
Emails transactionnelsNonEnvoi garanti
Emails marketingOpt-in email requisPas de rapport avec CMP

Consent par destination (dans le stack)

DestinationSignaux requisCategorie Cookiebot
GA4analytics_storageStatistics
Meta CAPIad_storage, ad_user_dataMarketing
Google Adsad_storage, ad_user_dataMarketing
Klaviyoad_storageMarketing
CookiebotAucunNecessary

Le consent CMP (Cookiebot) controle les web pixels Klaviyo. Il ne bloque pas les sync API Shopify ni les emails. L'opt-in email est un consentement separe (formulaire Klaviyo).

5Events & Data

Events Klaviyo

Event KlaviyoSourceDescription
Active on SiteApp embedVisiteur actif sur le store
Viewed ProductApp embedVue fiche produit
Added to CartApp embedAjout au panier
Started CheckoutWeb pixelDebut du checkout
Placed OrderShopify APICommande confirmee
Ordered ProductShopify APIDetail par produit commande
Fulfilled OrderShopify webhookCommande expediee
Cancelled OrderShopify webhookCommande annulee
Refunded OrderShopify webhookCommande remboursee

Difference avec GA4

Les events Klaviyo sont independants du DataLayer GTM. Klaviyo a sa propre collecte via l'app embed et l'API Shopify. Il n'y a pas de duplication.

Donnees natives vs enrichissement

DonneeSource nativeEnrichissement possible
Email, nom, adresseShopify APIDeja complet
Historique commandesShopify API (backfill)Deja complet
Navigation onsiteApp embedDeja complet
Events checkoutWeb pixelControle par consent
UTM / Source attributionNon natifVia custom properties ou flow triggers
Score engagementCalcule par KlaviyoSegments custom

6Configuration

Pre-requis

  • Compte Klaviyo actif
  • App Klaviyo installee sur Shopify
  • Integration Shopify connectee dans Klaviyo
  • App embed activee dans le theme (Online Store → Themes → Customize)

Etapes

  1. 1Installer l'app Klaviyo depuis le Shopify App Store
  2. 2Connecter le store dans Klaviyo → Integrations → Shopify
  3. 3Activer l'app embed dans le theme editor
  4. 4Verifier le backfill des commandes historiques
  5. 5Configurer les flows essentiels (Welcome, Abandon, Post-Achat)
  6. 6Verifier que le bridge consent Cookiebot fonctionne

Klaviyo n'a aucune configuration GTM. L'integration est entierement geree par l'app Shopify. Le seul lien avec le stack tracking est le consent via le bridge Cookiebot → Privacy API.

7Verification

Verifier l'integration

  1. 1Klaviyo → Integrations → Shopify → verifier statut "Connected"
  2. 2Verifier le nombre de profils syncs (doit correspondre aux clients Shopify)
  3. 3Verifier les commandes historiques importees

Verifier les events

  1. 1Naviguer sur le store (connecte avec un email connu)
  2. 2Klaviyo → Analytics → Activity Feed
  3. 3Verifier Active on Site, Viewed Product apres navigation
  4. 4Ajouter un produit au panier → verifier Added to Cart
  5. 5Completer un achat test → verifier Placed Order

Verifier le consent

  1. 1Refuser le consent via Cookiebot
  2. 2Naviguer et verifier que les web pixels sont bloques
  3. 3Verifier que l'app embed fonctionne toujours (Active on Site)
  4. 4Accepter le consent → les web pixels doivent se reactiver

Checklist Phase 3 — Destinations (Klaviyo)

Checklist Klaviyo0/3

8Troubleshooting

Pas d'events dans Klaviyo

Verifier :

  1. 1Integration Shopify connectee et active
  2. 2App embed activee dans le theme editor
  3. 3Pas de conflit avec un autre script Klaviyo
  4. 4Naviguer connecte avec un email connu de Klaviyo
Started Checkout manquant

Verifier :

  • Web pixel Klaviyo actif dans Settings → Customer Events
  • Consent marketing accorde (bridge Cookiebot → Privacy API)
  • Visiteur identifie (email connu) pour le tracking checkout
Revenue attribution incoherent

Causes normales :

  • Double attribution Klaviyo + GA4/Meta (chaque plateforme a son modele)
  • Fenetre d'attribution differente (5j Klaviyo vs 7j Meta)
  • Ne pas additionner les revenus cross-plateformes
  • Utiliser Shopify comme source de verite pour le revenue total
Klaviyo charge avant le consent (~16 requetes)

Explication :

  • L'app embed Klaviyo se charge au premier rendu, avant que le consent ne soit accorde. C'est le comportement normal.
  • Le bridge Cookiebot → Shopify Privacy API controle le consent pour les web pixels Klaviyo.
  • Verifier que le snippet cookie-consent_boostecom.liquid est installe et que setTrackingConsent est appele apres CookiebotOnConsentReady.