Attributionstokens

Auf dieser Seite wird beschrieben, wie Sie Attributionstokens verwenden, um die Leistung im Laufe der Zeit zu verbessern.

Attributionstokens sind eindeutige IDs, die von Vertex AI Search für den Einzelhandel generiert und mit jeder Vorhersage- oder Suchanfrage zurückgegeben werden. Damit kann Vertex AI Search für den Einzelhandel Nutzeraktionen und -ergebnisse einander zuordnen und Re-Ranking-Modelle trainieren, um die Qualität der Ergebnisse zu verbessern.

Das Einfügen von Attributionstokens in Ihre Nutzerereignisse ist optional. Wenn Sie keine Attributionstokens angeben, schätzt Vertex AI Search for Retail die Attributionstokens, indem die Ergebnisse in der Vorhersage- oder Suchantwort und den aufgenommenen Nutzerereignissen anhand der Besucher-ID und 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 auf Ihrer Website ein Produkt basierend auf einem Ergebnis von Vertex AI Search für den Einzelhandel angezeigt wird, müssen Sie das Attributionstoken dieses Ergebnisses zurückgeben, wenn der Nutzer mit einem zurückgegebenen Produkt interagiert (z. B. eine Ansicht oder einen add-to-cart-Klick). Mithilfe dieser Feedbackschleife kann Vertex AI Search für den Einzelhandel Informationen dazu 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 im Empfehlungsbereich oder in den Suchergebnissen mit diesem Produkt interagiert (wodurch ein Nutzerereignis generiert wird), kann das Attributionstoken aus dem URL-Link geparst und in das Nutzerereignis eingefügt werden, das Sie für diese Interaktion an Vertex AI Search für den Einzelhandel senden.

Angenommen, Sie fordern eine Vorhersage an, die damit verknüpft ist, einem Nutzer ein Produkt zu zeigen. Vertex AI Search für den Einzelhandel 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 aufgezeichnet wird, um es an Vertex AI Search für den Einzelhandel zu senden. Ein Beispiel für das Nutzerereignisobjekt finden Sie unter Nutzerereignis suchen. Wenn der Nutzer auf eines der Produkte in einem Ergebnis klickt, um eine detailliertere Ansicht aufzurufen, fügen Sie das Attributionstoken in das Nutzerereignis ein, das Sie bei diesem Klick aufzeichnen. Das Nutzerereignis würde in etwa so aussehen:

{
  "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 dem Nutzerereignis für diese Interaktion hinzufügen, verwendet Vertex AI Search für den Einzelhandel 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. Du musst das Attributionstoken für beide Nutzerereignisse angeben, die aus dem Suchergebnis generiert werden (add-to-cart und detail-page-view).

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.