Résolution des problèmes liés au tracking d’ajout au panier
Avant de commencer
Pour certaines plateformes d’e-commerce, les événements Ajouté au panier sont suivis automatiquement. Pour d’autres plateformes d’e-commerce, vous devez ajouter manuellement un extrait de code à votre site.
Avant de consulter ce guide, assurez-vous que vous :
- Activez le tracking Added to Cart , s’il n’a pas été ajouté automatiquement via votre intégration.
- Activez le JavaScript onsite de Klaviyo, appelé Klaviyo.js, si votre tracking Ajouté au panier utilise un extrait de code JavaScript. Découvrez comment faire dans les scénarios de dépannage ci-dessous. Le tracking des pixels Shopify utilise le paramètre distinct décrit ci-dessous.
Si vous utilisez BigCommerce, assurez-vous d’activer le tracking Viewed Product, qui est requis pour que le tracking Added to Cart fonctionne correctement. Des conseils pour activer le tracking Viewed Product sont fournis dans les guides de configuration liés ci-dessous. Si vous rencontrez des problèmes avec le tracking Viewed Product, veuillez consulter notre guide sur le dépannage du tracking Viewed Product.
Les intégrations e-commerce suivantes prennent en charge le tracking Added to Cart, et cela fonctionne comme suit :
- Shopify
Activé via un pixel Shopify lorsque vous cochez le paramètre Suivre les événements comportementaux - BigCommerce
Nécessite un extrait de code installé manuellement - Magento 2
Ajouté automatiquement par Klaviyo - WooCommerce
Ajouté automatiquement par Klaviyo - PrestaShop
Ajouté automatiquement par Klaviyo - Salesforce Commerce Cloud
Ajouté automatiquement par Klaviyo - suivi uniquement pour les utilisateurs connectés
Si vous utilisez une plateforme d’e-commerce sans intégration Klaviyo préconfigurée, ou une plateforme personnalisée, découvrez comment activer le tracking Viewed Product et Added to Cart sur notre site pour les développeurs.
Test du tracking d’ajout au panier
Pour tester que votre tracking Ajouté au panier est correctement configuré, suivez ces étapes :
Si votre boutique Shopify exige un consentement pour le tracking sur site, fournissez ce consentement avant d’effectuer un test.
- Accédez à votre site web
- Identifiez-vous à l’aide de la méthode correspondant à votre plateforme :
- Shopify : Connectez-vous à un compte client sur votre boutique à l’aide d’une adresse e-mail qui possède déjà un profil Klaviyo. Pour d’autres façons de vous identifier, consultez le test du tracking du pixel Shopify.
- Salesforce Commerce Cloud: Connectez-vous à votre compte de boutique avec votre adresse e-mail de test.
- Autres plateformes : Sur votre page d’accueil, ajoutez ce qui suit à la fin de l’URL, en remplaçant example@gmail.com par votre adresse e-mail :
?utm_email=example@gmail.com

- Actualisez la page.
- Accédez à une page produit sur votre site avec un produit en stock
- Cliquez sur le bouton « Ajouter au panier » sur la page
- Recherchez dans Klaviyo l’adresse e-mail que vous avez utilisée à l’étape 2, puis ouvrez le profil correspondant.

Vous devriez constater qu’un profil Klaviyo a été créé pour vous (s’il n’en existait pas déjà un) et qu’un événement Added to Cart a été enregistré dans votre fil d’activité.
Pour afficher un flux de tous les événements Added to Cart au fil du temps :
- Accédez à Analyse > Indicateurs dans Klaviyo.
- Recherchez Added to Cart, cliquez sur le nom de l’indicateur, puis sélectionnez Flux d’activité pour afficher les événements. Vous pouvez également utiliser Graphique, Carte d’activité, Meilleures personnes et Cohortes pour explorer les données. Les événements de pixel Shopify ont une icône Shopify ; les événements envoyés via Klaviyo.js ont une icône d’engrenage. Si vous avez plus d’un indicateur Added to Cart, choisissez celui correspondant à votre configuration de tracking actuelle.

