Token di attribuzione

I token di attribuzione sono ID univoci generati da AI Commerce Search e restituiti con ogni richiesta di ricerca. Consentono ad AI Commerce Search di associare una richiesta di ricerca all'evento di ricerca corrispondente, il che permette ai modelli di riposizionamento di migliorare la qualità delle risposte di ricerca. Per report accurati, sono necessari anche token di attribuzione negli eventi di ricerca AI Commerce Search.

Come funzionano i token di attribuzione

Raccogli attributionToken dalla risposta dell'API di una ricerca dell'utente. Per ogni ricerca è presente un nuovo token di attribuzione; i token di attribuzione non vengono ripetuti.

Quando AI Commerce Search gestisce una richiesta di ricerca o di suggerimento, restituisce un attributionToken univoco nella risposta.

Una risposta placements.search deve essere inviata in un evento utente di ricerca o navigazione e immediatamente nel caso in cui un utente interagisca con un prodotto. Sono inclusi percorsi dell'utente come:

  • search (SÌ) → add-to-cart (SÌ)
  • search (SÌ) → detail-page-view (SÌ)
  • search (SÌ) → purchase (NO) (L'utente non interagisce direttamente con un prodotto al momento dell'acquisto nello stesso modo in cui interagisce con un clic o un add-to-cart, anche se l'acquisto viene comunque attribuito alla ricerca originale).

Comportamento del token di attribuzione

I token di attribuzione:

  • Specifico per i visitatori: il attributionToken è associato a una specifica risposta di ricerca fornita a un determinato visitorId. Solo l'evento di ricerca stesso deve essere taggato con il token. Tutti gli eventi successivi non di ricerca non devono essere taggati con un token.

  • Associato a eventi che seguono direttamente la ricerca: attributionToken è particolarmente importante per gli eventi utente che rappresentano un'interazione diretta con i risultati di ricerca di quella specifica ricerca. Sono inclusi gli eventi di completamento dell'acquisto: l'acquisto è ancora collegato tramite gli ID prodotto e visitorId.

    Nota: se un singolo utente esegue più ricerche, ogni nuova richiesta di ricerca genera un token di attribuzione e l'evento di ricerca successivo deve includere questo nuovo token. Un token di attribuzione di un evento di ricerca precedente non viene riutilizzato per un evento di ricerca successivo, perché ogni ricerca avvia un nuovo token.

Token di attribuzione nell'API Search

Ogni risposta restituita dal metodo AI Commerce Search include un attributionToken univoco alla fine del corpo della risposta di ricerca. Ad esempio:

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

Questo token deve essere incluso nell'evento di ricerca successivo:

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

AI Commerce Search utilizza i dati sugli eventi per addestrare i propri modelli. Il token di attribuzione fornisce un modo per collegare l'evento alla richiesta, codificando l'intera richiesta di ricerca e la risposta con i filtri, i facet e gli ID prodotto di risposta richiesti. Senza un token presente negli eventi di ricerca, questi eventi vengono trattati come se non provenissero da Google AI Commerce Search e potrebbero essere utilizzati in modo errato come se provenissero da un altro fornitore di ricerca.

È normale (e previsto) che gli eventi di ricerca non abbiano token se vengono pubblicati da un altro fornitore di ricerca, ad esempio durante un esperimento A/B. Tuttavia, in genere esiste una mappatura 1:1 per le richieste dell'API Search agli eventi di ricerca con token.

Effetto negativo dei token mancanti

Se attributionToken non è presente negli eventi utente successivi pertinenti dello stesso visitatore, AI Commerce Search considera questi eventi come se non provenissero dal suo servizio di ricerca.

Ciò può comportare:

  • Addestramento del modello impreciso.
  • Analisi delle prestazioni e delle metriche errate.
  • Potenziali problemi con il raggiungimento di livelli di rendimento più elevati (come il livello 3) che richiedono un numero sufficiente di eventi attribuibili.
  • Errori segnalati nella dashboard della qualità dei dati in AI Commerce Search in Gemini Enterprise for Customer Experience se la percentuale di eventi con token di attribuzione è inferiore al 95%.

Per apprendere dal comportamento degli utenti e ottimizzare i risultati di ricerca, AI Commerce Search richiede un'attribuzione accurata solo per l'evento di ricerca iniziale.

Qualità dei dati del token di attribuzione

La dashboard della qualità dei dati nella console AI Commerce Search in Gemini Enterprise for Customer Experience mostrerà lo stato di errore di mancata conformità critico o bloccante se la percentuale di eventi con token di attribuzione è inferiore al 95%. In caso contrario, lo stato verrà visualizzato come Conforme:

Testo alternativo

La qualità dei dati al livello 3, ovvero il modello ottimizzato per le entrate, di solito non viene addestrato senza eventi attribuibili sufficienti. È vivamente sconsigliato eseguire il deployment di AI Commerce Search in produzione, a meno che non fornisca risultati di livello 3 o 4. Per saperne di più, consulta la sezione Qualità dei dati su come sbloccare i livelli di rendimento nella pagina Qualità dei dati di questa documentazione.

Token di attribuzione per i consigli

I consigli di AI Commerce Search creano automaticamente token sintetici per gli eventi attribuibili alle richieste predict.

Per le previsioni dei consigli, se un utente fa clic su un prodotto consigliato, il PredictResponse.attribution_token deve essere trasmesso come parametro URL alla pagina di prodotto e poi registrato nell'evento detail-page-view.

Registra i consigli visualizzati nell'ambito di panelInfo e imposta:

panelInfo.attributionToken=PredictResponse.attributionToken