Fehlerbehebung bei Ihrem Search Backend – Yext Help

Wenn Sie Probleme mit der Qualität Ihrer Suchergebnisse feststellen, d. h. der Algorithmus liefert andere Ergebnisse als erwartet, liegt ein Problem im Backend vor.

Nachfolgend finden Sie die empfohlenen Schritte, um Ihr Backend-Problem zu debuggen. Konfigurationsänderungen sollten sofort angewendet werden, daher führen Sie beim Speichern der Änderungen erneut searches durch, um zu sehen, ob Ihr Problem behoben ist. Sobald Sie Ihr Problem gelöst haben, können Sie die restlichen Schritte überspringen. Sollten Sie nach Abschluss dieser Schritte weiterhin ein Problem feststellen, lesen Sie die Hilfeartikel zur Fehlerbehebung bei spezifischen Problemen für weitere Anleitungen.

Einen allgemeinen Ansatz zum Debuggen des Backends finden Sie in der Schulung Debugging the Backend auf Hitchhikers. Wir verwenden auf diesen Pages die in diesem Dokument besprochenen Konzepte.

Öffnen Sie das Suchprotokoll für die Abfrage, bei der Sie Probleme feststellen. Hierfür gibt es zwei Methoden:
1. Navigieren Sie direkt zur Ansicht „Suchprotokolle“
  1. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
  2. Klicken Sie auf Protokolle durchsuchen.
  3. Klicken Sie auf das gewünschte Suchprotokoll. Sie können bei Bedarf auch die Suchleiste verwenden.
2. Führen Sie eine Testsuche durch und öffnen Sie von dort aus das Suchprotokoll
  1. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
  2. Klicken Sie auf Testsuche , um auf die Vollbild-Testsuche zuzugreifen, oder auf einen der Konfigurationsbildschirme in der Navigationsleiste, um auf die Seitenleisten-Testsuche zuzugreifen.
  3. Eine Testsuche durchführen.
  4. Klicken Sie auf Debug-Anfrage.
Prüfen Sie die API-Anfrage: Klicken Sie auf die Dropdown-Schaltfläche und dann auf Code anzeigen im Dropdown-Menü.
1. Falls ein BACKEND_ERROR auftritt, weist dies auf ein zugrunde liegendes Problem hin. Bitte reichen Sie ein Support-Ticket zur Prüfung durch unser Engineering-Team ein.
Überprüfen Sie Ihre Konfigurationsversionen und Labels: Dies wird in den Metadaten oben im Suchprotokoll angezeigt. Stellen Sie sicher, dass Sie die richtige Version und das richtige Label (Staging oder Produktion) verwenden. Häufig werden unerwartete Ergebnisse dadurch verursacht, dass auf eine veraltete Konfigurationsversion hingewiesen wird.
1. Wenn Sie das falsche Label verwenden, führen Sie die Suche im richtigen Deploy-Link erneut aus oder korrigieren Sie das Label in der Test-Search.
2. Falls Sie diese Versionen aktualisieren müssen oder überprüfen möchten, welche Versionen verfügbar sind:
  1. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
  2. Klicken Sie auf Revisionsverlauf.
  3. Klicken Sie auf das Dropdown-Menü für das relevante Label, um die verfügbaren Versionen zu sehen, und wählen Sie diejenige aus, die Sie festlegen möchten.
  4. Jede Version im Dropdown-Menü zeigt das Datum und die Uhrzeit an, zu der sie gespeichert wurde. Wenn Sie weitere Informationen wünschen, navigieren Sie zum Bildschirm Revisionsverlauf, um zu sehen, von wem die Version aktualisiert wurde, und um die Konfiguration herunterzuladen.
Prüfen Sie Ihr Gebietsschema: Das Gebietsschema Ihrer Search-Erfahrung muss mit den Gebietsschemata der Entitäten übereinstimmen, die Sie zurückgeben möchten. Wenn Ihre Entitätsprofile das Gebietsschema „Englisch“ (en) verwenden, muss das angeforderte Gebietsschema exakt „en“ sein. Anfragen für andere ähnliche Gebietsschemas wie „en_GB“ oder „en_US“ geben nur Profile mit genau diesem Gebietsschema zurück.
1. Überprüfen Sie das Gebietsschema der Entitätsprofile.
  1. Falls Ihr Konto nur eine Sprache verwendet, navigieren Sie zu Kontoeinstellungen und klicken Sie auf Persönliche Einstellungen. Überprüfen Sie, was in der Hauptsprache des Kontos ausgefüllt ist.
  2. Wenn Ihr Konto mehrere Sprachen verwendet, kann jede Entität ein anderes Gebietsschema haben. Sie können die Sprache bei einzelnen Entitäten überprüfen oder Entitäten exportieren und das Feld „Profilsprache“ einfügen.
  3. Überprüfen Sie die Sprachen im Vergleich zu den Gebietsschemata mit diesem Referenzdokument für Sprachen und Gebietsschemata.
2. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
3. Klicken Sie auf Als JSON bearbeiten.
4. Füllen Sie die Eigenschaft supportedLocales mit einer durch Kommas getrennten Liste der relevanten Gebietsschemata. Stellen Sie sicher, dass jedes Gebietsschema in Anführungszeichen steht. Das Format sollte folgendermaßen aussehen:
```
"supportedLocales": ["de","es"],
```
Schauen Sie in Kürze wieder vorbei: Falls es sich um ein brandneues Konto handelt oder Sie kürzlich eine erhebliche Anzahl von Aktualisierungen an Ihren Entitäten vorgenommen haben (oder an Ihrer Konfiguration, die viele Entitäten betrifft), kann es einige Minuten dauern, bis die Änderungen sichtbar werden. Führen Sie die Search in Kürze erneut durch, um zu sehen, ob sich die Ergebnisse ändern.
1. Überprüfen Sie die Yext Trust-Website, um festzustellen, ob ein systemweiter Vorfall vorliegt, der möglicherweise eine Verzögerung verursacht.
Überprüfen Sie die Token, aus denen die Suche besteht: Die Token der Abfrage beeinflussen, wonach gesucht wird, welche Abfrageregeln ausgelöst werden und welche Synonyme angewendet werden. Dies wird im Suchfaktorenfeld auf der rechten Seite des Suchprotokolls angezeigt.
1. Wenn die Search Wörter enthält, die als Token identifiziert werden, aber dazu führen, dass irrelevante Ergebnisse angezeigt werden (z. B. Ihr Markenname), setzen Sie ihn als zusätzliches Stoppwort:
  1. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
  2. Klicken Sie auf Allgemeine Einstellungen.
  3. Geben Sie unter Zusätzliche Stoppwörter den gewünschten Begriff ein.
2. Wenn es Wörter in der Search-Anfrage gibt, die nicht als Token identifiziert werden, handelt es sich entweder um ein eingebautes Stoppwort (z. B. „oder“, „von“ oder „in“) oder ein zusätzliches Stoppwort. Überprüfen Sie die Eigenschaft der zusätzlichen Stoppwörter gemäß den oben genannten Schritten und entfernen Sie den Begriff bei Bedarf.
3. Wenn die Suchanfrage aus mehreren Wörtern bestand (z. B. „Entitätsebenen-Suchfaktoren“), die jeweils als separates Token betrachtet wurden (z. B. „Entitätsebene“, „Suche“ und „Faktoren“), aber eigentlich ein einzelnes Token sein sollten, richten Sie eine benutzerdefinierte Phrase ein.
  1. Klicken Sie in der Navigationsleiste auf Search und dann auf das gewünschte Search-Erlebnis.
  2. Klicken Sie auf Allgemeine Einstellungen.
  3. Geben Sie unter Benutzerdefinierte Phrasen die gewünschte Phrase ein.
Überprüfen Sie die im Suchprotokoll gefundenen Suchfaktoren, um zu überprüfen, ob die entsprechenden Suchfaktoren angewendet wurden. Wenn nicht, folgen Sie diesen speziellen Hilfeartikeln, um das Problem eingehender zu untersuchen:
- Synonyme: Überprüfen Sie, ob Synonyme angewendet wurden
- Anfrage-Regeln: Überprüfen Sie, ob angewendete Anfrage-Regeln dazu geführt haben, dass die Ergebnisse anders als erwartet ausgefallen sind.
- Vertikale Rangfolge: Überprüfen Sie die Punktzahlen jeder Branche, um zu verstehen, warum sie in dieser Reihenfolge eingestuft wurden.
- Abgeleitete Filter: Überprüfen Sie, ob abgeleitete Filter auf jede Sparte angewendet wurden.

Weitere Artikel zur Fehlerbehebung beim Search-Backend:

Sollte das Problem nach Abschluss dieser Schritte weiterhin bestehen, konsultieren Sie die Hilfeartikel zur Fehlerbehebung bei spezifischen Problemen für weitere Anleitungen. Wenn Sie weiterhin Probleme feststellen, auch nachdem Sie eine weitere Person zur Überprüfung hinzugezogen haben, wenden Sie sich bitte an das Produkt- und Entwicklungsteam von Yext, indem Sie ein Ticket einreichen.