Get Started

Bringen Sie Clerk in nur wenigen Schritten auf Ihrem Lightspeed-Store zum Laufen. Dieser Leitfaden führt Sie durch das Verbinden Ihres Stores, die Installation von Tracking-Skripten und die Synchronisation Ihrer Daten.

Store verbinden #

Nachdem Sie diese einfachen Schritte befolgt haben, können Sie Ihre Live Demo sehen, die Ihnen einen persönlichen Überblick darüber gibt, wie Clerk in Ihrem Webshop funktioniert, bevor Sie den Rest des Systems einrichten.

Store hinzufügen #

Nachdem Sie sich bei my.clerk.io angemeldet haben, müssen Sie als Erstes Ihren Store hinzufügen:

1. Geben Sie den Name und die Domain Ihres Webshops ein.

2. Wählen Sie Lightspeed als Plattform und wählen Sie Ihre Währung.

3. Klicken Sie auf Add Store.

Tracking-Skripte installieren #

1. Gehen Sie in Ihrem Lightspeed-Backend zu Settings > Website-Settings > Web Extras.

2. Besucher-Tracking: Finden Sie das Custom JS Feld und fügen Sie das Clerk Besucher-Tracking-Skript ein.

   • Ersetzen Sie INSERT_PUBLIC_API_KEY durch Ihren Public Key aus my.clerk.io > Developers > API Keys.

• Falls dies nicht funktioniert, fügen Sie das Skript stattdessen in das Tracking Feld ein.

<!-- Clerk.io Visitor Tracking (Lightspeed) -->
<script type="text/javascript">
  (function(w,d){
    var e=d.createElement('script'); e.type='text/javascript'; e.async=true;
    e.src='https://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: 'INSERT_PUBLIC_API_KEY',
    formatters: {
      convert_currency: function(price) {
        const rate_raw = '{{ 100 | money }}'.replace(/[^0-9.]/g, '');
        const rate = parseFloat(rate_raw) ? (parseFloat(rate_raw) / 100) : 1;
        return rate * price;
      }
    },
    globals: {
      currency_iso: '{{ shop.currency2.code }}',
      currency_symbol: '{{ shop.currency2.symbol }}'
    }
  });

  {% if page.account.email %}
  Clerk('call', 'log/email', { email: '{{ page.account.email }}' });
  {% endif %}
</script>

3. Bestell-Tracking: Suchen Sie auf derselben Seite das Feld Tracking und fügen Sie den Clerk Bestell-Tracking-Code unterhalb des Besucher-Skripts ein.

<span
  class="clerk"
  data-api="log/sale"
  data-sale="{{ order.information.number }}"
  data-email="{{ order.customer.email }}"
  data-customer="{{ order.customer.id }}"
  data-products='[{% for product in order.products %}{"id":{{ product.product_id }},"quantity":{{ product.quantity }},"price":{{ product.base_price_incl }}}{% if not loop.last %},{% endif %}{% endfor %}]'>
</span>

4. Klicken Sie auf Save.

Daten synchronisieren #

1. Gehen Sie zu my.clerk.io > Data > Configuration.

2. Geben Sie die folgenden Informationen für Ihren Lightspeed-Store ein:

   • Domain: Die URL Ihres Webshops (z.B. https://www.beautifulshop.nl/).

   • Cluster ID: Siehe Dokumentation zu Lightspeed’s Server Clusters (wählen Sie den Cluster für Ihre Region, z.B. https://api.webshopapp.com/nl für NL).

   • API Key und API Secret: Wenden Sie sich an Lightspeed Support, um diese für Ihren Store generieren zu lassen.

   • Language (optional): Verwenden Sie Codes wie en oder nl für mehrsprachige Setups.

3. Tragen Sie die Angaben in die Importer-Felder ein. Optionale erweiterte Einstellungen können unverändert bleiben.

4. Klicken Sie auf Start Sync und warten Sie, bis die Synchronisation abgeschlossen ist.