Los tokens de atribución son IDs únicos que genera Vertex AI Search para el comercio y se muestran con cada solicitud de búsqueda. Permiten que Vertex AI Search para comercio 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 búsqueda. Los tokens de atribución también son necesarios en los eventos de búsqueda de Vertex AI Search para el comercio para generar informes precisos.
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 for Commerce usa los datos de eventos para entrenar sus modelos. 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.
Es correcto (y esperable) tener eventos de búsqueda sin tokens si se publican desde otro proveedor de búsqueda, por ejemplo, durante un experimento A/B. Sin embargo, por lo general, hay 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
En el panel de calidad de los datos de la Búsqueda para comercios, se mostrará un Estado de incumplimiento grave 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 entrena sin suficientes eventos atribuibles. No se recomienda implementar Vertex AI Search for Commerce en producción, a menos que publique resultados en el NIVEL 3 o 4. Para obtener más información sobre cómo desbloquear niveles de rendimiento, consulta la sección Calidad de los datos en la página Calidad de los datos.
Tokens de atribución para las 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.