Los tokens de atribución son IDs únicos que genera Vertex AI Search para la venta minorista y que se muestran con cada solicitud de búsqueda. Permiten que Vertex AI Search para la venta minorista asocie una solicitud de búsqueda con su evento de búsqueda coincidente, lo que permite que los modelos de reclasificación mejoren la calidad de las respuestas de la búsqueda. Los tokens de atribución también son necesarios en los eventos de búsqueda para generar informes precisos.
La inclusión de tokens de atribución de búsqueda en todos los eventos de búsqueda que entrega Vertex AI Search para venta minorista es un entrenamiento de modelos de NIVEL 3 y NIVEL 4 obligatorio.
Cómo funcionan los tokens de atribución
Cada respuesta que muestra el método de búsqueda de Vertex AI incluye un attributionToken único al final del cuerpo de la respuesta de búsqueda. Por ejemplo:
{ "results": [ { "id": "727121", "product": { … } ], "totalSize": 19600, "attributionToken": "dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB", "nextPageToken": "AM1MDZiNWOyQjM4UTLlNGN50iMwYjMtADMwATLwIGMhBzY2YDJaIw-bCbxQYAt1PJgIwgExEgC" …
Este token debe incluirse en el evento de búsqueda posterior:
{ "eventType": "search", "searchQuery":"red t-shirt", "productDetails":[ {"product":{"id":"727121"}}, {"product":{"id": … } ] , "visitorId":"GA1.1.1383176924.1721324981", "attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB" }
Vertex AI Search para venta minorista usa los datos de eventos para entrenar sus modelos, y el token de atribución proporciona una forma de vincular el evento con la solicitud, codificando la solicitud y la respuesta de búsqueda completas con los filtros, las facetas y los IDs de productos de respuesta solicitados. Sin un token presente en los eventos de búsqueda, estos se tratan como si no fueran de la Búsqueda de Google Vertex AI, y es posible que se usen de forma incorrecta como si fueran de otro proveedor de búsqueda. Está bien (y se espera) tener eventos de búsqueda sin tokens si se publican desde otro proveedor de búsqueda, por ejemplo, durante un experimento A/B, pero, por lo general, debe haber una asignación 1:1 para las solicitudes de la API de búsqueda para buscar eventos con tokens.
Calidad de los datos del token de atribución
El panel de calidad de los datos de la Búsqueda para venta minorista mostrará un Estado de error de incumplimiento crítico o de bloqueo si el porcentaje de eventos con tokens de atribución es inferior al 95%. De lo contrario, el Estado aparecerá como Conforme:
Por lo general, la calidad de los datos en el nivel 3, que es el modelo optimizado para los ingresos, no se entrenará sin eventos atribuibles suficientes, y no se recomienda implementar Vertex AI Search para venta minorista en producción, a menos que publique resultados en el nivel 3 o 4.
Tokens de atribución para Recomendaciones
Dado que no hay un evento para las recomendaciones, no es necesario incluir tokens de atribución de las respuestas de predict en ningún evento.
El token de atribución de la respuesta de predicción se puede enviar en eventos posteriores (por lo general, un detail-page-view o add-to-cart), pero no es obligatorio. La implementación requeriría pasar el token de atribución del producto recomendado en un parámetro de URL a la URL de la página del producto y, luego, usar ese parámetro para propagar el campo attributionToken del evento detail-page-view.
Las recomendaciones de Vertex AI Search crean automáticamente tokens sintéticos para eventos atribuibles a solicitudes de predict. Agregar los tokens de forma explícita puede mejorar ligeramente la precisión de los informes de estadísticas. Sin embargo, esto no es estrictamente obligatorio y tendrá poco impacto en los modelos de recomendaciones.