I token di attribuzione sono ID univoci generati da Vertex AI Search per il commercio 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 ranking di migliorare la qualità delle risposte di ricerca. I token di attribuzione sono obbligatori anche negli eventi di ricerca di Vertex AI Search per il commercio per generare report accurati.
Come funzionano i token di attribuzione
Ogni risposta restituita dal metodo Vertex AI 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" }
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 la richiesta e la risposta di ricerca completa con i filtri, i facet e gli ID prodotto di risposta richiesti. Se non è presente un token negli eventi di ricerca, questi vengono trattati come se non provenissero da Vertex AI Search di Google e potrebbero essere utilizzati in modo errato come se provenissero da un altro fornitore di servizi di ricerca.
È normale (e previsto) che gli eventi di ricerca non abbiano token se vengono pubblicati da un altro fornitore di servizi di ricerca, ad esempio durante un esperimento A/B. Tuttavia, in genere esiste una mappatura 1:1 per le richieste dell'API di ricerca per cercare eventi con token.
Qualità dei dati dei token di attribuzione
La dashboard Qualità dei dati nella Ricerca per il commercio mostrerà uno stato di errore di mancata conformità critico o di blocco se la percentuale di eventi con token di attribuzione è inferiore al 95%. In caso contrario, lo stato sarà Conforme:
La qualità dei dati a LIVELLO 3, ovvero il modello ottimizzato per le entrate, in genere non viene addestrata senza eventi attribuibili sufficienti. Sconsigliamo vivamente di eseguire il deployment di Vertex AI Search for Commerce in produzione, a meno che non vengano pubblicati risultati in TIER 3 o TIER 4. Per ulteriori informazioni, consulta la sezione Qualità dei dati su come sbloccare i livelli di rendimento nella pagina Qualità dei dati.
Token di attribuzione per i consigli
Poiché non esiste un evento per i consigli, non è necessario includere i token di attribuzione delle risposte predict in nessun evento.
Il token di attribuzione della risposta di previsione può essere inviato in eventi successivi (di solito detail-page-view o add-to-cart), ma non è obbligatorio. L'implementazione richiede il passaggio del token di attribuzione del prodotto consigliato in un parametro URL all'URL pagina del prodotto e l'utilizzo di questo parametro per compilare il campo attributionToken dell'evento detail-page-view.
I consigli di Vertex AI Search creano automaticamente token sintetici per gli eventi attribuibili alle richieste predict. L'aggiunta esplicita dei token può migliorare leggermente l'accuratezza dei report di analisi. Tuttavia, non è strettamente necessario e avrà scarso impatto sui modelli di consigli.