Intégration Klaviyo Shopify : le guide complet

Réponse courte. L'intégration Klaviyo Shopify repose sur trois canaux distincts : la synchronisation API serveur (profils, commandes, consentements), le tracking onsite JavaScript (navigation, panier, checkout) et le catalogue produit (feed utilisé par les recommandations et le contenu dynamique). Chaque canal peut tomber en panne indépendamment des deux autres, sans message d'erreur visible. Une intégration fiable se vérifie avec un protocole de QA régulier, pas seulement au moment de l'installation.

Un compte Klaviyo connecté à Shopify affiche un statut vert dans les Integrations. Cela ne dit rien sur ce qui remonte réellement, ni sur ce qui a cessé de remonter après un changement de thème ou l'ajout d'une app. Ce guide décrit l'architecture de l'intégration, les pannes silencieuses les plus fréquentes et le protocole de contrôle à faire tourner en continu. Pour l'installation pas à pas, notre checklist setup Klaviyo Shopify couvre les 14 étapes de configuration initiale. Ici, l'angle est différent : comprendre la plomberie pour savoir où chercher quand un flow ne se déclenche plus ou qu'un segment se vide.

1. Ce que le connecteur active vraiment

Le connecteur Shopify natif de Klaviyo donne l'impression d'un bloc unique : on l'active, et tout suit. En pratique, il active trois flux de données séparés, chacun avec sa propre mécanique, ses propres points de rupture et son propre calendrier de synchronisation.

Confondre ces trois canaux est la cause la plus fréquente de diagnostic raté. Une équipe qui voit des commandes remonter correctement dans Klaviyo peut conclure que "l'intégration fonctionne", alors que le tracking comportemental est mort depuis trois semaines et que les flows d'abandon ne se déclenchent plus pour personne.

2. Les 3 canaux de données de l'intégration Klaviyo Shopify

2.1 La synchronisation API serveur

C'est le canal le plus stable, parce qu'il ne dépend pas du navigateur du visiteur. Shopify pousse les événements de commande, les mises à jour de profil client et les changements de consentement directement au compte Klaviyo via l'intégration native. Un Placed Order correct prouve que ce canal fonctionne. Il ne prouve rien sur les deux autres.

2.2 Le tracking onsite JavaScript

Ce canal dépend d'un script chargé dans le thème (l'app embed Klaviyo) et exécuté dans le navigateur du visiteur. Il capte la navigation avant l'achat : consultation de fiche produit, ajout au panier, début de checkout. C'est le canal le plus fragile, parce qu'il dépend du thème, du consentement cookies et de l'absence de conflit avec d'autres scripts.

klaviyo.identify() permet d'associer un visiteur anonyme à un profil connu côté client, par exemple lors d'une connexion. C'est utile, mais ça reste soumis aux mêmes contraintes que le reste du tracking JavaScript : sans consentement, l'appel ne part pas.

2.3 Le catalogue produit

Klaviyo synchronise un feed produit depuis Shopify (Catalogs > Product Feed) : identifiants, titres, images, prix, disponibilité, variantes. Ce catalogue alimente les recommandations produit et les blocs dynamiques dans les templates email. Contrairement aux deux premiers canaux, une rupture ici ne bloque aucun envoi : elle produit des emails qui partent quand même, avec un bloc produit vide ou une image cassée. C'est la panne la plus difficile à repérer, parce qu'elle ne déclenche aucune alerte.

Pour aller plus loin sur l'exploitation du catalogue dans les templates, voir notre guide dynamic content Klaviyo.

3. Ce qui casse en silence

Ce sont les pannes qui ne génèrent ni erreur, ni notification, ni statut rouge dans l'interface Klaviyo. Elles se découvrent en général quand quelqu'un remarque que le revenu d'un flow a chuté, ou pas du tout.

La republication d'un thème désactive l'app embed

C'est le cas le plus fréquent. Publier un nouveau thème, même à partir d'une copie du thème existant, réinitialise en général les app embeds. La connexion Shopify reste affichée comme active dans Klaviyo, Placed Order continue de remonter (canal API serveur, indépendant du thème), mais Active on Site et Viewed Product s'arrêtent net. Sans contrôle régulier, ce type de panne peut durer des semaines avant d'être repéré.

La bannière de consentement bloque le script avant acceptation

Sur les marchés soumis au consentement cookies, le script de tracking onsite peut être retardé ou bloqué tant que le visiteur n'a pas accepté les cookies de mesure et de marketing. C'est un comportement attendu, pas un bug. L'erreur classique consiste à tester l'intégration en navigation privée sans accepter la bannière, puis à conclure à tort que rien ne fonctionne.

Un snippet legacy cohabite avec l'app officielle

Une intégration Klaviyo installée manuellement avant l'existence de l'app embed, puis jamais retirée lors du passage à l'app officielle, double le comptage des événements. Rien ne s'affiche en erreur. Les indices : des chiffres qui ne collent plus dans les rapports, des profils dupliqués, des segments dont la taille grossit plus vite que la base réelle.

Un checkout personnalisé n'est pas couvert par le tracking natif

Une boutique qui personnalise fortement son tunnel de commande, au-delà des extensions supportées par Shopify, peut voir Started Checkout s'arrêter de remonter après une migration technique, sans que rien d'autre ne signale le problème. Ce risque concerne surtout les boutiques avec un développement custom sur le checkout, pas une boutique standard.

Le catalogue se désynchronise après un archivage Shopify

