Seguimiento de clics en configuraciones de API con Clerk.js

Clerk.io utiliza el seguimiento de clics tanto para personalizar los resultados para los visitantes como para mostrar el rendimiento en mi.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 8 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 visitante.

Cuando hayas guardado el ID de visitante, configura Clerk.js para incluirlo:

  <!-- Start of Clerk.io E-commerce Personalisation tool - www.clerk.io -->
  <script type="text/javascript">
    (function(w,d){
      var e=d.createElement('script');e.type='text/javascript';e.async=true;
      e.src=(d.location.protocol=='https:'?'https':'http')+'://cdn.clerk.io/clerk.js';
      var s=d.getElementsByTagName('script')[0];s.parentNode.insertBefore(e,s);
      w.__clerk_q=w.__clerk_q||[];w.Clerk=w.Clerk||function(){w.__clerk_q.push(arguments)};
    })(window,document);

    Clerk('config', {
      key: 'STyoUzAmh3JeZvw2LTOyo6CsUOPBtri5',
      visitor: '7t2i2H8l'
    });
  </script>
  <!-- End of Clerk.io E-commerce Personalisation tool - www.clerk.io -->

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..

Añade data-clerk-product-id=“PRODUCT_ID “ al elemento raíz de todos los productos devueltos desde Clerk.io, donde PRODUCT_ID se sustituye por el ID real de cada producto:

<ul class="product-list from-clerk">
  <li class="product" data-clerk-product-id="123">
    <a href="/green-lightsaber">
      <img src="/images/green-lightsaber.jpg" />
      Green Lightsaber
      <button>Add To Basket</button>
  </li>
  <li class="product" data-clerk-product-id="456">
    <a href="/super-death-star">
      <img src="/images/super-death-star.jpg" />
      Super Death Star
      <button>Add To Basket</button>
  </li>
</ul>

Clerk.js añadirá automáticamente el seguimiento de clics a esos elementos.

4. Añadir seguimiento de ventas

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

Simplemente añada el siguiente fragmento a su página Order Success, y asegúrese de que Clerk.js está disponible en la página:

<script type="text/javascript">
   Clerk("call",
	 "log/sale",
	 {
	   key: "0bi730epQAlK3Md0nAzzM78zNoEcq5KT",
	   sale: "123456",
	   email: "luke@skywalker.com",
	   customer: "5555",
	   products: [
               {
                  "id": 5528,
	          "quantity": 1,
	  	  "price": 99.95
               },
	       {
	          "id": 2952,
	          "quantity": 2,
	    	  "price": 9.50
               }
	    ]
	 }
   );
  </script>

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