Stufen für die Suchleistung freischalten

Auf dieser Seite werden Anwendungsfälle für die Suche und ihre jeweiligen Leistungsstufen beschrieben. Außerdem wird beschrieben, wie Sie mit der Search for Retail-Konsole Ihre Datenqualität und die freigeschalteten Leistungsstufen bewerten können. Dort erfahren Sie, wie Sie sich für Benachrichtigungen zur Datenqualität anmelden.

Anwendungsfälle suchen

Die Google Suche liefert Suchergebnisse für zwei Anwendungsfälle:

  • Die Textabfragesuche wird verwendet, wenn Käufer in Ihrer Anwendung nach Artikeln suchen, indem sie Textanfragen eingeben und eine Reihe relevanter Ergebnisse erhalten.
  • Stöbersuche, die verwendet wird, wenn Käufer auf eine bestimmte Kategorieseite gelangen, z. B. die Webseite der Kategorie „Haushaltswaren“ auf der Website eines Baumarkts, auf der sich die sortierten Artikel in dieser Kategorie ansehen können.

Weitere Informationen zu den Unterschieden zwischen diesen Anwendungsfällen finden Sie unter Informationen zur Textsuche und Stöbersuche.

Leistungsstufen

Die Text- und Stöbersuche haben unterschiedliche Leistungsstufen, die Ihre Suchergebnisse zunehmend verbessern. Das Freischalten von Leistungsstufen basiert auf den Nutzerereignis- und Katalogdaten, die Sie in Vertex AI Search für den Einzelhandel hochladen.

Jede Leistungsstufe wird automatisch aktiviert, wenn alle Anforderungen an Daten erfüllt sind, die das Upgrade blockieren. Für das Upgrade auf die nächste Stufe müssen außerdem die Anforderungen aller vorherigen Stufen erfüllt werden.

Für jeden Anwendungsfall sind die folgenden Leistungsstufen verfügbar:

  • Anwendungsfall: Textabfragesuche

    • Relevanz: Ergebnisse werden nur basierend auf der Relevanz für die Suchanfrage zurückgegeben.
    • Relevanz und Beliebtheit: Die Ergebnisse werden auf Grundlage der Relevanz für die Abfrage zurückgegeben. Gleichermaßen relevante Produkte werden nach der Beliebtheit des Produkts auf Ihrer Website
    • Umsatzoptimiert: Das Ranking der relevanten Ergebnisse basiert auf der Wahrscheinlichkeit eines Kaufs des Produkts auf Grundlage der websiteweiten Aktivität.
    • Personalisiert und umsatzoptimiert: Das Ranking relevanter Ergebnisse basiert auf den Präferenzen der einzelnen Nutzer und der Wahrscheinlichkeit, dass das Produkt gekauft wird, basierend auf der websiteweiten Aktivität.

  • Anwendungsfall für die Suche ansehen

    • Beliebtheit: Die Ergebnisse werden nur auf Grundlage der Relevanz für die Kategorie zurückgegeben.
    • Umsatzoptimiert: Das Ranking der relevanten Ergebnisse basiert auf der Wahrscheinlichkeit eines Kaufs des Produkts auf Grundlage der websiteweiten Aktivität.
    • Personalisiert und umsatzoptimiert: Das Ranking relevanter Ergebnisse basiert auf den Präferenzen der einzelnen Nutzer und der Wahrscheinlichkeit, dass das Produkt gekauft wird, basierend auf der websiteweiten Aktivität.

Die Search for Retail-Konsole bietet eine Seite Datenqualität, auf der Sie prüfen können, ob Sie die Datenanforderungen der einzelnen Stufen erfüllt haben.

Datenqualität prüfen

