Dies ist die Dokumentation für Recommendations AI, Retail Search und die neue Retail Console.

Überwachen und Fehler beheben

Auf dieser Seite wird beschrieben, wie Sie Informationen zu Fehlern abrufen, die bei Katalog- und Nutzerereignis-Importen sowie anderen Retail API-Vorgängen aufgetreten sind.

Informationen zum Einrichten von Benachrichtigungen finden Sie unter Benachrichtigungen einrichten.

Einführung

Es ist wichtig, der Retail API genaue Kataloginformationen und Nutzerereignisse bereitzustellen, um qualitativ hochwertige Ergebnisse zu erhalten. Wenn Sie die Fehlerquelle überwachen und verstehen, können Sie Fehler auf Ihrer Website finden und beheben.

Zusammengefasste Integrationsfehler ansehen

Verwenden Sie den Tab Monitoring auf der Seite Monitoring und Analyse, um die von den Datenuploadprozessen und -vorhersagen oder Suchanfragen generierten aggregierten Fehler anzuzeigen.

Auf dieser Seite werden alle Fehler für die Retail API angezeigt. Sie können Fehler im Zusammenhang mit dem Produktkatalog, Nutzerereignissen, Recommendations AI-Vorhersagen, Ergebnissen im Retail Search und Modellen anzeigen. Das System protokolliert außerdem Fehler bei Importen, z. B. eine fehlerhafte Zeile in Ihrer Cloud Storage-Datei. Das System protokolliert bis zu 100 Fehler pro Importdatei. Sie können den Zeitraum definieren, für den Fehler angezeigt werden, und einen Filter basierend auf dem Fehlertyp erstellen.

Sie können auf einen einzelnen Fehler klicken, um die Logs für diesen Fehler in Cloud Logging aufzurufen.

Sie können einzelne Fehlerlogs öffnen, indem Sie das Log maximieren. Fehlerlogs enthalten weitere Details zur Anfrage, einschließlich der Nutzlasten der Anfrage- und Antwort sowie Fehlerdetails. Anhand dieser Informationen können Sie feststellen, wo sich der fehlerhafte Methodenaufruf auf Ihrer Website befindet.

Bei Fehlern durch ungültiges JSON erhalten Sie weitere Informationen zu dem Problem, indem Sie das Feld status erweitern.

Status eines bestimmten Integrationsvorgangs ansehen

Sie können den Status eines bestimmten Integrationsvorgangs im Feld für die Integrationsaktivität sehen:

  1. Rufen Sie in der Google Cloud Console die Seite „Einzelhandelsdaten“ auf.

    Zur Seite „Daten“

  2. Klicken Sie in der Symbolleiste auf Importaktivität ansehen, um den Bereich „Importaktivität“ zu öffnen.

    Sie können Fehler auf bestimmte Integrationsvorgänge prüfen.

  3. Klicken Sie auf Logs ansehen in der Spalte "Detail" eines beliebigen Vorgangs mit einem Fehler zur Prüfung der Log-Dateien in Cloud Logging.

