Gestire il tracciamento dei clic nelle impostazioni API con Clerk.js

Clerk.io utilizza il click-tracking sia per personalizzare i risultati per i visitatori che per mostrare le performance in my.clerk.io..

Seguite questi passaggi per impostare il tracciamento dei clic.

1. Assegnare gli ID dei visitatori

Il primo passo consiste nell’assegnare a ogni visitatore un ID univoco. Il modo più semplice per farlo è salvare una stringa unica, casuale, di 8 lettere in un cookie. Sono consentite solo stringhe alfanumeriche fino a 32 caratteri.

L’ID del visitatore deve essere unico per il dispositivo. L’associazione tra dispositivi viene gestita automaticamente da Clerk.io se viene rilevato che un ID cliente/indirizzo e-mail viene utilizzato con più ID visitatore.

Ogni volta che si effettua una richiesta API è necessario inviare l’ID visitatore dal cookie come parametro visitatore.

Una volta salvato l’ID visitatore, configurare Clerk.js per includerlo:

  <!-- 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. Includere le etichette nelle chiamate API

Poiché la dashboard Clerk.io consente di vedere le prestazioni di ogni singola parte di Ricerca e Raccomandazioni, è necessario includere sempre il parametro labels in ogni chiamata in cui si mostrano i risultati.

labels è un elenco contenente almeno una stringa, che è il nome che verrà mostrato durante la verifica delle prestazioni in my.clerk.io.

Esempio completo di chiamata con ID visitatore ed etichette:

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. Aggiungere il tracciamento dei clic

Il tracciamento dei clic dovrebbe essere aggiunto a tutti i prodotti restituiti da Clerk.io.

Aggiungere data-clerk-product-id=“PRODUCT_ID “ all’elemento root di tutti i prodotti restituiti da Clerk.io, dove PRODUCT_ID è sostituito dall’ID effettivo di ciascun prodotto:

<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 aggiungerà automaticamente il tracciamento dei clic a questi elementi.

4. Aggiungere il tracciamento delle vendite

Infine, se non è già stato impostato, è necessario tracciare le vendite provenienti dal negozio web.

È sufficiente aggiungere il seguente snippet alla pagina Order Success e assicurarsi che Clerk.js sia disponibile nella pagina:

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

Ecco! Ora il tracciamento dei clic è attivo nella configurazione dell’API.