Rufen Sie nach dem Hochladen Ihrer Daten die Search for Retail-Konsole auf, um die Messwerte der Datenprüfung für jede Leistungsstufe für Ihren Anwendungsfall zu sehen.

  1. Rufen Sie in der Search for Retail-Konsole die Seite Datenqualität auf.

    Zur Seite „Datenqualität“

  2. Sehen Sie sich die Messwerte der Datenprüfung für Ihren Suchanwendungsfall an:

    • Für Messwerte zur Textsuche klicken Sie auf den Tab Suche.
    • Um Messwerte für die Suche zu entdecken, klicken Sie auf den Tab Durchsuchen.

  3. Sehen Sie sich oben auf der Seite in der Wertungsliste für die Probleme jeder Leistungsstufe an.

    • Wenn sie mit „In Verwendung“ gekennzeichnet ist: Sie haben alle Probleme mit Blockierungen für diese Stufe erfüllt und sie freigeschaltet.
    • Wenn keine Probleme mit einer Blockierung vorliegen:Sie haben die Datenprüfungen für diese Stufe erfüllt. Wenn es für diese und alle vorherigen Stufen keine blockierenden Probleme gibt, dauert es etwa 24 Stunden, bis das Modell trainiert, vorbereitet und die neu entsperrte Stufe aktiviert wurde.
    • Falls es Probleme gibt, die zu einer Blockierung führen: Prüfen Sie die Messwerte dieser Stufe, um zu ermitteln, welche Datenprobleme behoben werden müssen, um diese Stufe freizuschalten.

  4. In der Tabelle mit den Datenprüfungsmesswerten jeder Leistungsstufe finden Sie eine Liste der Probleme, die Stufenupgrades blockieren oder die Suchleistung beeinträchtigen können.

  5. In der Spalte Status sehen Sie die Prioritätsstufe jedes Messwerts für die Datenprüfung:

    • Upgradeblockierung: Weist auf Datenprobleme hin, die verhindern, dass die Suche Ihren Anwendungsfall auf die nächste Leistungsstufe aktualisiert. Damit eine Stufe entsperrt werden kann, müssen alle Datenprüfungen, die das Upgrade für diese Leistungsstufe (und die vorherigen Stufen) blockieren, bestanden werden.
    • Leistungskritisch: Erkennt Datenprobleme, die ein Upgrade nicht blockieren, aber erhebliche Auswirkungen auf die Textsuche oder die Suchleistung haben können.
    • Konform: Gibt an, dass diese Datenprüfung bestanden wurde.
    • Nicht verfügbar: gibt an, dass eine Datenprüfung ohne Upgrade noch nicht abgeschlossen ist. Werte für diese Messwerte werden als – angezeigt. Nach dem Datenimport kann es bis zu 24 Stunden dauern, bis einige Datenprüfungen berechnet werden.

  6. Wenn Sie weitere Informationen zu einem Messwert aufrufen möchten, klicken Sie auf Details. Daraufhin wird ein Detailbereich mit der Beschreibung, dem Zeitstempel der Datenprüfung und den Schwellenwerten des Messwerts angezeigt.

  7. Suchen Sie in den Schwellenwerten im Bereich Details eines Messwerts nach den Werten, die erforderlich sind, um die Datenprüfung dieses Messwerts zu erfüllen und die Ergebnisse zu verbessern. Nicht alle Grenzwerte gelten für alle Messwerte:

    • Blockierungsschwellenwert: Ein erforderlicher Schwellenwert, der für die Datenprüfung dieses Messwerts erreicht werden muss.
    • Kritischer Grenzwert: Ein sehr empfohlener Schwellenwert. Wenn dieser Grenzwert nicht erreicht wird, kann das erhebliche negative Auswirkungen auf die Leistung haben.
    • Warnungsgrenzwert: Der empfohlene Grenzwert. Wird dieser Grenzwert nicht erreicht, kann sich das negativ auf die Leistung auswirken.

Informationen zum Importieren weiterer Daten zur Behebung von Datenproblemen finden Sie in der öffentlichen Dokumentation unter Nutzerereignisse importieren oder Kataloginformationen importieren.

Best Practices

  • Geben Sie in Suchanfragen und Nutzerereignissen zusätzlich zu den Besucher-IDs auch Nutzer-IDs für angemeldete Nutzer an. Dadurch können die Ergebnisse der Suche für den Nutzer basierend auf den geräteübergreifenden angemeldeten Ereignissen personalisiert werden.
  • Nutzerereignisse in Echtzeit statt in Batch-Uploads mit Verzögerung senden. Dies erleichtert die Personalisierung der Suche anhand der letzten Aktivitäten eines Nutzers auf deiner Website.
  • Laden Sie alle Nutzerereignisse hoch. Reichen Sie beispielsweise nicht nur Ereignisse ein, die Suchvorgängen zugeordnet werden können.

Personalisierung deaktivieren

Wenn Sie die Personalisierung deaktivieren möchten, setzen Sie ServingConfig.personalizationSpec auf mode.DISABLED.

Benachrichtigungen zur Datenqualität

Die Benachrichtigungen zur Datenqualität werden ausgelöst, wenn sich der Wert eines Messwerts im Dashboard von „Zufrieden“ zu „Nicht erfüllt“ ändert. Benachrichtigungen werden per E-Mail gesendet.

Wie Sie Benachrichtigungen für Cloud Monitoring sehen, erfahren Sie unter Benachrichtigungen einrichten.

