Tokens de atribución

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 reordenamiento 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 for Commerce para generar informes precisos.

Cómo funcionan los tokens de atribución

Recopilas el attributionToken de la respuesta de la API de la búsqueda de un usuario. Hay un token de atribución nuevo para cada búsqueda; los tokens de atribución no se repiten.

Cuando Vertex AI Search for Commerce procesa una solicitud de búsqueda o recomendación, devuelve un attributionToken único en su respuesta:

  • Este token es fundamental para vincular las acciones posteriores del usuario (como los clics, las acciones de agregar al carrito y las compras) con la búsqueda o recomendación específica que las generó.
  • Es importante vincular el token de búsqueda correcto a los Eventos de búsqueda para que los Eventos de vista de página detallada, los Eventos de agregar al carrito y los Eventos de compra se puedan conectar correctamente.

Se debe enviar una respuesta placements.search en un evento de usuario de búsqueda o exploración, y de inmediato en el caso de que un usuario interactúe con un producto. Esto incluye los recorridos del usuario, como los siguientes:

  • search (SÍ) → add-to-cart (SÍ)
  • search (SÍ) → detail-page-view (SÍ)
  • search (SÍ) → purchase (NO) (el usuario no interactúa directamente con un producto en el momento de la compra de la misma manera que con un clic o add-to-cart, aunque la compra se sigue atribuyendo a la búsqueda original).

Comportamiento del token de atribución

Los tokens de atribución son los siguientes:

  • Específico del visitante: El attributionToken se asocia con una respuesta de búsqueda específica que se entrega a un visitorId en particular. Solo el evento de búsqueda en sí debe etiquetarse con el token. Todos los eventos posteriores que no sean de búsqueda no deben etiquetarse con un token.

  • Asociado con eventos que siguen directamente a la búsqueda: El attributionToken es particularmente importante para los eventos del usuario que representan una interacción directa con los resultados de la búsqueda específica. Esto incluye los eventos de compra completada: La compra sigue vinculada a través de los IDs de producto y visitorId.

    Nota: Si un solo usuario realiza varias búsquedas, cada nueva solicitud de búsqueda genera un token de atribución, y el evento de búsqueda posterior debe incluir ese token nuevo. No se reutiliza un token de atribución de un evento de búsqueda anterior para un evento de búsqueda posterior, ya que cada búsqueda inicia un token nuevo.

Tokens de atribución en la API de Search

Cada respuesta que muestra el método de Vertex AI Search for commerce 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, ya que codifica la solicitud y la respuesta de búsqueda completas con los filtros, las facetas y los IDs de productos de respuesta solicitados. Si no hay un token presente en los eventos de búsqueda, se los tratará como si no fueran de Google Vertex AI Search y es posible que se usen de forma incorrecta como si fueran de otro proveedor de búsqueda.

Es normal (y esperado) 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, suele haber una asignación 1:1 de las solicitudes de la API de Search a los eventos de búsqueda con tokens.

Efecto negativo de la falta de tokens

Si el attributionToken no se encuentra en los eventos de usuario posteriores pertinentes del mismo visitante, Vertex AI Search for Commerce trata esos eventos como si no se hubieran originado en su servicio de búsqueda.

Esto puede producir:

  • Entrenamiento impreciso del modelo
  • Análisis de rendimiento y métricas incorrectos
  • Posibles problemas para alcanzar niveles de rendimiento más altos (como el nivel 3) que requieren suficientes eventos atribuibles
  • Se informan errores en el panel de calidad de los datos en la Búsqueda para comercio si el porcentaje de eventos con tokens de atribución es inferior al 95%.

Para aprender del comportamiento del usuario y optimizar los resultados de la búsqueda, Vertex AI Search for Commerce requiere una atribución precisa solo para el evento de búsqueda inicial.

Calidad de los datos del token de atribución

En el Panel de calidad de los datos de la consola de Search for commerce, se mostrará el 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 se mostrará como Cumple con los requisitos:

Texto alternativo

Por lo general, la calidad de los datos en el nivel 3, que es el modelo optimizado para los ingresos, no se entrenará sin suficientes eventos atribuibles. No se recomienda implementar Vertex AI Search for Commerce en producción, a menos que muestre resultados en el nivel 3 o 4. Para obtener más información, consulta la sección Calidad de los datos sobre cómo desbloquear niveles de rendimiento en la página Calidad de los datos de esta documentación.

Tokens de atribución para las recomendaciones

Las recomendaciones de Vertex AI Search crean automáticamente tokens sintéticos para los eventos atribuibles a las solicitudes de predict.

En el caso de las predicciones de recomendaciones, si un usuario hace clic en un producto recomendado, se debe pasar el PredictResponse.attribution_token como un parámetro de URL a la página del producto y, luego, registrarlo en el evento detail-page-view.

Registra las recomendaciones mostradas como parte de panelInfo y establece lo siguiente:

panelInfo.attributionToken=PredictResponse.attributionToken