Attributionstokens

Attributions-Tokens sind eindeutige IDs, die von AI Commerce Search generiert und mit jeder Suchanfrage zurückgegeben werden. Sie ermöglichen es AI Commerce Search, eine Suchanfrage mit dem entsprechenden Suchvorgang zu verknüpfen. So können Modelle für das erneute Ranking die Qualität der Suchantworten verbessern. Für eine genaue Berichterstellung sind Attributions-Tokens auch in AI Commerce Search-Suchereignissen erforderlich.

Hinweis :Attributionstokens sind nur für AI Commerce Search erforderlich. Sie werden nicht an alle Nutzerereignisse übergeben. Sie werden auch nicht in der URL übergeben.

Funktionsweise von Attributionstokens

Sie erfassen die attributionToken aus der API-Antwort auf die Suche eines Nutzers. Für jede Suche gibt es ein neues Attributionstoken. Attributionstokens werden nicht wiederholt.

Wichtig :Attributionstokens sind für Ereignisse für Suchimpressionen erforderlich, dürfen aber nicht für andere Ereignisse wie Klicks, „In den Warenkorb“ und Käufe gesendet werden.

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

Eine placements.search-Antwort sollte in einem Such- oder Browser-Nutzerereignis und sofort gesendet werden, wenn ein Nutzer mit einem Produkt interagiert. Dazu gehören User Journeys wie:

• 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

Attributions-Tokens sind:

• Besucherspezifisch: Die attributionToken ist mit einer bestimmten Suchantwort verknüpft, die für einen bestimmten visitorId bereitgestellt wird. Nur das Suchereignis selbst muss mit dem Token getaggt werden. Alle nachfolgenden Ereignisse, die keine Suchvorgänge sind, dürfen nicht mit einem Token getaggt werden.

• Mit Ereignissen verknüpft, die direkt auf die Suche folgen: Der attributionToken ist besonders wichtig für Nutzerereignisse, die eine direkte Interaktion mit den Suchergebnissen dieser bestimmten Suche darstellen. Dazu gehören purchase-complete-Ereignisse: Der Kauf wird 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 Attributions-Token generiert. Das nachfolgende Suchereignis sollte dieses neue Token enthalten. Ein Attributionstoken aus einem vorherigen Suchvorgang wird nicht für einen nachfolgenden Suchvorgang wiederverwendet, da bei jeder Suche ein neues Token generiert wird.

Attributionstokens in der Search API

Jede Antwort, die von der AI Commerce Search-Methode zurückgegeben wird, enthält am Ende des Antworttexts eine eindeutige 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. Mit dem Attributions-Token kann das Ereignis mit der Anfrage verknüpft werden. Dazu werden die vollständige Suchanfrage und die Antwort mit den angeforderten Filtern, Facets und Produkt-IDs der Antwort codiert. Wenn in den Suchvorgängen kein Token vorhanden ist, werden sie so behandelt, als wären sie nicht von Google AI Commerce Search. Die Suchvorgänge werden dann möglicherweise fälschlicherweise so verwendet, als wären sie von einem anderen Suchanbieter.

Es ist in Ordnung (und zu erwarten), 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 von Search API-Anfragen zu Such-Ereignissen mit Tokens.

Negative Auswirkungen fehlender Tokens

Wenn die attributionToken nicht in den relevanten nachfolgenden Nutzerereignissen desselben Besuchers enthalten ist, behandelt AI Commerce Search diese Ereignisse so, als wären sie nicht von seinem Suchdienst ausgegangen.

Das kann zu Folgendem führen:

• Das Modelltraining ist ungenau.
• Falsche Messwerte und Leistungsanalysen.
• Mögliche Probleme beim Erreichen höherer Leistungsstufen (z. B. Stufe 3), für die genügend zuordenbare Ereignisse erforderlich sind.
• Fehler, die im Dashboard zur Datenqualität in AI Commerce Search in Gemini Enterprise for Customer Experience gemeldet werden, wenn der Prozentsatz der Ereignisse mit Attributions-Tokens unter 95 % liegt.

Damit AI Commerce Search aus dem Nutzerverhalten lernen und Suchergebnisse optimieren kann, ist eine genaue Zuordnung nur für das ursprüngliche Suchereignis erforderlich.

Datenqualität von Attributions-Tokens

Im Dashboard zur Datenqualität in der Gemini Enterprise for Customer Experience-Konsole für AI Commerce Search wird im Status ein kritischer oder blockierender Fehler wegen Nichteinhaltung angezeigt, wenn der Prozentsatz der Ereignisse mit Attributions-Tokens unter 95 % liegt. Andernfalls wird der Status als „Konform“ angezeigt:

Die Datenqualität auf Stufe 3, dem umsatzoptimierten Modell, kann in der Regel nicht ohne eine ausreichende Anzahl von zuordenbaren Ereignissen trainiert werden. Es wird dringend davon abgeraten, AI Commerce Search in der Produktion bereitzustellen, wenn damit keine Ergebnisse in Tier 3 oder Tier 4 erzielt werden. Weitere Informationen finden Sie im Abschnitt „Datenqualität“ auf der Seite Datenqualität in dieser Dokumentation. Dort wird beschrieben, wie Sie Leistungsstufen freischalten.

Attributionstokens für Empfehlungen

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

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

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

panelInfo.attributionToken=PredictResponse.attributionToken