Dépannage du backend de recherche : recherche de localisation – Yext Help

Cet article explique comment résoudre les problèmes liés au backend de recherche concernant les recherches de localisation. La recherche de localisation est réalisée en appliquant un filtre déduit sur builtin.location et renvoie des résultats en fonction de la distance par rapport à l'utilisateur ou au lieu dans la requête de recherche.

Assurez-vous de suivre d'abord l'article Premières étapes de dépannage des problèmes de backend de recherche. Une fois que vous avez résolu votre problème, vous pouvez ignorer les étapes restantes.

Étapes générales de dépannage

Si la recherche de localisation ne semble pas fonctionner, commencez par les étapes ci-dessous. Si une étape résout votre problème, vous n'aurez peut-être pas besoin de suivre les étapes restantes.

Ouvrez le log de recherche correspondant à la requête pour laquelle vous rencontrez des problèmes. Soit :
1. Accédez à Search > [[Experience Name]] > Test Search ou à un sous-onglet de Configuration. Lancez une recherche de test, puis sélectionnez Debug Query dans le menu déroulant.
2. Si vous avez déjà effectué la recherche dans un environnement de développement ou de production, accédez à Search > [[Experience Name]] > Search Logs et cliquez sur le log de recherche pertinent. Utilisez la barre de recherche ou les filtres pour trouver le bon log de recherche ou relancez la recherche pour qu'elle apparaisse en haut.
Vérifiez la détection de la localisation : dans les métadonnées du log de recherche, vérifiez ce qui est détecté comme localisation de l'utilisateur. Si cela est incorrect, assurez-vous d’autoriser la détection de localisation dans votre navigateur, puis exécutez à nouveau la recherche et consultez le nouveau log de recherche. Si cela n’est toujours pas correct, veuillez soumettre un ticket au support.
Vérifiez les filtres déduits : dans le log de recherche, vérifiez si un filtre déduit a été appliqué sur builtin.location pour le secteur concerné.
1. Sinon, vérifiez que le filtre déduit est activé pour le champ en accédant à Recherche > [[Nom de l'expérience]] > Verticals. Cliquez sur l'onglet Filtres. Ajoutez le champ interrogeable, cliquez sur Enregistrer, puis relancez la recherche dans la section Recherche test sur le côté droit.
2. Si vous avez déjà un filtre déduit pour builtin.location, vérifiez s'il existe un conflit de filtre déduit où un seul filtre déduit sera appliqué, par exemple entre la recherche de localisation et un sous-champ de localisation tel que address.region. Vous pouvez définir un ordre de filtre déduit pour départager les champs. Si le conflit est prioritaire par rapport à la recherche de localisation, vous devrez le supprimer si vous souhaitez que la recherche de localisation soit appliquée.
Vérifiez les restrictions par pays : vérifiez que votre configuration inclut les pays pertinents pour la recherche, par défaut seuls les États-Unis sont pris en compte si le paramètre n'est pas défini.
1. Accédez à Search > [[Experience Name]] > General Settings (Paramètres généraux).
2. Vérifiez que le champ des Restrictions par pays inclut tous les pays qui devraient être consultables.
Vérifiez le cadre de délimitation : vérifiez si votre configuration spécifie un cadre de délimitation et si la région interrogeable souhaitée est contenue dans ce cadre. Les cadres de délimitation permettront de limiter la recherches à une zone géographique particulière.
1. Accédez à Recherche > [[Nom de l'expérience]] > Modifier en tant que JSON.
2. Utilisez un outil comme bboxfinder pour cartographier tout cadre de délimitation existant. Veuillez confirmer que cela couvre la région géographique nécessaire.
3. S'il n'existe pas de cadre de délimitation actuellement, vous pouvez en ajouter un si l'entreprise est implantée dans une région, afin d'améliorer la précision des résultats de recherche.
Vérifiez que les résultats existent : vérifiez que le lieu recherché comporte des entités situées dans le rayon de recherche.
1. Accédez à Recherche > [[Nom de l'expérience]] > Modifier en tant que JSON. Vérifiez si un rayon minimal de localisation (minLocationRadius) est défini (ce nombre serait en mètres). Sinon, la valeur par défaut est de 25 miles.
2. Effectuez une recherche verticale générique pour obtenir tous les résultats (par exemple, effectuez une recherche pour le type d'entité) et vérifiez si des entités apparaissent à proximité, en particulier dans le rayon indiqué ci-dessus.
3. Vous pouvez également vérifier les entités sur la plate-forme. Pour cela, accédez au Knowledge Graph > Entités et appliquez un filtre d'État/région ou de pays pour trouver les lieux à proximité.
Vérifiez les remplacements de formation à l'expérience : le filtre déduit souhaité n'apparaîtra pas s'il a été rejeté ou si un autre filtre déduit a été approuvé pour la même requête de recherche.
1. Accédez à Recherche > [[Nom de l'expérience]] > Filtres déduits.
2. Utilisez la barre de recherche pour filtrer les termes de recherche que vous dépannez.
3. Cliquez pour activer le bouton « Afficher terminé ».
4. Vérifiez s'il y a des entrées de filtre déduit pour le secteur pertinent.
  1. Si un filtre déduit de localisation a été rejeté pour la localisation souhaitée, ce filtre déduit ne sera pas appliqué pour cette requête de recherche. Si vous souhaitez qu'il s'applique, annulez le remplacement de la formation à l'expérience achevée.
  2. Si un autre filtre déduit a été approuvé, un filtre déduit de localisation pour l'emplacement souhaité ne sera pas appliqué.
    1. Annulez le filtre incorrect.
    2. Désactivez « Afficher terminé ».
    3. Approuvez le résultat souhaité en cliquant sur la coche verte à côté.
  3. S'il y a plusieurs remplacements actifs, annulez ceux qui ne sont pas souhaités afin qu'il n'y ait qu'un seul remplacement actif.

Je n'arrive pas à trouver des lieux en dehors des États-Unis

Rechercher des lieux ne recherche que les pays listés dans countryRestrictions. Si ce champ n'est pas renseigné, la recherche se limite par défaut aux États-Unis.

Accédez à Search > [[Experience Name]] > General Settings (Paramètres généraux).
Vérifiez que le champ countryRestrictions est rempli avec les pays que vous souhaitez inclure dans la recherche et ajoutez les pays manquants.

Pour plus d'informations, consultez la section countryRestrictions dans la documentation de l'API de configuration des Answers et l'unité des Paramètres verticaux supplémentaires.

Location Search a sélectionné la mauvaise option entre deux lieux portant le même nom

Découvrez comment l'algorithme de recherche de lieux utilise le biais de proximité et la proéminence des lieux pour choisir entre deux lieux portant le même nom dans le document de référence sur les algorithmes de recherche.

La définition d'un cadre de délimitation et de restrictions de pays aidera à améliorer la précision des résultats en limitant la portée de la recherche à une région particulière. Consultez les étapes générales de dépannage ci-dessus pour savoir comment procéder.

J'ai recherché une ville, mais des établissements d'autres villes apparaissent ou apparaissent plus haut

La recherche de lieu fonctionne en trouvant la latitude et la longitude centrales du jeton de recherche, par exemple, une ville, puis en renvoyant les localisations les plus proches de cette latitude et de cette longitude. Si des lieux d’autres villes se trouvent dans le rayon de recherche, ils apparaîtront également. Il peut arriver que les lieux d’une autre ville soient plus proches du centre-ville que ceux de cette ville elle-même, et qu'ils apparaissent donc plus haut dans les résultats. Pour plus de détails sur l’algorithme de recherche de lieu, consultez l’article de référence Algorithmes de recherche.

Si vous souhaitez afficher uniquement les lieux dans le jeton recherché, définissez un filtre déduit pour ce sous-champ d'adresse, tel que address.city, que les filtres déduits traitent comme champ normal :

Cliquez sur Rechercher dans la barre de navigation et cliquez sur l'expérience de recherche. Vous serez redirigé vers la page Secteur d'activité.
Sélectionnez le secteur d'activité auquel vous souhaitez ajouter des champs pouvant faire l'objet d'une recherche.
Dans l'onglet Filtres, trouvez la case des filtres déduits.
Cliquez sur + Ajouter/Mettre à jour les champs.
Dans la barre de recherche, tapez adress. pour afficher les sous-champs d'adresse possibles et sélectionner celui que vous souhaitez utiliser. Cliquez ensuite sur Update Fields (Mettre à jour les champs).
Dans le tableau des champs consultables, activez le filtre déduit pour le champ que vous venez d'ajouter et désactivez-le pour builtin.location si vous le souhaitez.