Gestión del seguimiento de clics en configuraciones de API directamente con la API

Clerk.io utiliza click-tracking tanto para personalizar los resultados para los visitantes como para mostrar el rendimiento en my.clerk.io.

Siga estos pasos para configurar el seguimiento de clics

1. Asignar ID de visitante

El primer paso es dar a cada visitante un ID único. La forma más sencilla de hacerlo es guardando una cadena única y aleatoria de 16 letras en una cookie. Sólo se permiten cadenas alfanuméricas de hasta 32 caracteres.

Un ID de visitante sólo debe ser único para el dispositivo. La asociación entre dispositivos es gestionada automáticamente por Clerk.io si detectamos que un identificador de cliente/dirección de correo electrónico se utiliza con varios identificadores de visitante.

Cada vez que realices una solicitud API deberás enviar el ID de visitante de la cookie como parámetro de visitante.

Ejemplo:

visitor: "7t2i2H8l"

2. Incluir etiquetas en las llamadas a la API

Dado que el panel Clerk.io le permite ver el rendimiento de cada parte individual de la Búsqueda y las Recomendaciones, siempre debe incluir el parámetro labels en cada llamada en la que muestre resultados.

“labels” es una lista que contiene al menos 1 cadena, que es el nombre que se mostrará al comprobar el rendimiento en my.clerk.io.

Ejemplo completo de llamada con ID de visitante y etiquetas:

curl -X POST \
     -H 'Content-Type: application/json' \
     -d '{"key": "STyoUzAmh3JeZvw2LTOyo6CsUOPBtri5",
          "visitor": "7t2i2H8l",
          "limit": 30,
          "labels": ["VisitorRecommendations"]}' \
     http://api.clerk.io/v2/recommendations/visitor/complementary

3. Añadir seguimiento de clics

El seguimiento de clics debe añadirse a todos los productos devueltos desde Clerk.io .

El rastreo de clics se maneja a través del log/click API endpoint .

La llamada debe realizarse cuando el visitante hace clic en un producto devuelto desde Clerk.io y debe incluir el parámetro visitante y el ID del producto en el que se hace clic.

Ejemplo:

curl -X POST \
     -H 'Content-Type: application/json' \
     -d '{"key": "STyoUzAmh3JeZvw2LTOyo6CsUOPBtri5",
          "visitor": "7t2i2H8l",
          "product": 123}' \
       https://api.clerk.io/v2/log/click

4. Añadir seguimiento de ventas

Por último, si aún no lo ha configurado, debe realizar un seguimiento de las ventas procedentes de la tienda virtual.

El seguimiento de las ventas también se puede hacer a través de Clerk.js o mediante una llamada a la API.

El seguimiento de las ventas se realiza a través de log/sale API endpoint.

La llamada debe realizarse desde la página Order Success, y debe incluir el ID del visitante así como toda la información de la venta:

curl -X POST \
     -H 'Content-Type: application/json' \
     -d '{"key": "STyoUzAmh3JeZvw2LTOyo6CsUOPBtri5",
          "sale": 567,
          "products": [
            {
              "id": 1,
              "price": 99.95,
              "quantity": 2
            },
            {
              "id": 33,
              "price": 14.00,
              "quantity": 2
            }
          ],
          "email": "theone@matrix.com",
          "visitor":  "7t2i2H8l"}' \
       https://api.clerk.io/v2/log/sale

Ya está. Ahora tiene el seguimiento de clics en su configuración de API.