Tokens de atribución

Los tokens de atribución son IDs únicos que genera Vertex AI Search para el comercio y que 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

Recopila el attributionToken de la respuesta de la API de la búsqueda de un usuario. Los tokens de atribución son obligatorios en los eventos de impresiones de búsqueda, pero no se deben enviar para ningún otro evento, como clics, agregar al carrito y compras.

Comportamiento del token de atribución

Los tokens de atribución tienen las siguientes características:

• Específico del visitante: El attributionToken está asociado con una respuesta de búsqueda específica que se entrega a un "visitorId" en particular. Solo el evento de búsqueda 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: 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 lo siguiente:

  • Eventos de búsqueda posteriores: Si el mismo usuario realiza otra búsqueda justo después de la inicial (por ejemplo, define mejor su búsqueda), lo ideal es que el attributionToken de la primera respuesta de búsqueda se incluya en el evento del usuario de la segunda búsqueda si esta es una continuación de la primera.

  • Eventos de compra completa: La compra aún está vinculada a través de los IDs de productos y visitorId.

• Facilitar la asignación de eventos de búsqueda y solicitudes: Incluir el attributionToken en los eventos de usuario posteriores es fundamental para asignar con precisión el comportamiento del usuario a la solicitud de búsqueda específica y sus resultados que publica Vertex AI Search para el comercio.

  Esta vinculación permite que Vertex AI Search comprenda lo siguiente:

  • Qué búsquedas y resultados generaron la participación de los usuarios (clics, vistas, productos agregados al carrito, compras).
  • La relevancia y la eficacia de la clasificación de la Búsqueda
  • Si se deben generar ejemplos positivos y negativos para entrenar el modelo de clasificación
  • Cómo calcular las métricas por búsqueda, como la tasa de clics (CTR), el porcentaje de conversiones (CVR) y los ingresos por búsqueda
  • Cómo atribuir las conversiones a la búsqueda específica que las generó, especialmente en situaciones de pruebas A/B

Tokens de atribución en la API de Búsqueda

Cada respuesta que muestra el método de búsqueda de comercio de Vertex AI incluye un attributionToken único al final del cuerpo de la respuesta de la 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.

Efecto adverso de los tokens faltantes

Si el attributionToken no está en los eventos de usuario posteriores relevantes del mismo visitante, Vertex AI Search for Commerce trata esos eventos como si no se originaran en su servicio de búsqueda.

Esto puede producir:

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

Para aprender del comportamiento de los usuarios 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 Búsqueda para comercio, 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 del 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 de esta documentación.

Tokens de atribución para las recomendaciones

Como no hay un evento de usuario específico para las recomendaciones, no incluyas tokens de atribución de las respuestas de predict en ningún evento. En otras palabras, no envíes tokens de atribución a PredictResponse.attribution_token en eventos de usuario posteriores que resulten de una recomendación (como detail-page-view o add-to-cart).

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