Résolution de problèmes liés aux intégrations, aux événements et aux widgets sur site tiers dans Klaviyo

Problèmes courants avec les outils tiers

Lorsque vous utilisez des applications tierces avec Klaviyo (comme des plug-in e-commerce, des outils d’avis ou des widgets de page), vous pouvez rencontrer des problèmes tels que :

• Intégrations signalant des problèmes de connexion
• Événements ou propriétés attendus qui n’apparaissent pas dans Klaviyo
• Variables dynamiques (par exemple, {{{ review_url }} ou tags de code de réduction) affichées comme vides
• Les widgets ou formulaires sur site ne se chargent pas de manière cohérente sur vos pages.

Ce guide décrit les vérifications de base que vous pouvez effectuer avant de contacter l’assistance.

Vérifier le statut de l’intégration et la connectivité

1. Vérifiez l’intégration dans Klaviyo:

• Accédez aux Intégrations et vérifiez que l’intégration appropriée (par exemple, WooCommerce ou votre application d’avis) est activée.
• Si vous avez reçu un e-mail concernant un problème de connexion, suivez les instructions qu’il contient (par exemple, réautoriser l’intégration).

2. Exécutez une action de test à partir de votre site ou de votre application :

• Passez une commande de test, envoyez un avis ou effectuez une action de test qui doit envoyer des données à Klaviyo.

3. Dans Klaviyo, vérifiez :

• Analyses > Indicateurs pour les nouveaux événements liés à cet outil.
• Un profil affecté pour la nouvelle activité de cette intégration.

Si les actions récentes n’apparaissent pas du tout dans Klaviyo, il peut y avoir un problème de connexion ou de configuration dans l’application tierce qui l’empêche d’envoyer des données.

Diagnostiquer les événements manquants ou les variables vides

Parfois, l’intégration est connectée, mais certaines données (par exemple, une URL ou un code de réduction d’avis) sont manquantes ou vides.

1. Identifiez l’ événement que votre flux ou votre e-mail utilise :

• Ouvrez le flux et notez l’ événement déclencheur (par exemple, un événement Commande Traitée ou un événement Avis Personnalisé).

2. Accédez à Analyses > Indicateurs, sélectionnez cet indicateur et ouvrez un événement récent.
3. Détails de l’événement :

• Confirmez que la propriété que vous attendez (par exemple, review_url ou une valeur de code de réduction) est présente et qu’elle a une valeur.

4. Si la propriété est manquante ou vide dans la charge utile de l’événement :

• L’application tierce n’envoie pas ces données à Klaviyo pour cet événement.
• Vérifiez les paramètres d'intégration de l’application pour vous assurer que le champ est activé ou contactez l’assistance de l’application.

5. Si la propriété existe avec une valeur mais qu’elle apparaît vide dans votre e-mail :

• Vérifiez que la variable dynamique de votre modèle correspond exactement au nom de la propriété (par exemple, {{ review_url }} si la propriété s’appelle review_url).
• Confirmez que l’e-mail est déclenché par le même événement que celui qui contient la propriété. L’utilisation d’un autre événement peut ne pas fournir les variables attendues.

Pour les problèmes liés au code de réduction dans les flux, vérifiez également :

• Que l’élément ou le tag du code de réduction est configuré correctement pour la plateforme de votre boutique.
• Que l’intégration sous-jacente (telle que WooCommerce ou Shopify) a des codes de réduction actifs et valides associés au flux.

Résoudre les problèmes liés aux widgets sur site qui n’apparaissent pas

Si les widgets d’un outil tiers n’apparaissent que parfois ou pas du tout sur vos pages :

1. Confirmez que le widget ou le plug-in est correctement installé conformément aux instructions du fournisseur.
2. Assurez-vous que les scripts pertinents (par exemple, votre script de widget d’avis et le script sur site de Klaviyo) sont en cours de chargement sur les pages concernées.
3. Recherchez les problèmes courants tels que :

• Mise en cache du générateur de thème ou de page qui empêche le chargement de nouveaux scripts ou de nouvelles sections.
• Conflit JavaScript provenant d’autres applications.
• Conteneurs HTML manquants ou incorrects (par exemple, une division ou un identifiant manquant à l’endroit où le widget s’attend à s’afficher).

4. Testez dans une fenêtre de navigateur privée/incognito et, si possible, dans un thème différent ou une page minimale pour exclure les conflits.

Si le script de widget ne se charge jamais, ou s’il se charge mais ne s’affiche pas, partagez les journaux et les captures d’écran de la console de navigation avec l’équipe d’assistance du fournisseur de widget.

Quand contacter le fournisseur de l’application ou l’assistance Klaviyo

En général :

• Contactez le fournisseur de l’application lorsque :
• Les données sont manquantes ou vides dans la charge utile d’événement envoyée à Klaviyo.
• Un widget ou un plug-in n’apparaît pas sur votre site web comme prévu.
• Vous en avez besoin pour envoyer des événements ou des propriétés supplémentaires à Klaviyo.
• Contactez l’assistance Klaviyo lorsque :
• Les événements et les propriétés sont présents dans Klaviyo, mais vous ne pouvez pas les utiliser dans les segments, les flux ou les modèles comme prévu.
• Vous voyez des erreurs ou des comportements inattendus dans l’application Klaviyo elle-même.

Avant de communiquer, recueillez les informations suivantes :

• Captures d’écran de vos paramètres d'intégration.
• Exemples d’événements récents provenant d’ Analyses > Indicateurs.
• Des captures d’écran ou des liens montrant le problème (par exemple, des variables vides dans un e-mail de test ou un widget manquant sur une page produit spécifique).

En fournissant ces informations, votre fournisseur d’application et le service d’assistance de Klaviyo pourront identifier rapidement si le problème concerne les données envoyées à Klaviyo ou comment elles sont utilisées une fois qu’elles sont arrivées.