Résoudre les problèmes de votre backend Search – Yext Help

Si vous rencontrez des problèmes liés à la qualité de vos résultats de recherche, c'est-à-dire si l'algorithme renvoie des résultats différents de ceux auxquels vous vous attendez, vous avez un problème de backend.

Vous trouverez ci-dessous les étapes recommandées pour commencer à dépanner votre problème de backend. Les modifications de la configuration devraient s'appliquer immédiatement, alors relancez les recherches lorsque vous enregistrez les modifications pour voir si votre problème est résolu. Une fois que vous avez résolu votre problème, vous pouvez ignorer les étapes restantes. Si vous rencontrez toujours un problème après avoir terminé ces étapes, consultez les articles d'aide sur la résolution de problèmes spécifiques pour obtenir des conseils supplémentaires.

Pour une approche générale du dépannage du backend, consultez la formation Dépanner le backend sur Hitchhikers. Nous allons utiliser les concepts discutés dans ce document sur cette page.

Ouvrez le log de recherche pour trouver la requête pour laquelle vous rencontrez des problèmes. Il y a deux méthodes pour le faire :
1. Accédez directement à l'écran des logs de recherche
  1. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
  2. Cliquez sur Journaux des recherches.
  3. Cliquez sur le journal de recherche souhaité. Vous pouvez également utiliser la barre de recherche si nécessaire.
2. Exécutez une recherche de test et ouvrez le journal à partir de là
  1. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
  2. Cliquez sur Test Search pour accéder à la recherche test plein écran ou à l'un des écrans de configuration dans la barre de navigation pour accéder à la recherche test de la barre latérale.
  3. Lancer une recherche test.
  4. Cliquez sur Dépanner la requête.
Vérifiez la demande d'API : Cliquez sur le bouton déroulant et cliquez sur Afficher le code dans le menu déroulant.
1. S'il y a une BACKEND_ERROR, cela indique un problème sous-jacent. Veuillez soumettre un ticket d'assistance pour qu'il soit étudié par notre équipe d'ingénierie.
Vérifiez les versions et les labels de votre configuration : cela apparaît dans les métadonnées en haut du journal de recherche. Assurez-vous que vous utilisez la bonne version et le bon label (staging ou production). Souvent, des résultats inattendus sont causés par l’expérience qui pointe vers une version obsolète de la configuration.
1. Si vous utilisez le mauvais label, relancez la recherche dans le lien de déploiement correct ou corrigez le label dans la recherche test.
2. Si vous avez besoin de mettre à jour ces versions ou souhaitez vérifier quelles versions sont disponibles :
  1. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
  2. Cliquez sur Historique des révisions.
  3. Cliquez sur la liste déroulante du label concerné pour voir quelles versions sont disponibles et sélectionnez celle que vous souhaitez définir.
  4. Chaque version dans la liste déroulante affiche la date et l'heure auxquelles elle a été sauvegardée. Si vous souhaitez obtenir plus d'informations, accédez à l'écran Historique des révisions pour voir par qui la version a été mise à jour et pour télécharger la configuration.
Vérifiez votre paramètre régional : Le paramètre régional de votre expérience de recherche doit correspondre aux paramètres régionaux des entités que vous essayez de retrouver. Si vos profils d’entité utilisent un paramètre régional « anglais » (en), alors le paramètre régional demandé doit être exactement « en ». Les requêtes pour d'autres paramètres régionaux similaires tels que « en_GB » ou « en_US » ne renverront que des profils avec ce paramètre régional exact.
1. Vérifiez le paramètre régional des profils d'entité.
  1. Si votre compte n'utilise qu'une seule langue, accédez à Paramètres du compte et cliquez sur Paramètres personnels. Vérifiez ce qui est rempli dans la langue principale du compte.
  2. Si votre compte utilise plusieurs langues, chaque entité peut utiliser un paramètre régional différent. Vous pouvez vérifier la langue des entités individuelles ou exporter des entités et inclure le champ « Langue du profil ».
  3. Vérifiez les langues par rapport aux paramètres régionaux à l'aide de ce document de référence sur les langues et les paramètres régionaux.
2. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
3. Click sur Edit as JSON.
4. Remplissez la propriété supportedLocales avec une liste de langues pertinentes, séparées par des virgules. Assurez-vous que chaque langue est incluse entre guillemets. Le format devrait ressembler à :
```
"supportedLocales": ["de","es"],
```
Revenez bientôt : S'il s'agit d'un tout nouveau compte ou si vous avez récemment apporté un nombre important de mises à jour à vos entités (ou à votre configuration qui touche de nombreuses entités), les modifications peuvent mettre quelques minutes à apparaître. Relancez la recherche sous peu pour voir si les résultats changent.
1. Consultez le site de confiance Yext pour vérifier s'il y a un incident touchant l'ensemble du système qui pourrait causer un retard.
Vérifiez les jetons qui composent la recherche : Les jetons de la requête auront un impact sur ce qui est recherché, les règles de requête qui sont déclenchées et les synonymes appliqués. Ceci est affiché dans la case des facteurs de recherche sur le côté droit du log de recherche.
1. Si la requête de recherche contient des mots identifiés comme des jetons mais qui entraînent l'apparition de résultats superflus (par exemple, le nom de votre marque), définissez-le comme mot vide supplémentaire :
  1. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
  2. Cliquez sur Paramètres généraux.
  3. Sous Mots vides supplémentaires, entrez le terme souhaité.
2. Si des mots dans la requête de recherche ne sont pas identifiés comme des jetons, ce sont soit des mots vides intégrés (par exemple « ou », « de » ou « dans ») ou un mot vide supplémentaire. Vérifiez la propriété des mots vides supplémentaires en suivant les étapes ci-dessus et supprimez le terme si nécessaire.
3. Si la requête de recherche comportait plusieurs mots (par exemple « facteurs de recherche au niveau de la recherche ») qui ont été pris comme des éléments distincts (par ex. « niveau de la recherche », « recherche » et « facteurs », et qu'ils devraient réellement ne constituer qu'un seul jeton ; configurez une phrase personnalisée.
  1. Cliquez sur Search dans la barre de navigation, puis sur l'expérience souhaitée.
  2. Cliquez sur Paramètres généraux.
  3. Sous Expressions personnalisées, entrez l’expression souhaitée.
Vérifiez les facteurs de recherche trouvés dans le log de recherche pour voir si les facteurs de recherche appropriés ont été appliqués. Dans le cas contraire, suivez ces articles d'aide spécifiques pour explorer plus en profondeur le problème :
- Synonymes : Vérifiez si des synonymes ont été appliqués
- Règles relatives aux requêtes : Vérifiez si des règles de requête appliquées ont entraîné des résultats différents de ceux attendus.
- Classement vertical : Passez en revue les scores verticaux de chaque catégorie pour déterminer pourquoi ils ont été classés dans cet ordre.
- Filtres déduits : Vérifiez si des filtres déduits ont été appliqués à chaque secteur vertical.

Autres articles de dépannage du backend :

Si vous rencontrez toujours un problème après avoir terminé ces étapes, consultez les articles d'aide sur la résolution de problèmes spécifiques pour obtenir des conseils supplémentaires. Si vous rencontrez toujours des problèmes, même après avoir demandé à quelqu'un d'autre de vérifier, contactez les équipes Produit et Ingénierie de Yext en soumettant un ticket.