Handhabung von Click-Tracking in API-Setups mit Clerk.js

Clerk.io verwendet Klick-Tracking sowohl zur Personalisierung der Ergebnisse für Besucher als auch zur Darstellung der Leistung in my.clerk.io..

Folgen Sie diesen Schritten, um Click-Tracking einzurichten.

1. Besucher ID’s zuweisen

Der erste Schritt besteht darin, jedem Besucher eine eindeutige ID zuzuweisen. Am einfachsten geht das, indem Sie eine eindeutige, zufällige Zeichenfolge mit 8 Buchstaben in einem Cookie speichern. Es sind nur alphanumerische Zeichenfolgen mit bis zu 32 Zeichen zulässig.

Eine Besucher-ID sollte nur für das jeweilige Gerät eindeutig sein. Die geräteübergreifende Zuordnung wird von [Clerk.io] (http://Clerk.io) automatisch vorgenommen, wenn wir feststellen, dass eine Kunden-ID/E-Mail-Adresse mit mehreren Besucher-IDs verwendet wird.

Jedes Mal, wenn Sie eine API-Anfrage stellen, müssen Sie die Besucher-ID aus dem Cookie als Parameter Besucher senden.

Wenn Sie die Besucher-ID gespeichert haben, konfigurieren Sie Clerk.js so, dass sie einbezogen wird:

  <!-- 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. Labels in API-Aufrufe einbinden

Da das Clerk.io Dashboard es Ihnen ermöglicht, die Leistung jedes einzelnen Teils der Suche und der Empfehlungen zu sehen, sollten Sie immer den Parameter labels in jeden Aufruf einschließen, in dem Sie Ergebnisse anzeigen.

labels ist eine Liste, die mindestens eine Zeichenkette enthält, die der Name ist, der bei der Überprüfung der Leistung in my.clerk.io angezeigt wird.

Vollständiger Beispielaufruf mit Besucher-ID und Labels:

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. Click-Tracking hinzufügen

Das Click-Tracking sollte zu **allen von [Clerk.io] (http://Clerk.io) zurückgegebenen Produkten hinzugefügt werden.

Fügen Sie data-clerk-product-id=“PRODUCT_ID “ zum Wurzelelement aller von Clerk.io zurückgegebenen Produkte hinzu, wobei PRODUCT_ID durch die tatsächliche ID des jeweiligen Produkts ersetzt wird:

<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 fügt diesen Elementen automatisch Click-Tracking hinzu.

4. Sales-Tracking hinzufügen

Wenn Sie es noch nicht eingerichtet haben, müssen Sie die Verkäufe aus dem Webshop verfolgen.

Fügen Sie einfach das folgende Snippet zu Ihrer Order Success Seite hinzu, und stellen Sie sicher, dass Clerk.js auf der Seite verfügbar ist:

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

So! Jetzt läuft das Click-Tracking in Ihrer API-Einrichtung.