Tokens de atribución

Los tokens de atribución son IDs únicos generados por Vertex AI Search para el comercio y se devuelven con cada solicitud de búsqueda. Permiten que Vertex AI Search para el comercio asocie una solicitud de búsqueda con el evento de búsqueda correspondiente, lo que permite que los modelos de reordenación mejoren la calidad de las respuestas de búsqueda. También se necesitan tokens de atribución en los eventos de búsqueda de Vertex AI Search para el sector del comercio para generar informes precisos.

Cómo funcionan los tokens de atribución

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

Cuando Vertex AI Search para el sector del comercio responde a una solicitud de búsqueda o recomendación, devuelve un attributionToken único:

  • Este token es fundamental para vincular las acciones posteriores de los usuarios (como los clics, las adiciones al carrito y las compras) con la búsqueda o la recomendación específicas que los han llevado a realizarlas.
  • Es importante vincular el token de búsqueda correcto a Eventos de búsqueda para que Eventos de vista de página detallada, Eventos de añadir al carrito y Eventos de compra se puedan conectar correctamente.

Se debe enviar una respuesta placements.search en un evento de usuario de búsqueda o navegación, e inmediatamente si un usuario interactúa con un producto. Esto incluye recorridos de 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 forma que con un clic o una add-to-cart, aunque la compra se sigue atribuyendo a la búsqueda original).

Comportamiento de los tokens de atribución

Los tokens de atribución son:

  • Específico del visitante: el attributionToken se asocia a una respuesta de búsqueda específica que se sirve a un visitorId concreto. 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 a eventos que se producen inmediatamente después de la búsqueda: el attributionToken es especialmente importante para los eventos de usuario que representan una interacción directa con los resultados de búsqueda de esa 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 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 nuevo token. Un token de atribución de un evento de búsqueda anterior no se reutiliza en un evento de búsqueda posterior, ya que cada búsqueda inicia un nuevo token.

Tokens de atribución en la API Search

Cada respuesta que devuelve el método 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 para el comercio 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 de búsqueda completa y la respuesta con los filtros, las facetas y los IDs de producto de respuesta solicitados. Si no hay ningún token en los eventos de búsqueda, se tratarán como si no procedieran de Vertex AI Search de Google y es posible que se usen incorrectamente como si procedieran de otro proveedor de búsqueda.

Es normal (y esperado) que haya eventos de búsqueda sin tokens si se sirven desde otro proveedor de búsqueda, por ejemplo, durante un experimento A/B. Sin embargo, normalmente hay una asignación de uno a uno de las solicitudes de la API Search a los eventos de búsqueda con tokens.

Efecto adverso de la falta de tokens

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

Esto puede provocar lo siguiente:

  • Entrenamiento del modelo 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 atribuidos.
  • Los errores que se registran en el panel de control Calidad de los datos de la búsqueda de comercio se producen 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 búsqueda, Vertex AI Search para el sector del comercio solo requiere una atribución precisa del evento de búsqueda inicial.

Calidad de los datos de token de atribución

El panel de control Calidad de los datos de la consola de búsqueda de comercio mostrará el estado de un 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 será Cumplimiento:

Texto alternativo

La calidad de los datos del nivel 3, que es el modelo optimizado para los ingresos, no se suele entrenar si no hay suficientes eventos atribuibles. No se recomienda desplegar Vertex AI Search para el comercio en producción a menos que ofrezca resultados de 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 de recomendaciones

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

En el caso de las predicciones de recomendaciones, si un usuario hace clic en un producto recomendado, el valor PredictResponse.attribution_token debe enviarse como parámetro de URL a la página del producto y, a continuación, registrarse en el evento detail-page-view.

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

panelInfo.attributionToken=PredictResponse.attributionToken