Tokens de atribución

En esta página, se describe cómo usar los tokens de atribución para mejorar el rendimiento de la búsqueda con el tiempo.

Los tokens de atribución son ID únicos que genera la venta minorista y que se muestran con cada solicitud de búsqueda, que permiten a la venta minoristas asociar las acciones del usuario y los resultados de la búsqueda entre sí, y entrenar modelos de reclasificación de búsqueda para mejorar la calidad de la búsqueda.

La inclusión de tokens de atribución en tus eventos de usuario es opcional. Si no proporcionas tokens de atribución, la venta minorista se aproxima a los tokens de atribución mediante la alineación de los resultados en la respuesta de búsqueda y los eventos de usuario transferidos según el ID de visitante y las marcas de tiempo.

Cómo funcionan los tokens de atribución

Cada respuesta que muestra el método predict o search incluye un attributionToken único en el cuerpo de su respuesta. Por ejemplo:

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Cuando tu sitio web muestra un producto basado en un resultado de la API de venta minorista, debes mostrar el token de atribución de ese resultado cuando el usuario interactúa con un producto que se muestra (por ejemplo, un vista, o un clic add-to- cart). Este ciclo de reacción permite que la venta minorista proporcione información sobre cómo los resultados afectan a tu empresa.

Cómo debes mostrar el token de atribución

Para mostrar el token de atribución, inclúyelo en el evento de usuario que registras para cualquier acción que el usuario realice con el producto en una recomendación o un resultado de la búsqueda. Las acciones que un usuario puede realizar con ese producto dependen del diseño del sitio web. Entre las acciones comunes se incluyen agregar un producto a una lista de favoritos, solicitar una vista detallada, agregarlo a un carrito de compras o realizar una compra con un solo clic.

Para mostrar el token de atribución, primero debes asociarlo con el producto como se muestra en el panel de recomendaciones o en los resultados de la búsqueda en tu sitio web. Una forma común de hacerlo es adjuntarla a todas las URL asociadas con acciones que se pueden realizar en el panel de recomendaciones o en los resultados de la búsqueda. Por ejemplo:

https://www.example.com/54321/?rtoken=abc123

Cuando el usuario interactúa con ese producto en el panel de recomendaciones o los resultados de la búsqueda (que genera un evento de usuario), el token de atribución se puede analizar desde el vínculo de la URL y, luego, insertarse en el evento de usuario que envías a la venta minorista para esa interacción.

Por ejemplo, supongamos que solicitas una predicción asociada con la visualización de un producto de un usuario. La venta minorista muestra un conjunto de ID del catálogo recomendadas, junto con un token de atribución asociado.

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

El sitio web muestra los elementos recomendados en un panel de recomendaciones y, además, incluye el token de atribución que se muestra para esa predicción con cada URL en el panel de recomendaciones. Debes tener tu sitio configurado para registrar ese evento a fin de enviarlo a la venta minorista (consulta Eventos de usuario para ver un ejemplo del objeto de evento de usuario). Cuando el usuario hace clic en uno de los productos como resultado para obtener una vista más detallada, debes incluir el token de atribución con el evento de usuario que registras en ese clic. El evento del usuario sería similar al siguiente ejemplo:

{
  "eventType" : "detail-page-view",
  "visitorId": "visitor1",
  "userInfo": {
    "userId": "user1"
   },
   "attributionToken": "abc123",
   "productDetails": [{
     "product": {
        "id": "abc"
       }
     }]
}

Cuando el usuario interactúa con un producto que se muestra debido a una recomendación o un resultado de la búsqueda, y tú incluyes el token de atribución con el evento de usuario para esa interacción, la venta minorista usa esa información para la evaluación.

Por ejemplo, supongamos que el usuario ve un producto en un resultado de la búsqueda y lo usa para agregar ese producto a su lista de deseos y obtener una vista detallada del producto. Debes incluir el token de atribución para los dos eventos de usuario que se generaron a partir del resultado de la búsqueda (add-to-cart y detail-page-view).

Ahora supongamos que el mismo usuario agrega ese producto a su carrito desde la vista detallada. No es necesario que incluyas el token de atribución con esa acción, ya que se tomó de la vista detallada, no del resultado de la búsqueda. Del mismo modo, si ese usuario finalmente compra el producto, pero no directamente desde el resultado de la búsqueda, no hay beneficio en mostrar el token de atribución con el evento de compra.