Une fois que vous avez examiné les scénarios de dépannage ci-dessous et effectué des modifications, vous devez tester à nouveau votre tracking pour vous assurer qu’il fonctionne correctement.
Scénarios de résolution de problèmes
Passez en revue les questions suivantes afin de diagnostiquer la cause de vos problèmes Added to Cart. Notez que certaines étapes sont générales, tandis que d’autres dépendent de la plateforme e-commerce que vous utilisez.
Avez-vous activé le tracking Active on Site de Klaviyo ?
Pour le tracking Ajouté au panier qui utilise un extrait de code JavaScript, Klaviyo.js doit être installé afin que Klaviyo puisse identifier les visiteurs et enregistrer leur activité. Klaviyo.js permet également le tracking Actif sur le site. Pour le tracking du pixel Shopify, vérifiez les paramètres d’événement comportemental dans la section Shopify ci-dessous.
Klaviyo ajoute Klaviyo.js automatiquement lors de l’intégration, bien que certaines intégrations exigent que vous cochiez un paramètre pour l’activer. Découvrez votre plateforme e-commerce spécifique et comment tester que Klaviyo.js fonctionne :
- Shopify
Klaviyo.js est ajouté automatiquement via l’intégration ou via l’intégration de l’application Klaviyo dans Shopify, si vous l’activez. Pour en savoir plus sur l’intégration de l’application et le tracking sur site pour Shopify. - WooCommerce
Klaviyo.js est ajouté automatiquement lorsque vous intégrez WooCommerce, et vous pouvez vous assurer d’avoir effectué toutes les étapes en lisant notre guide d’intégration WooCommerce. Pour tester votre JavaScript sur site, sélectionnez l’onglet intégrations, puis cliquez sur Gérer les données > Configurer le tracking web. Ensuite, trouvez l’étape où vous pouvez saisir l’URL de votre site dans le champ, puis suivez les instructions pour tester votre tracking. - BigCommerce
Assurez-vous d’avoir coché l’option sur votre page des paramètres d’intégrations pour Ajouter automatiquement le JavaScript sur site Klaviyo. Ensuite, suivez les étapes pour tester votre JavaScript sur site. - Magento 2
Klaviyo.js est ajouté automatiquement lorsque vous effectuez une intégration avec Magento 2, et vous pouvez vous assurer d’avoir effectué toutes les étapes en consultant notre guide d’intégration Magento 2. Pour tester votre JavaScript sur site, sélectionnez l’onglet intégrations, puis cliquez sur Gérer les données > Configurer le tracking web. Ensuite, trouvez l’étape où vous pouvez saisir l’URL de votre site dans le champ, puis suivez les instructions pour tester votre tracking. - PrestaShop
Klaviyo.js est ajouté automatiquement lorsque vous intégrez PrestaShop, et vous pouvez vous assurer d’avoir suivi toutes les étapes en consultant notre guide d’intégration PrestaShop. Pour tester votre JavaScript sur site, sélectionnez l’onglet intégrations, puis cliquez sur Gérer les données > Configurer le tracking web. Ensuite, trouvez l’étape où vous pouvez saisir l’URL de votre site dans le champ, puis suivez les instructions pour tester votre tracking.
Pour les utilisateurs de Shopify : avez-vous activé le tracking des événements comportementaux ?
- Dans Klaviyo, sélectionnez Intégrations, puis Shopify.
- Dans la section Tracking sur site, recherchez fonctionnalités de tracking supplémentaires et utilisez l’option affichée :
- Suivre les événements comportementaux : Cochez la case, puis cliquez sur Mettre à jour les paramètres. Terminez toutes les demandes d’autorisation, puis retournez dans Klaviyo.
- Premiers pas : Cliquez sur Premiers pas et sélectionnez Événements comportementaux. Cliquez sur Suivant si vous y êtes invité, passez en revue les options de synchronisation des profils, et cliquez sur Enregistrer. Terminez toutes les invites d’autorisation, puis revenez à Klaviyo.
L’intégration de l’application Klaviyo ajoute Klaviyo.js pour le tracking Active on Site et Viewed Product. Si vous avez modifié votre thème Shopify, vérifiez que l’intégration de l’application est activée pour le nouveau thème. Suivez le guide pour activer l’intégration de l’application Klaviyo dans Shopify.
Avez-vous récemment changé de plateforme d’e-commerce ?
Si vous avez récemment changé de plateforme e-commerce, vous devrez ajouter le tracking Viewed Product et Added to Cart à votre nouveau site. Consultez les informations de la section Avant de commencer ci-dessus pour en savoir plus sur le tracking Viewed Product et Added to Cart pour votre nouvelle plateforme.
Avez-vous récemment mis à jour le thème de votre boutique ou effectué d’autres mises à jour de votre plateforme e-commerce ?
Si vous avez récemment mis à jour le thème de votre boutique, vous devrez peut-être réinstaller Klaviyo.js, l’extrait de code Viewed Product et l’extrait de code Added to Cart (pour BigCommerce) sur votre nouveau thème, selon la plateforme. D’autres mises à jour de votre plateforme e-commerce peuvent également affecter les extraits de code précédemment ajoutés à votre site.
Pour réinstaller l’extrait de code Viewed Product pour BigCommerce, suivez les instructions du guide de configuration de l’intégration BigCommerce, et pour l’extrait de code Added to Cart, suivez le guide de création d’un événement « Added to Cart » pour BigCommerce.
Si vous utilisez WooCommerce ou Magento, ou si vous utilisez l’intégration d’application Klaviyo dans Shopify, mais que vous avez apporté des modifications à votre site et que l’événement n’est désormais plus tracking, vous devez contacter l’assistance Klaviyo afin d’aider à diagnostiquer le problème.
Pour les utilisateurs de BigCommerce : votre boutique e-commerce est-elle connectée à plusieurs comptes Klaviyo ?
Si vous avez une boutique connectée à plusieurs comptes Klaviyo, cela peut entraîner des problèmes avec le tracking Actif sur le site, Produit consulté et Ajouté au panier. Des doublons de Klaviyo.js peuvent entraîner une interruption du tracking sur site.
Pour vérifier si vous avez des doublons de Klaviyo.js :
- Affichez le code source de votre page de vitrine et recherchez
klaviyo.js. Un tag de script Klaviyo.js peut ressembler à ceci :
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=API_KEY"></script>- Si vous trouvez plus d’un tag de script Klaviyo.js, comparez les clés d’API publiques dans leurs URL. La clé peut apparaître après
company_id=ou dans le chemin de l’URL avant/klaviyo.js. Des clés différentes indiquent que des scripts provenant de comptes Klaviyo différents sont présents. - Pour vous assurer que le doublon est correctement supprimé de votre site, veuillez contacter l’assistance Klaviyo.
Pour les utilisateurs de BigCommerce : utilisez-vous le bon extrait de code pour votre bouton Ajouter au panier ?
BigCommerce nécessite un extrait de code installé manuellement pour utiliser le tracking Added to Cart. Il existe 2 extraits de code différents que vous pouvez installer dans votre thème selon que votre bouton « Add to Cart » dispose d’un ID ou non. Veuillez consulter notre guide sur comment créer un événement « Added to Cart » pour BigCommerce pour plus d’informations sur la façon de vérifier cela.
Pour les utilisateurs de WooCommerce et Magento : utilisez-vous la version la plus récente de votre plug-in d’intégrations ?
Si vous utilisez WooCommerce ou Magento, les problèmes de tracking Added to Cart peuvent être liés à d’autres problèmes avec le plug-in Klaviyo de votre plateforme.
- Si les événements Added to Cart ne font pas l’objet d’un tracking, vérifiez si l’événement Started Checkout fait l’objet d’un tracking en recherchant Started Checkout dans Analytics > Indicateurs dans Klaviyo.
- Si ni Added to Cart ni Started Checkout ne sont trackés, il se peut qu’il y ait un problème avec votre plug-in.
- Vérifiez que vous utilisez la version la plus récente du plug-in pour vos intégrations. Si nécessaire, mettez à jour vers la dernière version dans WooCommerce ou Magento, ou vous pouvez télécharger la dernière version depuis la fiche de la plateforme concernée.
Pour les utilisateurs de Shopify : avez-vous besoin du consentement aux cookies des visiteurs dans l’UE, l’EEE, le Royaume-Uni et la Suisse avant d’autoriser le tracking sur site ?
En fonction de vos paramètres de confidentialité client dans Shopify, Klaviyo ne peut pas suivre les événements sur site pour les visiteurs de votre boutique Shopify situés dans l’UE, dans l’EEE, au Royaume-Uni et en Suisse, à moins qu’ils n’aient donné leur consentement.
Contacter le service d’assistance de Klaviyo
Si vous rencontrez toujours des problèmes après avoir consulté cette liste et testé votre tracking, veuillez nous contacter dans notre Communauté ou contacter notre équipe d’assistance.
Ressources supplémentaires
Learn how to troubleshoot other metrics:
- Troubleshooting viewed product tracking
Learn how to troubleshoot issues with your Viewed Product tracking, which is used to track when visitors view products on your site. For some ecommerce platforms, Viewed Product is tracked automatically when you integrate with Klaviyo. For other ecommerce platforms, a snippet must be manually added to your product page template.
- Troubleshooting placed order tracking
Placed Order tracking is included with ecommerce integrations and does not require any additional setup. Before consulting this guide, make sure you have properly set up, configured, and enabled your ecommerce integration.
- Troubleshooting started checkout tracking
Started Checkout tracking is included with many ecommerce integrations and does not require any additional setup. Before consulting this guide, make sure you have properly set up, configured, and enabled your ecommerce integration.
Other resources:
- Getting started with Klaviyo onsite tracking
Learn about the different ways that Klaviyo can support onsite tracking on your ecommerce site. There are 2 key types of onsite tracking:
- Troubleshooting your Shopify integration
Learn how to solve issues with your Shopify integration setup by following the relevant troubleshooting scenario described below. If you are encountering issues not on this list, please reach out on our Community or to our Support Team.