Démarrer avec SQL dans Composer et le serveur MCP Klaviyo
Objectif de cet article
Découvrez comment poser des questions d’analyse sur vos données Klaviyo en langage clair à l’aide de Composer ou du serveur Klaviyo Model Context Protocol (MCP). Klaviyo Data Platform SQL rassemble les profils, les audiences, les campagnes, les produits et les événements afin de répondre à des questions impliquant plusieurs ensembles de données. Vous n’avez pas besoin d’écrire du SQL.
SQL est actuellement en version bêta et est disponible pour tous les clients.
Avant de commencer
Choisissez où vous souhaitez poser vos questions :
- Utilisez Composer pour travailler dans le chat au sein de Klaviyo. Aucune configuration SQL supplémentaire n’est requise.
- Utilisez le serveur MCP de Klaviyo pour travailler dans un client d’IA connecté, comme Claude ou ChatGPT. Si vous avez déjà connecté Klaviyo, vous n’avez pas besoin d’installer un autre outil, même si vous devrez peut-être actualiser la liste des outils du client.
Les deux options utilisent les mêmes données et prennent en charge les mêmes types de questions d’analyse. SQL est conçu pour l’analyse. Pour les exportations de données en masse, utilisez d’autres outils Klaviyo, tels que les rapports personnalisés.
Les données ont généralement environ 30 minutes de retard par rapport à l’activité dans votre compte. Pour une commande, un envoi ou un changement d’adhésion très récent, vérifiez directement dans Klaviyo.
Posez votre première question d’analyse
Utiliser Composer
- Ouvrez Composer dans Klaviyo. Si vous avez besoin d’aide pour le trouver, consultez Démarrer avec Composer.
- Posez une question d’analyse en langage courant. Incluez l’indicateur, la période, ainsi que tout détail sur l’audience ou le produit. Par exemple : « Quels sont mes 5 meilleurs produits en nombre d’unités vendues au cours des 90 derniers jours ? »
- Passez en revue la réponse, puis posez des questions de suivi dans la même conversation afin de l’explorer plus en profondeur.
Composer décide quand utiliser SQL. Vous n’avez pas besoin de nommer un outil ni de modifier un paramètre.
Utiliser le serveur MCP de Klaviyo
Pour connecter un client d’IA, vous devez disposer du rôle de propriétaire, d’administrateur ou de gestionnaire dans le compte Klaviyo que vous souhaitez utiliser. Lorsque votre connexion utilise une clé d’API, la clé doit avoir accès aux ensembles de données concernés par votre question. Par exemple, une question sur les commandes et les segments nécessite un accès aux événements et aux segments.
- Connectez Klaviyo à l’aide du guide correspondant à votre client ou à votre configuration :
- Documentation pour les développeurs du serveur MCP de Klaviyo pour les connexions au terminal et au serveur distant
- FAQ sur l’application Klaviyo pour Claude
- Comment utiliser l’application Klaviyo pour ChatGPT
- Guide du serveur MCP Klaviyo pour les agences pour travailler sur l’ensemble des comptes clients
- Posez une question d’analyse détaillée dans votre client connecté. Vous n’avez pas besoin de nommer l’outil ask_analytics_question. Votre client le sélectionne lorsque cela est approprié pour la question.
- Examinez la réponse et poursuivez avec des questions de suivi. Si l’outil n’est pas disponible, actualisez la liste des outils Klaviyo de votre client en suivant les étapes de dépannage ci-dessous.
Si vous vous connectez via OAuth, suivez le guide de votre client pour examiner et accorder les autorisations demandées.
Approfondissez une réponse et vérifiez le calcul
SQL est utile lorsqu’une question nécessite des informations provenant de plusieurs ensembles de données. Par exemple, un décompte des commandes devient une analyse d’audience plus détaillée lorsque vous ajoutez les clients, l’appartenance à un segment, et le pays.
Commencez par une question, puis développez la réponse dans la même conversation :
- « Combien de commandes avons-nous reçues le mois dernier ? »
- « Combien de clients ont passé ces commandes ? »
- « Répartissez ces commandes selon les segments auxquels appartiennent actuellement les clients. »
- « Ventilez les résultats par segment et par pays, et incluez le chiffre d’affaires pour chaque groupe. »
- « Pour les premiers acheteurs, quelle quantité de navigation de produits a eu lieu au cours des 10 jours précédant leur première commande ? »
Demandez comment la réponse a été calculée avant de partager un chiffre important ou de l’utiliser pour prendre une décision. Par exemple :
- « Quels ensembles de données avez-vous utilisés ? »
- « Quelle plage de dates et quels filtres avez-vous appliqués ? »
- « Comment avez-vous défini le chiffre d’affaires dans ce calcul ? »
- « Expliquez-moi comment vous avez calculé ça. »
Utilisez l’explication pour vérifier que la réponse correspond à la question que vous aviez l’intention de poser. Si ce n’est pas le cas, précisez l’indicateur, les dates ou les filtres, puis reposez la question.
Les données sur lesquelles vous pouvez poser des questions
SQL peut répondre à des questions sur ces ensembles de données, sous réserve des autorisations de votre connexion.
Ensemble de données | Ce que vous pouvez analyser |
|---|---|
Profils | Attributs client, identifiants, valeur vie prédite, engagement du canal, propriétés de profil personnalisées, et consentement pour le marketing par e-mail et par SMS |
Segments | Audiences dynamiques avec un recalcul de l’appartenance à partir de conditions enregistrées ; l’analyse utilise l’appartenance actuelle |
Listes | Audiences dont vous pouvez connecter l’appartenance actuelle à des profils et à des événements |
Campagnes | Envois uniques, messages, variantes, y compris les tests A/B, et segments d’envoi |
Catalogue | Produits synchronisés depuis votre plateforme de commerce, y compris les catégories de produits et les variantes |
Événements | Activité e-commerce, messagerie, consentement, flux, avis, code de réduction, assistance, Klaviyo Customer Hub et intégrations, ainsi que volumes et taux marketing |
Événements et détails dans les événements
Les données d’événements disponibles incluent :
- Activité commerciale, comme l’ajout à un panier, la passation ou l’annulation d’une commande, les remboursements, et les consultations de produits
- Activité e-mail, notamment les réceptions, les ouvertures, les clics, les rebonds, les abandons, et les désabonnements
- Activité SMS et WhatsApp, y compris les réceptions, les clics, les échecs, le consentement, et les désabonnements
- Activité Push, y compris les réceptions, les ouvertures, et les rebonds
- Modifications de consentement et de suspension, y compris les abonnements, les désabonnements, les ajouts ou suppressions de suspension, et les mises à jour des préférences
- Activité du flux, y compris les entrées, les suppressions, l’exécution, les ignorés, et les démarrages
- Fusions de profils
- Envois d’avis et de notes, modifications, suppressions, et préparation à l’examen
- Attributions et utilisations des codes de réduction
- Activité des conversations avec l’assistance, y compris les démarrages, les messages reçus ou envoyés, les escalades, les résolutions, ainsi que la création ou la clôture de tickets
- Activité de Klaviyo Customer Hub, telle que des connexions, des favoris, des clics sur des produits ou des codes de réduction, et des consultations de blocs de contenu
- Événements d’intégration provenant de sources telles que votre API, Shopify et Lightspeed, notamment l’activité de paiement, les envois de formulaires, les inscriptions au programme de fidélité, les recherches et les expéditions
- Indicateurs marketing, notamment les nombres et les taux de livraison, de destinataires, d’ouvertures, de clics, de rebonds, de désabonnements, de signalements comme spam, et d’engagement humain
Certains événements contiennent des valeurs imbriquées : des groupes de détails associés au sein d’un événement. Par exemple, une commande peut contenir une liste d’articles, chacun avec un SKU, une quantité et un prix. SQL peut lire ces détails, afin que vous puissiez demander combien de commandes incluaient un SKU particulier, ou quel était le nombre moyen d’articles par commande.
Combiner des ensembles de données
SQL peut connecter des ensembles de données liés pour répondre à une question. On appelle cela une jointure, mais vous n’avez pas besoin de demander explicitement une jointure. Par exemple :
- Associez les messages de campagne aux noms de campagne et aux données d’engagement afin de comparer les campagnes nommées.
- Connectez l’appartenance actuelle à une liste ou à un segment aux profils et aux commandes afin d’analyser l’activité d’achat d’une audience.
- Ventilez une audience par pays, statut de consentement, ou valeur client prévue.
- Connectez des produits à des catégories, ou des variantes à des produits parents, afin d’analyser les performances d’un produit ou d’une catégorie.
- Connectez les attributions de codes de réduction à leurs utilisations afin de calculer le taux d’utilisation et d’identifier les codes de réduction non utilisés.
Exemples de questions
Adaptez les dates, les produits, les segments, et les détails de la campagne à votre compte.
Objectif | Exemple de question |
|---|---|
Comparer les commandes au fil du temps | « Combien de commandes avons-nous enregistrées au 2e trimestre 2025, au 1er trimestre 2026, et au 2e trimestre 2026 ? » |
Analyser les détails de la commande | « Combien de commandes au cours des 90 derniers jours incluaient le SKU FACEBUND01 ? » |
Résumer les revenus et les remboursements | « Résumez les commandes de juin : nombre total de commandes, chiffre d’affaires total, nombre de commandes remboursées, et montant total des remboursements. » |
Comprendre les achats répétés | « Quel pourcentage de clients a passé une seule commande ? » |
Mesurer le temps entre les achats | « Quel est le nombre moyen de jours entre le premier et le deuxième achat d’un client ? » |
Comparer la valeur client | « Comparez la valeur vie des clients engagés par e-mail à celle des clients qui ne s’engagent pas. » |
Trouver les meilleurs produits | « Quels sont mes 5 principaux produits par unités vendues au cours des 90 derniers jours ? » |
Comparer l’engagement de la campagne | « Quel jour de la semaine obtient les meilleurs taux d’ouverture de campagne ? » |
Explorer les performances des e-mails | « Quels ont été mes 10 e-mails les plus ouverts, à l’exclusion des campagnes de soldes ? » |
Analyser les appareils | « Quel est le fractionnement des appareils entre mobile et ordinateur pour les ouvertures de mes e-mails ? » |
Examiner l’activité du flux | « Quels flux ont envoyé des messages au cours de l’année écoulée ? » |
Comparer les performances des SMS | « Quel était mon taux de clics et mon taux de désabonnement pour les SMS en avril, mai, et juin ? » |
Examiner les rebonds | « Ma newsletter du 2 juillet a eu 5 514 rebonds. Provenaient-ils d’un seul fournisseur de messagerie ? Quels étaient les types de rebond ?» |
Vérifier la fréquence d’envoi | « Combien de profils ont reçu 2 e-mails ou plus en 1 jour ? » |
Comprendre les limites
Données indisponibles
SQL ne prend actuellement pas en charge :
- Appartenance à une liste ou à un segment à un moment donné dans le passé
- Les formulaires d’inscription ou leurs performances
- Objets personnalisés
- Modèles d’e-mail ou de SMS
Les événements d’intégrations peuvent inclure des soumissions de formulaires, mais cela ne signifie pas que SQL prend en charge l’analyse des formulaire d’inscription ou de leurs performances. Si votre question dépend de données indisponibles, la réponse peut être incomplète, ou le client peut être incapable de répondre.
Actualité des données et différences par rapport aux rapports Klaviyo
Les données ont généralement environ 30 minutes de retard par rapport à votre compte. Il est possible que l’activité récente n’apparaisse pas immédiatement.
Les chiffres doivent généralement être cohérents avec Klaviyo, mais de légères différences peuvent survenir en raison de définitions différentes, d’optimisations de requêtes ou de la fraîcheur des données. SQL utilise une source de données différente des autres méthodes d’accès aux données Klaviyo. Klaviyo a vérifié que ces données étaient cohérentes à 99 % au cours des 3 dernières années.
Demandez le calcul, la plage de dates, et les filtres lorsqu’un nombre diffère d’un rapport. L’explication peut vous aider à déterminer si vous comparez le même indicateur, et la même période.
Requêtes générées et délais d’expiration
SQL génère une requête à partir de votre question. À ce jour, il n’existe pas de points de terminaison où vous pouvez soumettre votre propre requête SQL, et recevoir un résultat garanti, reproductible. Des formulations différentes peuvent produire des requêtes différentes, et des résultats légèrement différents. Vérifiez le calcul pour les chiffres importants.
Un client MCP peut arrêter d’attendre une réponse plus tôt que Composer ne le ferait. Claude, par exemple, a une fenêtre de délai d’expiration de 60 secondes. Si une question expire, réduisez la plage de dates, diminuez le nombre de ventilations, ou fractionnez l’analyse en questions plus petites.
Résolution de problèmes
L’outil d’analyse n’est pas disponible
Si vous ne voyez pas ask_analytics_question dans votre client d’IA, confirmez que SQL est activé pour votre compte, puis actualisez la liste des outils Klaviyo du client.
Dans Claude :
- Accédez à Personnaliser > Connecteurs > Klaviyo.
- Ouvrez le menu à trois points dans le coin supérieur droit.
- Cliquez sur Actualiser la liste des outils, puis réessayez votre question.
SQL ne peut pas renvoyer des données que vous savez être dans votre compte
Vérifiez que l’ensemble de données est pris en charge et tenez compte du délai habituel de 30 minutes. Si votre connexion utilise une clé d’API, vérifiez qu’elle a accès à chaque ensemble de données concerné, comme les profils, les segments, les listes, les campagnes, les catalogues ou les événements. Mettez à jour les autorisations manquantes dans Klaviyo, actualisez la liste des outils Klaviyo du client, puis relancez la question.
Pour une connexion OAuth, consultez les autorisations à l’aide du guide de connexion de votre client.
Une question expire
Essayez une plage de dates plus courte ou moins de ventilations, ou fractionnez la question en questions plus petites. Réessayez la question plus précise, puis exploitez le résultat avec des questions de suivi.
Un numéro ne correspond pas à Klaviyo
Demandez comment SQL a calculé le nombre, notamment les jeux de données, la plage de dates et les filtres. Vérifiez si les définitions des indicateurs et la fraîcheur des données expliquent la différence. Si la différence est importante, contactez l’assistance Klaviyo et partagez la question, le nombre renvoyé et le nombre que vous attendiez.
Composer refuse une question
Reformulez la question avec un indicateur spécifique, une plage de dates, et une audience. Vérifiez qu’elle utilise l’un des ensembles de données pris en charge, puis réessayez.