Token di attribuzione

I token di attribuzione sono ID unici generati da Vertex AI Search for commerce e restituiti con ogni richiesta di ricerca. Consentono a Vertex AI Search for Commerce di associare una richiesta di ricerca all'evento di ricerca corrispondente, il che consente 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 di Vertex AI Search per il commercio.

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 Vertex AI Search for Commerce gestisce una richiesta di ricerca o suggerimento, restituisce un attributionToken univoco nella risposta:

  • Questo token è fondamentale per collegare le azioni successive dell'utente (come clic, aggiunte al carrello e acquisti) alla ricerca o al consiglio specifico che le ha generate.
  • È importante collegare il token di ricerca corretto a Eventi di ricerca, in modo che Eventi di visualizzazione della pagina di dettaglio, Eventi aggiungi al carrello ed Eventi di acquisto possano essere collegati correttamente.

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 degli utenti, ad esempio:

  • 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: attributionToken è associato a una risposta di ricerca specifica pubblicata per 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. Ciò include 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 Vertex AI Search for commerce 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"
}

Vertex AI Search for Commerce utilizza i dati sugli eventi per addestrare i suoi 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. Se non è presente un token negli eventi di ricerca, questi vengono trattati come se non provenissero da Google Vertex AI Search e potrebbero essere utilizzati in modo errato come se provenissero da un altro fornitore di ricerca.

È normale (e previsto) che si verifichino eventi di ricerca senza 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, Vertex AI Search for Commerce 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 eventi attribuibili sufficienti.
  • Errori segnalati nella dashboard Qualità dei dati in Search for Commerce se la percentuale di eventi con token di attribuzione è inferiore al 95%.

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

Qualità dei dati dei token di attribuzione

La dashboard della qualità dei dati nella console Search for commerce mostrerà un errore di mancata conformità Stato 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, in genere non viene addestrato senza eventi attribuibili sufficienti. Sconsigliamo vivamente di eseguire il deployment di Vertex AI Search for 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 nella pagina Qualità dei dati di questa documentazione.

Token di attribuzione per i suggerimenti

I suggerimenti di Vertex AI 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 del prodotto e poi registrato nell'evento detail-page-view.

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

panelInfo.attributionToken=PredictResponse.attributionToken