Attributionstokens

Attributionstokens sind eindeutige IDs, die von AI Commerce Search generiert und mit jeder Suchanfrage zurückgegeben werden. So kann AI Commerce Search eine Suchanfrage mit dem entsprechenden Suchereignis verknüpfen, wodurch Reranking-Modelle die Qualität der Suchantworten verbessern können. Attributionstokens sind auch in AI Commerce Search-Suchereignissen für eine genaue Berichterstellung erforderlich.

Funktionsweise von Attributionstokens

Sie rufen das attributionToken aus der API-Antwort einer Nutzersuche ab. Für jede Suche gibt es ein neues Attributionstoken. Attributionstokens werden nicht wiederholt.

Wenn AI Commerce Search eine Such- oder Empfehlungsanfrage verarbeitet, wird in der Antwort ein eindeutiges attributionToken zurückgegeben.

Eine placements.search-Antwort sollte in einem Such- oder Browserereignis und sofort gesendet werden, wenn ein Nutzer mit einem Produkt interagiert. Dazu gehören folgende Nutzeraktionen:

  • search (JA) → add-to-cart (JA)
  • search (JA) → detail-page-view (JA)
  • search (JA) → purchase (NEIN) (Der Nutzer interagiert zum Zeitpunkt des Kaufs nicht direkt mit einem Produkt wie bei einem Klick oder add-to-cart. Der Kauf wird jedoch weiterhin der ursprünglichen Suche zugeordnet.)

Verhalten von Attributionstokens

Attributionstokens sind:

  • Besucherspezifisch: Das attributionToken ist mit einer bestimmten Suchantwort verknüpft, die für eine bestimmte `visitorId` bereitgestellt wird. Nur das Suchereignis selbst muss mit dem Token getaggt werden. Alle nachfolgenden Ereignisse, die keine Suchereignisse sind, dürfen nicht mit einem Token getaggt werden.

  • Mit Ereignissen verknüpft, die direkt auf die Suche folgen: Das attributionToken ist besonders wichtig für Nutzerereignisse, die eine direkte Interaktion mit den Suchergebnissen dieser bestimmten Suche darstellen. Dazu gehören Ereignisse vom Typ „Kauf abgeschlossen“: Der Kauf ist weiterhin über die Produkt-IDs und visitorId verknüpft.

    Hinweis: Wenn ein einzelner Nutzer mehrere Suchanfragen ausführt, wird für jede neue Suchanfrage ein Attributionstoken generiert und das nachfolgende Suchereignis sollte dieses neue Token enthalten. Ein Attributionstoken aus einem vorherigen Suchereignis wird nicht für ein nachfolgendes Suchereignis wiederverwendet, da jede Suche ein neues Token initiiert.

Attributionstokens in der Search API

Jede Antwort, die von der AI Commerce Search-Methode zurückgegeben wird, enthält am Ende des Antworttexts ein eindeutiges attributionToken. Beispiel:

{
  "results": [
    {
      "id": "727121",
      "product": {
…
     }
  ],
  "totalSize": 19600,
  "attributionToken": "dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB",
  "nextPageToken": "AM1MDZiNWOyQjM4UTLlNGN50iMwYjMtADMwATLwIGMhBzY2YDJaIw-bCbxQYAt1PJgIwgExEgC"
…

Dieses Token muss im nachfolgenden Suchereignis enthalten sein:

{
"eventType": "search",
"searchQuery":"red t-shirt", 
"productDetails":[
  {"product":{"id":"727121"}}, {"product":{"id":  …
  }
] ,
"visitorId":"GA1.1.1383176924.1721324981",
"attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB"
}

AI Commerce Search verwendet die Ereignisdaten, um seine Modelle zu trainieren. Das Attributionstoken bietet eine Möglichkeit, das Ereignis mit der Anfrage zu verknüpfen, indem die vollständige Suchanfrage und -antwort mit den angeforderten Filtern, Facets und Produkt-IDs der Antwort codiert wird. Wenn in den Suchereignissen kein Token vorhanden ist, werden diese Ereignisse so behandelt, als stammten sie nicht von Google AI Commerce Search. Die Suchereignisse werden möglicherweise fälschlicherweise so verwendet, als stammten sie von einem anderen Suchanbieter.

Es ist in Ordnung (und erwartet), dass Suchereignisse ohne Tokens vorhanden sind, wenn sie von einem anderen Suchanbieter bereitgestellt werden, z. B. während eines A/B-Tests. In der Regel gibt es jedoch eine 1:1-Zuordnung für Search API-Anfragen zu Such-Ereignissen mit Tokens.

Negative Auswirkungen fehlender Tokens

Wenn das attributionToken nicht in den relevanten nachfolgenden Nutzerereignissen desselben Besuchers enthalten ist, behandelt AI Commerce Search diese Ereignisse so, als stammten sie nicht von seinem Suchdienst.

Dies kann zu Folgendem führen:

  • Ungenaue Modellschulung
  • Falsche Messwerte und Leistungsanalysen
  • Mögliche Probleme beim Erreichen höherer Leistungsstufen (z. B. Stufe 3), für die ausreichend zuordenbare Ereignisse erforderlich sind
  • Fehler im Dashboard „Datenqualität“ in AI Commerce Search in Gemini Enterprise for Customer Experience, wenn der Prozentsatz der Ereignisse mit Attributionstokens weniger als 95 % beträgt

Um aus dem Nutzerverhalten zu lernen und die Suchergebnisse zu optimieren, benötigt AI Commerce Search nur eine genaue Zuordnung für das erste Suchereignis.

Datenqualität von Attributionstokens

Im Dashboard „Datenqualität“ in der AI Commerce Search in Gemini Enterprise for Customer Experience-Konsole wird der Status „Kritischer Fehler“ oder „Blockierender Fehler“ angezeigt, wenn der Prozentsatz der Ereignisse mit Attributionstokens unter 95 % liegt. Andernfalls wird der Status „Konform“ angezeigt:

Alt-Text

Die Datenqualität auf Stufe 3, dem umsatzoptimierten Modell, kann in der Regel nicht ohne ausreichend zuordenbare Ereignisse trainiert werden. Es wird dringend davon abgeraten, AI Commerce Search in der Produktion bereitzustellen, es sei denn, es werden Ergebnisse auf Stufe 3 oder 4 bereitgestellt. Weitere Informationen finden Sie im Abschnitt Datenqualität. Informationen zum Freischalten von Leistungsstufen finden Sie auf der Seite Datenqualität in dieser Dokumentation.

Attributionstokens für Empfehlungen

Empfehlungen von AI Commerce Search erstellen automatisch synthetische Tokens für Ereignisse, die predict-Anfragen zugeordnet werden können.

Wenn ein Nutzer bei Empfehlungsvorhersagen auf ein empfohlenes Produkt klickt, sollte das PredictResponse.attribution_token als URL-Parameter an die Produktseite übergeben und dann im Ereignis detail-page-view protokolliert werden.

Protokollieren Sie angezeigte Empfehlungen als Teil von panelInfo und legen Sie Folgendes fest:

panelInfo.attributionToken=PredictResponse.attributionToken