Get Started

Få Clerk op at køre på din Lightspeed-butik på blot få trin. Denne guide guider dig gennem tilslutning af din butik, installation af tracking scripts og synkronisering af dine data.

Tilslut din butik #

Efter at have fulgt disse enkle trin vil du kunne se din Live Demo, som giver dig et personligt overblik over, hvordan Clerk vil fungere på din webshop, inden resten af systemet sættes op.

Tilføj butik #

Når du er logget ind på my.clerk.io, er det første, du skal gøre, at tilføje din butik:

1. Skriv Name og Domain på din webshop.

2. Vælg Lightspeed som Platform, og vælg din Currency.

3. Klik på Add Store.

Installer tracking scripts #

Clerk tracking scriptet bruger Lightspeed Liquid-variabler til at læse butikkens data, såsom valuta og produktkontekst. Derfor skal scriptet placeres i en tema-fil, hvor Liquid bliver behandlet.

Besøgs-tracking #

1. I din Lightspeed-backend, gå til Design > Theme Editor > Advanced > Edit Code.

2. Åbn layouts > custom.rain.

3. Indsæt følgende script nederst i filen, og erstat INSERT_PUBLIC_API_KEY med din Public Key fra my.clerk.io > Developers > API Keys.

<!-- 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 }}'
    }
  });
  // Clerk.js Context
  Clerk('context', {
    product: {% if product.id %}'{{ product.id }}'{% else %}null{% endif %},
    category: {% if collection.category_id %}'{{ collection.category_id }}'{% else %}null{% endif %},
    page: {% if product.id %}null{% else %}{% if collection.category_id %}null{% else %}'{{ template }}'{% endif %}{% endif %}
  });

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

4. Klik på Save.

Kurv- og takkesiderne i Lightspeed bruger en separat tema-fil kaldet fixed.rain. Denne fil arver ikke scripts fra custom.rain, så Clerk.js indlæses ikke på disse sider, medmindre scriptet også tilføjes der.

5. Åbn layouts > fixed.rain i samme Theme Editor.

6. Indsæt det samme script lige før den afsluttende </head>-tag.

7. Klik på Save.

Ordre-tracking #

1. I din Lightspeed-backend, gå til Settings > Website-Settings > Web Extras.

2. Find boksen Tracking og indsæt Clerk order tracking-koden.

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

3. Klik på Save.

Hvis ordrer stadig ikke spores #

Nogle Lightspeed-temaer indlæser ikke Clerk.js fra custom.rain og fixed.rain under checkout. Hvis Clerk.io allerede er tilføjet til begge filer, og ordrer stadig ikke spores, tilføj også besøgs-tracking scriptet til Web Extras.

1. Gå til Settings > Website-Settings > Web Extras og find boksen Tracking.

2. Indsæt besøgs-tracking scriptet umiddelbart over Clerk.io order tracking-koden.

3. Klik på Save.

Brug kun denne placering, når opsætningen med standard tema-filer ikke sporer ordrer. Om det er nødvendigt, afhænger af det aktive Lightspeed-tema.

Synkroniser data #

Ved at synkronisere data forbinder du din Lightspeed-butik til Clerk, så Clerk kan få adgang til dine produkter, ordrer, kunder og andre butiksinformationer. Dette gør det muligt for Clerk at give personlige anbefalinger og søgeresultater baseret på dine faktiske butikdata. Følg trinnene i Sync Data guiden for at opsætte data-synkronisering.