Tokens de atribución

Los tokens de atribución son IDs únicos que genera AI Commerce Search y que se devuelven con cada solicitud de búsqueda. Permiten que AI Commerce Search 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 obligatorios en los eventos de búsqueda de AI Commerce Search 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 AI Commerce Search responde una solicitud de búsqueda o recomendación, devuelve un attributionToken único en su respuesta.

Se debe enviar una respuesta de 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 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 para el visitante: El objeto attributionToken se asocia con una respuesta de búsqueda específica que se entrega a un objeto 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 de 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 productos 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 devuelve el método de AI Commerce Search 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"
}

AI Commerce Search utiliza 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 tratan como si no fueran de la Búsqueda de comercio con IA de Google, 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, AI Commerce Search trata esos eventos como si no se hubieran originado en su servicio de búsqueda.

Esto puede producir:

  • Entrenamiento de modelos impreciso
  • 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 de AI Commerce Search en Gemini Enterprise for Customer Experience 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, AI Commerce Search solo requiere una atribución precisa para el evento de búsqueda inicial.

Calidad de los datos del token de atribución

El Panel de calidad de los datos en la consola de AI Commerce Search en Gemini Enterprise for Customer Experience 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 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 AI Commerce Search 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 recomendaciones

Las recomendaciones de AI Commerce 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