Un produit archivé ou une variante retirée côté Shopify peut rester référencé dans une recommandation ou un bloc dynamique déjà construit. Le champ image ou le prix devient alors incohérent, sans que l'envoi de la campagne échoue. Le lecteur voit un email cassé ; l'équipe marketing ne voit rien dans ses tableaux de bord d'envoi.

Une app tierce interfère avec le DOM

Une app de reviews, d'upsell ou de page builder qui réécrit dynamiquement le contenu de la page peut retarder ou empêcher l'exécution du script Klaviyo, en particulier sur les pages produit. Le conflit ne remonte aucune erreur visible pour un profil marketing : seul un contrôle du réseau dans les outils de développement le révèle.

4. La checklist QA complète

Une intégration se contrôle canal par canal, pas globalement. Ce protocole se fait au lancement, puis après chaque changement de thème ou d'app, et en routine mensuelle.

Test du canal API serveur

1. Passer une commande test avec une adresse email dédiée au contrôle.
2. Vérifier que le profil apparaît dans Klaviyo sous quelques minutes.
3. Ouvrir l'Activity feed du profil et contrôler que Placed Order contient les bons champs : montant, devise, articles, code promo le cas échéant.
4. Vérifier que le statut de consentement du profil correspond à la case cochée (ou non) au checkout.

Test du canal onsite JavaScript

1. Ouvrir le site en navigation privée et accepter la bannière de consentement.
2. Consulter une fiche produit, ajouter un article au panier, démarrer un checkout.
3. Dans Klaviyo > Analytics > Events, vérifier que Active on Site, Viewed Product, Added to Cart et Started Checkout apparaissent dans l'ordre et quasiment en temps réel.
4. Refaire le test sans accepter la bannière : aucun événement comportemental ne doit remonter. Ce silence confirme que le blocage par consentement fait son travail.
5. Ouvrir les outils de développement, onglet réseau, et filtrer sur "klaviyo" pour confirmer que les requêtes partent bien depuis le navigateur.

Test du canal catalogue

1. Dans Klaviyo > Catalogs, vérifier le statut et la date de la dernière synchronisation.
2. Sélectionner trois produits au hasard : un best-seller, un produit récent et un produit en rupture de stock.
3. Comparer image, prix et disponibilité entre la fiche Shopify et l'entrée correspondante dans le catalogue Klaviyo.

Fréquence

• Avant chaque campagne à fort enjeu : au minimum les tests des canaux 1 et 2.
• Après chaque publication de thème ou changement de checkout : test complet du canal 2.
• Après l'installation ou la mise à jour d'une app touchant les pages produit : test du canal 2.
• Une fois par mois en routine, même sans changement connu.

5. Symptôme, cause probable, canal concerné

6. Répartition des responsabilités

L'app embed et les scripts de thème relèvent de l'équipe technique ou de l'agence qui gère Shopify. Les segments, les flows et le contenu des templates relèvent de l'équipe CRM. Le consentement et le catalogue concernent les deux : un changement de bannière cookies ou une refonte du catalogue produit doit être testé par les deux côtés avant mise en production. Pour les cas où les événements natifs Shopify ne suffisent pas, notre guide sur l'API Klaviyo pour envoyer des events custom détaille comment enrichir cette base sans dupliquer les événements existants.

Une intégration bien posée simplifie ensuite tout le reste : une segmentation Klaviyo fiable dépend d'une synchronisation propre, et un flow d'abandon bien conçu ne vaut rien si le tracking qui le déclenche est cassé depuis un mois.

FAQ

Faut-il un développeur pour intégrer Klaviyo à Shopify ?

Pas pour une boutique sur un thème standard compatible avec les app embeds : l'installation, la synchronisation et le tracking de base se font sans code. Un développeur devient nécessaire pour un storefront headless, un checkout fortement personnalisé, ou l'envoi d'événements custom que l'intégration native ne couvre pas.

Pourquoi mes événements onsite ont-ils disparu sans erreur visible ?

La cause la plus fréquente est la republication d'un thème, qui désactive l'app embed Klaviyo sans avertissement. Vérifiez d'abord l'activation de l'app embed dans le thème actif avant de chercher une explication plus complexe.

La synchronisation Shopify et le tracking onsite, c'est la même chose ?

Non. La synchronisation API serveur transporte les commandes et les profils indépendamment du navigateur du visiteur. Le tracking onsite dépend d'un script exécuté dans le navigateur et peut tomber en panne alors que la synchronisation continue de fonctionner normalement.

Le catalogue Klaviyo se met-il à jour automatiquement ?

Oui, via la synchronisation native avec Shopify, mais des écarts apparaissent régulièrement : produit archivé encore référencé, image manquante, variante retirée. Un contrôle ponctuel reste nécessaire, en particulier avant une campagne qui s'appuie fortement sur des recommandations produit.

À quelle fréquence faut-il auditer l'intégration ?

Après chaque changement de thème, de checkout ou d'app touchant les pages produit, et au minimum une fois par mois en routine. Une intégration qui fonctionnait au lancement peut se dégrader silencieusement des mois plus tard sans qu'aucune alerte ne le signale.

Fiabiliser votre intégration avant d'empiler les flows

Ajouter des automatisations sur une intégration mal contrôlée revient à construire sur des fondations qu'on n'a jamais testées. Vous cherchez une agence Klaviyo pour auditer votre intégration Shopify et sécuriser vos trois canaux de données ? Deliver accompagne les marques DTC depuis Tournai (BE). Réservez 30 minutes avec Charlotte ou consultez notre page agence Klaviyo.

Charlotte Rodrigues, CRM Lead chez Deliver.