Datenqualität ansehen

Rufen Sie in der Search for Retail-Konsole die Seite Datenqualität auf.

Zur Seite „Datenqualität“

Eine Zeile entspricht einem Messwert und ein Messwert einer Benachrichtigung.

Benachrichtigungen zur Datenqualität einrichten

REST

Rufen Sie die UpdateAlertConfig API auf.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud-Projekts.
  • EMAIL_ADDRESS_1, EMAIL_ADDRESS_2: Die E-Mail-Adressen, an denen Sie sich für die Benachrichtigungen anmelden möchten. Sie sollten SMTP (Simple Mail Transfer Protocol) konform sein. Einer Benachrichtigungsrichtlinie können maximal 20 E-Mail-Adressen hinzugefügt werden.

Console

  1. Rufen Sie in der Search for Retail-Konsole die Seite Datenqualität auf.

    Zur Seite „Datenqualität“

  2. Klicken Sie oben auf Benachrichtigungen konfigurieren.

  3. Fügen Sie mindestens eine E-Mail-Adresse hinzu. Die E-Mail-Adressen müssen SMTP (Simple Mail Transfer Protocol) entsprechen. Einer Benachrichtigungsrichtlinie können maximal 20 E-Mail-Adressen hinzugefügt werden.

  4. Klicken Sie auf Senden.

Benachrichtigungen zur Datenqualität deaktivieren

REST

Rufen Sie die UpdateAlertConfig API auf.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud-Projekts.

Console

  1. Rufen Sie in der Search for Retail-Konsole die Seite Datenqualität auf.

    Zur Seite „Datenqualität“

  2. Klicken Sie oben auf Benachrichtigungen konfigurieren.

  3. Löschen Sie alle vorhandenen E-Mails.

  4. Klicken Sie auf Senden.

Fehlerbehebung

Im Folgenden finden Sie einige häufige Probleme und deren Behebung:

Eine Datenprüfung ist nicht bestanden

Wenn eine Datenprüfung nicht bestanden wird, klicken Sie auf der Seite Datenqualität auf Details für den Messwert, um eine detailliertere Beschreibung des Messwerts und der Grenzwerte anzuzeigen, die die Datenprüfung erfüllen.

Wenn Sie die Datenanforderungen bereits erfüllt haben, prüfen Sie im Abschnitt Zeitstempel, wann dieser Messwert zuletzt berechnet wurde. Wenn Sie kürzlich eine große Datenmenge neu formatiert oder aufgenommen haben, kann es mehrere Stunden dauern, bis der Messwert neu berechnet wird.

Wenn Sie die Datenanforderungen nicht erfüllt haben, müssen Sie möglicherweise Daten neu formatieren oder mehr Daten erfassen, um die Anforderungen der Datenprüfung zu erfüllen. Wenn Sie sichergestellt haben, dass Ihre Daten die Messwertschwelle erreichen, importieren Sie die neu formatierten Daten noch einmal oder importieren Sie zusätzliche Daten. Warten Sie dann, bis der Messwert neu berechnet wurde.

Für einen Messwert wird „–“ angezeigt.

Messwerte werden als „–“ angezeigt, wenn keine Daten hochgeladen wurden oder die Messwerte noch nicht berechnet wurden. Nach dem Datenimport kann es bis zu 24 Stunden dauern, bis einige Datenprüfungen berechnet werden.

Eine Leistungsstufe weist keine Probleme auf, wird aber nicht verwendet

Gehen Sie zur Fehlerbehebung so vor:

  1. Prüfen Sie, ob Datenprobleme für vorherige Stufen vorliegen. Für das Upgrade auf die nächste Stufe müssen die Anforderungen aller vorherigen Stufen erfüllt sein.

  2. Warten Sie 24 Stunden. Nachdem alle Datenprüfungen, die das Upgrade blockieren, bestanden wurden, dauert es etwa 24 Stunden, um das Modell zu trainieren, vorzubereiten und die neu entsperrte Stufe zu aktivieren.

Wenn die Leistungsstufe innerhalb von zwei Tagen nach Bestehen aller Prüfungen, die das Upgrade blockieren, nicht als aktiv gekennzeichnet wird, wenden Sie sich an den Vertex AI Search-Support für den Einzelhandel. Geben Sie dabei Ihre Projektnummer und Projekt-ID an.

Weitere Informationen zu den Anforderungen an Daten

Weitere Informationen zu den Anforderungen von Vertex AI Search für Einzelhandelsdaten finden Sie in der Dokumentation:

Nächste Schritte