Token di attribuzione

I token di attribuzione sono ID univoci generati da AI Commerce Search e restituiti con ogni richiesta di ricerca. Consentono alla ricerca AI Commerce 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 API di una ricerca dell'utente. Esiste un nuovo token di attribuzione per ogni ricerca; 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 i percorsi 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 di un clic o di add-to-cart, anche se l'acquisto viene comunque attribuito alla ricerca originale).

Comportamento dei token di attribuzione

I token di attribuzione sono:

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

  • Associato a eventi che seguono direttamente la ricerca: il 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 purchase-complete: 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"
}

La ricerca AI Commerce utilizza i dati degli 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 della risposta richiesti. Senza un token presente negli eventi di ricerca, questi eventi vengono trattati come se non provenissero dalla ricerca Google AI Commerce 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 errata delle metriche e delle prestazioni.
  • 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. È sconsigliato vivamente di eseguire il deployment della ricerca AI Commerce 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 e la 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 suggerimenti, se un utente fa clic su un prodotto consigliato, il valore 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