Fehlertypen

  • MISSING_FIELD: Ein erforderlicher Feldwert ist nicht festgelegt. Bei einem Katalogelement fehlt beispielsweise der Titel.
  • INVALID_TIMESTAMP: Der Zeitstempel ist ungültig, z. B. zu weit in der Zukunft oder falsch formatiert.
  • FIELD_VALUE_TOO_SMALL: Der Wert im Feld liegt unter dem erforderlichen Minimum, z. B. ein negativer Preis.
  • INCORRECT_JSON_FORMAT: Die JSON-Datei in der Anfrage ist falsch formatiert, z. B. eine fehlende Klammer {.
  • INVALID_LANGUAGE_CODE: Der Sprachcode ist falsch formatiert.
  • FIELD_VALUE_EXCEEDED: Der Wert in dem Feld liegt über dem zulässigen Maximum.
  • INVALID_RESOURCE_ID: Die Ressourcen-ID ist ungültig. Beispielsweise ein nicht vorhandenes catalog_id im Ressourcennamen.
  • FIELD_SIZE_EXCEEDED: Die Anzahl der Einträge im Feld überschreitet das maximale Limit.
  • UNEXPECTED_FIELD: In einem Feld, das leer sein sollte, ist ein Wert vorhanden, z. B. eine Transaktion zum Aufrufen einer Detailseite.
  • INVALID_FORMAT: Das Feld ist nicht richtig formatiert, z. B. ein ungültiger String.
  • RESOURCE_ALREADY_EXISTS: Sie haben versucht, eine bereits vorhandene Ressource zu erstellen, z. B. ein zuvor erstelltes Katalogelement.
  • INVALID_API_KEY: Der API-Schlüssel stimmt nicht mit dem Projekt in Ihrer Anfrage überein.
  • INSUFFICIENT_PERMISSIONS: Sie sind nicht berechtigt, die Anfrage auszuführen. Dieser Fehler ist in der Regel auf das Fehlen einer erforderlichen IAM-Berechtigung zurückzuführen.
  • UNJOINED_WITH_CATALOG: Die Anfrage enthält eine ID für den Katalogelement, die nicht im Katalog vorhanden ist. Der Katalog muss auf dem neuesten Stand sein.
  • BATCH_ERROR: Die Anfrage enthält mehrere Fehler, zum Beispiel einen Inline-Import mit 10 Elementen, bei denen die Validierung aus verschiedenen Gründen fehlgeschlagen ist.
  • INACTIVE_RECOMMENDATION_MODEL: Sie haben ein Modell abgefragt, das nicht bereitgestellt werden kann.
  • ABUSIVE_ENTITY: Die mit der Anfrage verknüpfte Besucher-ID oder Nutzer-ID hat in kurzer Zeit eine ungewöhnliche Anzahl von Ereignissen gesendet.
  • FILTER_TOO_STRICT: Der Filter für Vorhersageanfragen blockiert alle Vorhersageergebnisse. Allgemein beliebte Artikel (nicht personalisiert) werden zurückgegeben, es sei denn, der Aufruf hat strictFiltering als "false" angegeben. In diesem Fall werden keine Artikel zurückgegeben. Einige häufige Gründe für dieses Problem:

    • Sie geben ein Filter-Tag an, das in Ihrem Katalog nicht vorhanden ist. Es kann bis zu einem Tag dauern, bis eine Aktualisierung des Filter-Tags wirksam wird.
    • Ihr Filter ist zu klein.

Logs direkt ansehen

Sie können Ihre Logdateien auch direkt in Logging öffnen. Mit diesem Link werden beispielsweise Logs für alle Retail-Fehler in der letzten Stunde geöffnet: Retail-Logs öffnen

Messwerte zum Datenaufbau ansehen

Sobald das Datenuploadssystem erfolgreich ausgeführt wurde, können Sie auch die Tabs Katalog und Ereignis auf der Seite Einzelhandelsdaten verwenden, um Fehlermesswerte für Ihre Datenaufnahme aufrufen und sicherzustellen, dass alles reibungslos funktioniert.

Sie können auch Benachrichtigungen hinzufügen, um informiert zu werden, wenn etwas mit Ihrem Daten-Uploadsystem passiert.

Katalogdaten – Zusammenfassung

Über den Tab Katalog auf der Seite Daten können Sie allgemeine Datenstatistiken für jeden Katalogzweig aufrufen. Auf dieser Seite wird angezeigt, wie viele Produkte Sie importiert haben, wie viele auf Lager sind und wann Sie zuletzt Produkte für jeden Produktkatalogzweig importiert haben.

Sie können auch eine Vorschau der hochgeladenen Katalogelemente anzeigen und nach Produktfeldern filtern.

Sie können Daten in verschiedene Branches importieren, um Recommendations AI- oder Retail Search-Ergebnisse bereitzustellen und in der Vorschau anzuzeigen. Wenn Sie sich beispielsweise auf eine Feiertagsvorbereitung vorbereiten möchten, können Sie neue Katalogdaten in einen nicht standardmäßigen Branch hochladen und dafür sorgen, dass die Einzelhandelsergebnisse korrekt generiert werden, bevor Sie sie auf Ihrer Website veröffentlichen.

Statistiken zur Nutzerereignisaufnahme

Für jede Art von Nutzerereignis sehen Sie auf dem Tab Ereignis, wie viele davon Sie aufgezeichnet haben, wie viele davon nicht mit einem Produkt verknüpft wurden (nicht verknüpfte Ereignisse) und wie sich die Zahlen von denen vorheriger Zeiträume unterscheiden. Sie können einen voreingestellten Zeitraum auswählen oder einen benutzerdefinierten Zeitraum eingeben.

Im Messwertdiagramm werden die im Zeitverlauf aufgenommenen Nutzerereignisse angezeigt, die Sie nach Nutzerereignistyp filtern können.

Datenqualitätsmesswerte

Klicken Sie auf der Seite Daten auf Datenqualität anzeigen, um das Feld Datenqualität zu öffnen.

Messwerte zur Datenqualität zeigen den Prozentsatz der Produkte und Nutzerereignisse, die den empfohlenen Datenqualitätsstandards entsprechen.

Für die Verwendung der Retail API ist zwar keine Verbesserung der Datenqualität gemäß diesen Messwerten erforderlich, es wird aber dringend empfohlen, um eine bessere Qualität und Suchergebnisse zu erhalten.

Qualität der Katalogdaten

Der Tab Katalog auf der Seite Daten zeigt den Prozentsatz der Produkte in Ihrem Katalog, die den Messwerten für die Katalogqualität für die Einzelhandelssuche entsprechen.

Eine Liste aller Messwerte zur Qualität von Katalogdaten finden Sie unter Datenmesswerte für die Katalogdaten.

Qualität der Ereignisdaten

Auf dem Tab Ereignis auf der Seite Daten sehen Sie, wie viele Ihrer Nutzerereignisse den Best Practices für Datenqualität sowohl in der Empfehlungs-KI als auch in der Einzelhandelssuche entsprechen.

Der Tab Datenqualität umfasst zwei Bereiche:

  • General Retail API-Messwerte: Der erste Abschnitt dieses Tabs enthält Messwerte, die sowohl für Recommendations AI als auch für Retail Search gelten. Wenn du die Vorschläge für diese Messwerte befolgst, kannst du die Empfehlungen und Suchergebnisse verbessern.

    Du kannst die Messwerte in diesem Abschnitt nach dem Zeitraum der bewerteten Nutzerereignisse filtern.

  • Suchmesswerte: Die Messwerte in diesem Abschnitt gelten nur für den Einzelhandel. Wenn du die Vorschläge für diese Messwerte befolgst, kannst du die Suchergebnisse verbessern.

    Diese Messwerte können nicht nach Zeitraum gefiltert werden.

    Der Messwert Suchereignisse wird nahezu in Echtzeit aktualisiert. Der Messwert Ereignisse mit Filtern wird erstmalig zwischen 4 und 24 Stunden nach dem ersten Hochladen von Suchereignissen aktualisiert. Sie wird etwa alle vier Stunden aktualisiert.

    Andere Messwerte in diesem Bereich werden erst angezeigt, wenn der Messwert Ereignisse suchen 100 % erreicht hat. Nachdem die Suchereignisse erfüllt sind, werden diese Messwerte etwa 24 Stunden später angezeigt. Sie werden dann einmal täglich aktualisiert.

    Die einzelnen aufgerufenen Produkte und die durchschnittliche Anzahl der Klicks pro Produkt sind Messwerte. Wenn diese Messwerte niedrige Prozentsätze haben, können Sie den anderen Messwert verbessern, indem Sie mehr Daten zu Suchereignissen importieren.

Alle Anforderungen und Empfehlungen für Nutzerereignisse für Recommendations AI und Retail Search finden Sie unter Anforderungen und Best Practices für Nutzerereignisse.

Nicht verknüpfte Ereignisse

Wenn sich ein Nutzerereignis oder eine API-Anfrage auf ein Produkt bezieht, das nicht in Retail hochgeladen wurde, ist es ein nicht verknüpftes Ereignis. Nicht verknüpfte Nutzerereignisse werden weiterhin protokolliert und nicht verknüpfte Anfragen werden verarbeitet. Beide können jedoch nicht verwendet werden, um das Modell für zukünftige Vorhersagen zu optimieren. Aus diesem Grund sollten Sie gewährleisten, dass der Prozentsatz der nicht geloggten Ereignisse sowohl für Nutzerereignisse als auch für Vorhersageanfragen sehr niedrig ist.

Sie können den Prozentsatz der nicht verbundenen Nutzerereignisse auf dem Tab Ereignis auf der Seite Daten einsehen.

API-Fehler

Sie können ein Diagramm der API-Fehler im Zeitverlauf ansehen, das nach Methodenname angezeigt wird, indem Sie aufAPI-Messwerte ansehen in der Schaltflächenleiste desMonitoring und Analyse klicken.

API-Methodenaktivität überwachen

Öffnen Sie zum Visualisieren von Traffic, Fehlern und Latenz nach API-Methode den Tab Monitoring auf der Seite Monitoring und Analyse. Sie können einen voreingestellten Zeitraum auswählen oder einen benutzerdefinierten Zeitraum eingeben.

So rufen Sie weitere Details zu den einzelnen Grafiken auf:

  • Klicken Sie unter einem Diagramm auf einen Methodennamen, um ihn im Diagramm zu isolieren.
  • Bewegen Sie den Mauszeiger über eine Grafik, um ein Callout mit jeder Methode und ihren Werten zu diesem Zeitpunkt anzuzeigen.
  • Klicken Sie auf einen beliebigen Abschnitt des Diagramms und ziehen Sie ihn, um den Zeitraum zu heranzoomen.

Weitere Informationen