Cet article vous aide à identifier les raisons les plus courantes pour lesquelles un widget iAdvize ne s’affiche pas sur votre site, et vous guide pas à pas pour corriger la configuration.
1. Cas spécifiques aux pages produits (PDP)
Le widget nécessite des données produit complètes pour s'afficher correctement sur vos pages produits.
⚙️ Étapes de vérification :
- Vérifiez la présence du product_id dans le code de la page de votre site
- Contrôlez que le produit existe dans votre catalogue transmis à iAdvize dans les connaissances
- Assurez-vous que l'identifiant de la page correspond exactement à celui du catalogue
- Vérifiez la richesse des données produit : nom, description, catégorie, caractéristiques clés
⚠️ Points d'attention :
- Sans product_id, le widget ne peut pas contextualiser la page produit
- L'identifiant doit être stable, unique et cohérent entre le site et le catalogue
- Des données produit pauvres ou incomplètes peuvent empêcher l'affichage
💡 Conseil :
Enrichissez au maximum les attributs essentiels de vos produits (description détaillée, caractéristiques techniques, catégorie) pour permettre au widget de générer un contenu pertinent.
2. Cas spécifiques aux pages catégories (PLP)
Le widget s'appuie sur le contexte de la page catégorie pour s'afficher.
⚙️ Étapes de vérification :
- Vérifiez la structure de l'URL : elle doit être claire et stable
- Contrôlez la correspondance entre l'URL et les catégories de votre catalogue
- Assurez-vous que le contexte de la page est identifiable (via l'URL ou les données disponibles)
⚠️ Points d'attention :
- Les URLs génériques ou dynamiques peuvent empêcher l'identification correcte de la catégorie
- Si le contexte ne peut pas être identifié de manière fiable, l'affichage peut être bloqué
- Même si l'URL est correcte, des données catégorie insuffisantes peuvent bloquer l'affichage
💡 Conseil :
Privilégiez des structures d'URL explicites incluant le nom ou l'identifiant de la catégorie.
Exemple:
- ✅ : /categorie/smartphones
- ❌ : /cat?id=123
3. Contrôlez l’intégration technique du widget
3.1. Le sélecteur CSS est absent ou incorrect
Pour les widgets intégrés à un emplacement précis, un sélecteur CSS valide est indispensable.
⚙️ Étapes de vérification :
- Vérifiez que le sélecteur est correct et correspond à un élément existant
- Contrôlez que le sélecteur existe sur toutes les pages ciblées
- Assurez-vous qu'il n'est pas modifié dynamiquement après le chargement de la page
⚠️ Point d'attention :
Un changement de structure HTML peut rendre un sélecteur obsolète sans erreur visible.
3.2. Le starter n’est pas encore généré
Les Conversation Starters sont générés à la demande, uniquement lorsqu'une page éligible est visitée.
⚙️ Étapes de vérification :
- Vérifiez que la page a été visitée après la mise en place du widget
- Contrôlez que les prérequis sont remplis : produit existant, catalogue à jour, langue correcte
⚠️ Point d'attention :
Pour être affiché, le système doit générer au moins autant de starters que le nombre configuré dans votre administration. Si 3 starters sont attendus mais que seulement 2 sont générés, aucun starter ne sera affiché. Vos connaissances doivent être suffisamment riches.
💡 Conseil :
Testez l'affichage en naviguant réellement sur les pages concernées, en mode navigation privée pour éviter les effets de cache et enrichissez vos connaissances.
4. Le widget est hors de la zone visible
Un widget peut être techniquement chargé mais ne jamais être vu si le visiteur ne scroll pas jusqu'à son emplacement.
⚙️ Étapes de vérification :
- Vérifiez la position du widget sur la page
- Testez le parcours utilisateur pour identifier si le widget est dans la zone de scroll habituelle
- Analysez le comportement réel des visiteurs sur vos pages
💡 Conseil :
Privilégiez des formats visibles rapidement (au dessus de la ligne de flottaison) ou des widgets flottants lorsque le scroll est limité.
5. Vérifiez configuration de votre Assistant
5.1. Incohérence de langue
Le widget ne s'affiche pas si la langue détectée sur le site ne correspond pas à celle configurée pour l'Assistant Shopping IA.
⚙️ Étapes de vérification :
- Vérifiez la langue du site et du navigateur
- Contrôlez la langue configurée dans l'Assistant Shopping et les règles associées
- Pour les sites multilingues avec transfert vers des répondants humains, vérifiez que chaque langue dispose de règles dédiées ou que la langue est explicitement forcée dans le tag iAdvize
5.2. Clé d’identification absente dans vos connaissances
Dans de rares cas, une clé d'identification manquante dans la base de connaissances peut bloquer l'affichage.
⚙️ Étapes de vérification :
- Accédez à Assistant Shopping > Connaissances
- Vérifiez que la donnée personnalisée est bien configurée avec votre identifiant produit (product_id)
⚠️ Point d'attention :
Cette situation est exceptionnelle et nécessite généralement une analyse. Contactez le support iAdvize si vous suspectez ce problème.
6. Vérifiez votre ciblage
Le widget peut être correctement configuré mais ne pas s'afficher si la stratégie de ciblage ne correspond pas aux pages réellement visitées.
⚙️ Étapes de vérification :
- Vérifiez les types de pages ciblées : PDP, PLP, autres pages
- Contrôlez les règles basées sur l'URL, le comportement ou la source de trafic
- Testez en désactivant temporairement certaines règles pour identifier celle qui bloque l'affichage
⚠️ Point d'attention :
Un ciblage trop restrictif est l'une des causes les plus fréquentes d'absence d'affichage.
💡 Conseil :
Commencez par un ciblage large puis affinez progressivement selon vos besoins et les performances observées.
Conclusion
Un widget qui ne s’affiche pas est généralement lié à un manque de données, une configuration technique incomplète ou des règles de ciblage inadaptées. En vérifiant méthodiquement les points abordés dans cet article, vous pouvez identifier rapidement la cause et rétablir l’affichage de vos widgets sur les pages clés de votre site.
💡 Astuce : si vos taux d’engagement restent faibles malgré une configuration correcte, vous pouvez appliquer nos bonnes pratiques pour maximiser l’impact de vos Conversation Starters.