Questa pagina descrive come utilizzare i token di attribuzione per migliorare il rendimento nel tempo.
I token di attribuzione sono ID univoci generati da Vertex AI Search per la vendita al dettaglio e restituiti con ogni richiesta di previsione o di ricerca. Consentono a Vertex AI Search per la vendita al dettaglio di associare tra loro le azioni e i risultati degli utenti e di addestrare i modelli di riclassificazione per migliorare la qualità dei risultati.
L'inclusione dei token di attribuzione negli eventi utente è facoltativo. Se non fornisci i token di attribuzione, Vertex AI Search for Retail approssima i token di attribuzione allineando i risultati nella risposta di previsione o ricerca e degli eventi utente importati in base all'ID visitatore e ai timestamp.
Come funzionano i token di attribuzione
Ogni risposta restituita dal metodo predict o search include un attributionToken univoco nel corpo della risposta.
Ad esempio:
{
"results": [{"id": "352"}, {"id": "456"}],
"attribution_token": "abc123"
}
Quando il tuo sito web mostra un prodotto in base a un risultato di Vertex AI Search per la vendita al dettaglio, devi restituire il token di attribuzione di quel risultato quando l'utente interagisce con un prodotto restituito (ad esempio, una vista o un clic add-to-cart). Questo ciclo di feedback consente a Vertex AI Search per la vendita al dettaglio di fornire informazioni sull'impatto dei risultati sulla tua attività.
Come si restituisce il token di attribuzione
Restituisci il token di attribuzione includendolo nell'evento utente registrato per qualsiasi azione che l'utente esegue con il prodotto in un suggerimento o in un risultato di ricerca. Le azioni che un utente può intraprendere con un determinato prodotto dipendono dal design del sito web; le azioni comuni includono l'aggiunta di un prodotto a un elenco dei preferiti, la richiesta di una visualizzazione dettagliata, l'aggiunta al carrello degli acquisti o un acquisto con un solo clic.
Per restituire il token di attribuzione, devi prima associarlo al prodotto così come viene visualizzato nel riquadro dei suggerimenti o nei risultati di ricerca sul tuo sito web. Un modo comune per farlo è aggiungerlo a tutti gli URL associati ad azioni che è possibile eseguire nel riquadro dei suggerimenti o nei risultati di ricerca. Ad esempio:
https://www.example.com/54321/?rtoken=abc123
Quando l'utente interagisce con il prodotto nel riquadro dei suggerimenti o nei risultati di ricerca (che genera un evento utente), il token di attribuzione può essere analizzato dal link dell'URL e inserito nell'evento utente che invii a Vertex AI Search per la vendita al dettaglio per quell'interazione.
Ad esempio, supponi di richiedere una previsione associata alla visualizzazione di un prodotto a un utente. Vertex AI Search per la vendita al dettaglio restituisce un insieme di ID catalogo consigliati, insieme a un token di attribuzione associato.
{
"results": [{"id": "352"}, {"id": "456"}],
"attribution_token": "abc123"
}
Il tuo sito web mostra gli elementi consigliati in un riquadro dei suggerimenti e include il token di attribuzione restituito per la previsione, con ogni URL presente nel riquadro dei suggerimenti. Il sito deve essere configurato in modo da registrare l'evento da inviare a Vertex AI Search per la vendita al dettaglio. Per un esempio dell'oggetto evento utente, vedi l'evento utente di ricerca. Quando l'utente fa clic su uno dei prodotti in un risultato per vedere una visualizzazione più dettagliata, includi il token di attribuzione con l'evento utente registrato su quel clic. L'evento utente sarà simile al seguente esempio:
{
"eventType" : "detail-page-view",
"visitorId": "visitor1",
"userInfo": {
"userId": "user1"
},
"attributionToken": "abc123",
"productDetails": [{
"product": {
"id": "abc"
}
}]
}
Quando l'utente interagisce con un prodotto visualizzato in seguito a un suggerimento o a un risultato di ricerca e includi il token di attribuzione con l'evento utente per l'interazione in questione, Vertex AI Search per la vendita al dettaglio utilizza queste informazioni per la valutazione.
Ad esempio, supponiamo che l'utente veda un prodotto in un risultato di ricerca e utilizzi il risultato per aggiungerlo alla sua lista desideri e per avere una visualizzazione dettagliata del prodotto. Devi includere il token di attribuzione per entrambi gli eventi utente generati dal risultato di ricerca (add-to-cart e detail-page-view).
Ora supponiamo che lo stesso utente aggiunga il prodotto al carrello dalla visualizzazione dettagliata. Non è necessario includere il token di attribuzione con questa azione, perché è stato ricavato dalla visualizzazione dettagliata, non dal risultato di ricerca. Analogamente, se l'utente in ultima analisi acquista il prodotto, ma non direttamente dal risultato di ricerca, non offre alcun vantaggio nel restituire il token di attribuzione con l'evento purchase.