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. También se requieren tokens de atribución en los eventos de búsqueda de AI Commerce Search para obtener 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 entrega una solicitud de búsqueda o recomendación, muestra un attributionToken único en su respuesta.

Se debe enviar una respuesta placements.search en un evento de usuario de búsqueda o navegación, y de inmediato en el evento en que un usuario interactúa 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 aún se atribuye a la búsqueda original).

Comportamiento del token de atribución

Los tokens de atribución son los siguientes:

  • Específicos para el visitante: El attributionToken está asociado con una respuesta de búsqueda específica que se entrega a un `visitorId. Solo el evento de búsqueda en sí debe etiquetarse con el token. Los eventos posteriores que no sean de búsqueda no deben etiquetarse con un token.

  • Asociados 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 de esa búsqueda específica. Esto incluye los eventos de compra completada: La compra aún está 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 vuelve a usar 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 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 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 producto de respuesta solicitados. Sin un token presente en los eventos de búsqueda, esos eventos se tratan como si no fueran de AI Commerce Search de Google, y los eventos de búsqueda podrían usarse de forma incorrecta como si fueran de otro proveedor de búsqueda.

Es correcto (y esperado) tener eventos de búsqueda sin tokens si se entregan desde otro proveedor de búsqueda, por ejemplo, durante un experimento A/B. Sin embargo, por lo general, hay una asignación de 1:1 para las solicitudes de la API de Search a los eventos de búsqueda con tokens.

Efecto adverso de la falta de tokens

Si el attributionToken no está en los eventos de usuario posteriores pertinentes del mismo visitante, AI Commerce Search 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 suficientes eventos atribuibles
  • Errores informados en el panel de calidad de los datos en 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 requiere una atribución precisa solo 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 Cumplimiento:

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 entregue resultados en el Nivel 3 o el Nivel 4. Para obtener más información, consulta la sección Calidad de los datos sobre cómo desbloquear los 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 eventos atribuibles a solicitudes de predict.

Para 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