Dies ist die Dokumentation für Recommendations AI, Retail Search und die neue Retail Console. Wenn Sie Retail Search in der eingeschränkten GA-Phase nutzen möchten, wenden Sie sich an den Cloud-Vertrieb.

Wenn Sie Recommendations AI nur verwenden, bleiben Sie in der Recommendations-Konsole und sehen Sie sich die Dokumentation zu Recommendations AI an.

Attributionstokens

Auf dieser Seite wird beschrieben, wie Sie mithilfe von Attributionstokens die Suchleistung im Laufe der Zeit verbessern.

Attributionstokens sind eindeutige IDs, die von Retail generiert und mit jeder Suchanfrage zurückgegeben werden. So kann Retail Nutzeraktionen und Suchergebnisse miteinander verknüpfen und Such-Reranking-Modelle trainieren, um die Suchqualität zu verbessern.

Das Einfügen von Attributionstokens in Ihre Nutzerereignisse ist optional. Wenn Sie keine Attributionstokens angeben, approximiert Retail die Attributionstokens, indem die Ergebnisse in der Suchantwort und den aufgenommenen Nutzerereignissen anhand der Besucher-ID und der Zeitstempel ausgerichtet werden.

Funktionsweise von Attributionstokens

Jede Antwort, die von der Methode predict oder search zurückgegeben wird, enthält einen eindeutigen attributionToken im Antworttext. Beispiel:

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Wenn Ihre Website ein Produkt auf Basis eines Ergebnisses der Retail API anzeigt, müssen Sie das Attributionstoken aus diesem Ergebnis zurückgeben, wenn der Nutzer mit einem zurückgegebenen Produkt interagiert (z. B. Ansicht oder add-to- cart klicken). Anhand dieser Feedbackschleife kann Retail Informationen darüber bereitstellen, wie sich Ihre Ergebnisse auf Ihr Unternehmen auswirken.

Vorgehensweise beim Zurückgeben des Attributionstokens

Geben Sie das Attributionstoken zurück, indem Sie es in das Nutzerereignis aufnehmen, das Sie für jede Aktion erfassen, die der Nutzer mit dem Produkt in einer Empfehlung oder einem Suchergebnis ausführt. Welche Aktionen ein Nutzer mit diesem Produkt ausführen kann, hängt vom Design Ihrer Website ab. Zu den gängigen Aktionen gehören das Hinzufügen eines Produkts zu einer Lieblingsliste, das Anfordern einer Detailansicht, das Hinzufügen zu einem Warenkorb oder der Kauf mit nur einem Mausklick.

Um das Attributionstoken zurückzugeben, müssen Sie es zuerst mit dem Produkt verknüpfen, wie es im Empfehlungsbereich oder in den Suchergebnissen auf Ihrer Website angezeigt wird. Häufig wird dies an alle URLs angehängt, die mit Aktionen verknüpft sind, die im Empfehlungsbereich oder in den Suchergebnissen ausgeführt werden können. Beispiel:

https://www.example.com/54321/?rtoken=abc123

Wenn der Nutzer mit diesem Produkt im Empfehlungsbereich oder in den Suchergebnissen interagiert (was ein Nutzerereignis generiert), kann das Attributionstoken über den URL-Link geparst und in das Nutzerereignis eingefügt werden, das Sie an Retail für diese Interaktion senden.

Angenommen, Sie fordern eine Vorhersage an, die damit verknüpft ist, einem Nutzer ein Produkt zu zeigen. Retail gibt eine Reihe von empfohlenen Katalog-IDs zusammen mit einem zugehörigen Attributionstoken zurück.

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Ihre Website zeigt die empfohlenen Elemente in einem Empfehlungsbereich an und enthält das zurückgegebene Attributionstoken für diese Vorhersage mit jeder URL im Empfehlungsbereich. Ihre Website sollte so konfiguriert sein, dass dieses Ereignis an den Einzelhandel gesendet wird. Ein Beispiel für das Nutzerereignis-Objekt finden Sie unter Nutzerereignisse. Wenn der Nutzer auf eines der Produkte in einem Ergebnis klickt, um eine detailliertere Ansicht aufzurufen, fügen Sie das Attributionstoken dem Nutzerereignis hinzu, das Sie bei diesem Klick aufgezeichnet haben. Das Nutzerereignis sieht in etwa so aus:

{
  "eventType" : "detail-page-view",
  "visitorId": "visitor1",
  "userInfo": {
    "userId": "user1"
   },
   "attributionToken": "abc123",
   "productDetails": [{
     "product": {
        "id": "abc"
       }
     }]
}

Wenn der Nutzer aufgrund einer Empfehlung oder eines Suchergebnisses mit einem Produkt interagiert und Sie das Attributionstoken in das Nutzerereignis für diese Interaktion aufnehmen, verwendet Retail diese Informationen zur Bewertung.

Angenommen, der Nutzer sieht ein Produkt in einem Suchergebnis und verwendet das Ergebnis, um dieses Produkt zu seiner Wunschliste hinzuzufügen und eine detaillierte Ansicht des Produkts abzurufen. Sie müssen das Attributionstoken für beide Nutzerereignisse angeben, die aus dem Suchergebnis (add-to-cart und detail-page-view) generiert wurden.

Angenommen, ein Nutzer fügt dieses Produkt aus der Detailansicht zu seinem Einkaufswagen hinzu. Sie müssen das Attributionstoken nicht für diese Aktion angeben, da es aus der Detailansicht und nicht aus dem Suchergebnis stammt. Wenn dieser Nutzer das Produkt letztendlich kauft, aber nicht direkt über das Suchergebnis, bietet es keinen Vorteil, wenn das Attributionstoken mit dem Kaufereignis zurückgegeben wird.