Get Started

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

Tilslutning af din butik #

Det første trin i installationen af Clerk er at forbinde din butik med din Clerk konto.

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

Tilføj butik #

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

1. Skriv Navn og Domæne på din webshop.

2. Vælg SmartWeb som Platform og vælg din Valuta.

3. Klik på Add Store.

Installer besøgs-tracking #

1. I din SmartWeb Classic backend, gå til Kontrolpanel > Design Manager > Rediger design.

2. Klik på Indsæt Javascript og indsæt Clerk besøgs-tracking scriptet. Klik derefter Gem.

3. Sørg for at scriptet indsættes i headeren under <head>.

Brug INSERT_PUBLIC_API_KEY i nedenstående snippet og erstat det med din Public Key fra my.clerk.io > Developers > API Keys.

<!-- Clerk.io Visitor Tracking (SmartWeb Classic) -->
<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' });
</script>

Installer ordresporing #

1. I SmartWeb Classic, gå til Kontrolpanel > Design Manager > Rediger filer > Modules > Checkout.

2. Åbn checkout-approved.tpl og tilføj sales tracking-koden nederst i filen.

<span
  class="clerk"
  data-api="log/sale"
  data-sale="{$page.orderId}"
  data-email="{$orderCustomer->Email}"
  data-customer="{$user->Id}"
  data-products='[{$products}]'>
</span>

Synkroniser data #

Synkronisering af data forbinder din SmartWeb Classic butik til Clerk, som gør det muligt for Clerk at tilgå dine produkter, ordrer, kunder og anden butiksinformation. Dette gør det muligt for Clerk at levere personlige anbefalinger og søgeresultater baseret på dine faktiske butiksdata. Følg trin-for-trin-vejledningen i Sync Data guide for at opsætte datasync.

Tilføj Clerk.js #

1. Klik på Indstillinger-ikonet i sidemenuen på din butik og derefter på Tracking Code.

2. Kopiér Tracking Scriptet

3. Indsæt denne kode i filen, der genererer alle sider.

   Dette er normalt Kontrolpanel->Design Manager-> Rediger filer->index.tpl

4. Klik Gem øverst på siden for at gemme dine ændringer.

Tracking af ordrer #

1. I SmartWeb Classic Admin, gå til Modules → Checkout → checkout-approved.tpl

2. Indsæt følgende Sales-Tracking kode nederst i filen, lige før den afsluttende </div> tag.

   {% raw %}{if !empty($page.orderId)}
    {entity controller=order assign=order id=$page.orderId userId=false statusId=false}

    {* Order Customer entity *}
    {entity controller=orderCustomer assign=orderCustomer orderId=$page.orderId}

    {* Order Lines collection *}
    {collection controller=orderLine assign=orderLines orderId=$page.orderId repay=false}

    {* Group order collection by class *}
    {$orderList = $orderLines->groupByClass()}

    {assign var=products value=''}

    {if $orderLines->getActualSize() gt 0}
        {if isset($orderList['CollectionOrderLine'])}
            {foreach $orderList.CollectionOrderLine as $orderLine}
                {$products = $products|cat:{ldelim}|cat:' "id": '|cat:$orderLine->ProductId|cat:', "quantity": '|cat:$orderLine->Amount|cat:', "price": '|cat:$orderLine->Price|cat:{rdelim}}

                {if !$orderLine@last}
                    {$products = $products|cat:', '}
                {/if}
            {/foreach}
        {/if}
    {/if}

    <span
        class="clerk"
        data-api="log/sale"
        data-sale="{$page.orderId}"
        data-email="{$orderCustomer->Email}"
        data-customer="{$user->Id}"
        data-products='[{$products}]'>
    </span>
   {/if}{% endraw %}

3. Klik på Gem for at gemme dine ændringer.

Flere sites #

Clerk kan nemt integreres på flere Sites, der deler samme SmartWeb Classic / Hostedshop backend.

Den nemmeste måde at implementere Clerk på tværs af flere Sites i standard opsætninger er ved at oprette en separat Store for hver Site i my.clerk.io.

På denne måde kan du adskille produkter, salg, valuta osv. for at holde styr på hver Site.

1. Start med at oprette din hoved Store og følg Setup Guide for at forbinde din Store til Clerk og vælge de Recommendations og/eller Search Results du ønsker at vise på din webshop.

2. Når du er færdig med den indledende opsætning, gå tilbage til startsiden for my.clerk.io (ved at klikke på Clerk logoet i øverste venstre hjørne af side-menuen) og klik derefter "+ Add new store" som sidste punkt på listen (typisk under den eksisterende store(s) og dit firmanavn):

3. På Add New Store siden, klik på Advanced for at se alle indstillinger.

4. Udfyld detaljerne for din webshop og vælg din hoved Store fra dropdown-menuen Copy Elements From Existing Store, så klik på Add Store.

Dette vil overføre Elements og Designs fra din hoved Store.

5. Nu kan du følge Setup Guide igen, for at aktivere Clerk ved at klikke på Getting Started, for at Synkronisere Data for det nye site.

6. I din SmartWeb Classic backend, skift til det Site du ønsker at opsætte.

7. Dette giver dig mulighed for at aktivere Clerk på det pågældende Site via Setup Guide på my.clerk.io.

8. Når Data Sync er gennemført, er dit Site klar og bruger samme opsætning som din hoved Store.

Husk at oversætte Overskrifter i Element-> Edit -> Select Design til det rigtige sprog.

Du kan følge denne proces for alle sites, du ønsker at bruge Clerk med.