Get Started

Configura Clerk e rendilo operativo sul tuo store SmartWeb Classic in pochi passaggi. Questa guida ti accompagna nella connessione del negozio, nell’installazione degli script di tracciamento e nella sincronizzazione dei dati.

Collegare il tuo store #

Il primo passo per installare Clerk è collegare il tuo store al tuo account Clerk.

Dopo aver seguito questi semplici passaggi, potrai visualizzare il tuo Demo Store, che ti offre una panoramica personale su come Clerk funzionerà sul tuo webshop, prima di configurare il resto del sistema.

Aggiungi store #

Dopo aver effettuato il login su my.clerk.io, la prima cosa da fare è aggiungere il tuo store:

1. Inserisci il Nome e il Dominio del tuo webshop.

2. Scegli SmartWeb come Piattaforma e seleziona la tua Valuta.

3. Clicca su Add Store.

Installa il tracciamento dei visitatori #

1. Nel backend di SmartWeb Classic, vai su Kontrolpanel > Design Manager > Rediger design.

2. Clicca su Indsæt Javascript e incolla lo script di tracciamento visitatori Clerk. Poi clicca su Gem.

3. Assicurati che lo script sia inserito nell’header sotto <head>.

Utilizza INSERT_PUBLIC_API_KEY nello snippet qui sotto e sostituiscilo con la tua Public Key da 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>

Installa il tracciamento degli ordini #

1. In SmartWeb Classic, vai su Kontrolpanel > Design Manager > Rediger filer > Modules > Checkout.

2. Apri checkout-approved.tpl e aggiungi il codice di tracciamento delle vendite in fondo al file.

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

Sincronizza i dati #

La sincronizzazione dei dati collega il tuo store SmartWeb Classic a Clerk, permettendo a Clerk di accedere ai tuoi prodotti, ordini, clienti e altre informazioni dello store. Questo consente a Clerk di fornire raccomandazioni personalizzate e risultati di ricerca in base ai dati reali del tuo store. Segui i passaggi nella guida di sincronizzazione dati per configurare la sincronizzazione dei dati.

Aggiunta di Clerk.js #

1. Clicca sull’icona Impostazioni nel menu laterale del tuo store e successivamente su Tracking Code.

2. Copia lo Script di Tracciamento

3. Inserisci questo codice nel file che genera tutte le pagine.

   Normalmente si trova in Kontrolpanel->Design Manager-> Rediger filer->index.tpl

4. Clicca su Gem in alto nella pagina per salvare le modifiche.

Tracciamento ordini #

1. Nell’Admin di SmartWeb Classic vai su Modules → Checkout → checkout-approved.tpl

2. Inserisci il seguente codice Sales-Tracking in fondo al file, subito prima del tag di chiusura </div>.

   {% 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. Clicca su Gem per salvare le modifiche.

Siti multipli #

Clerk può essere facilmente integrato in diversi Siti che condividono lo stesso backend SmartWeb Classic / Hostedshop.

Il modo più semplice per implementare Clerk in più Siti in configurazioni standard è creare un Store separato per ogni Sito su my.clerk.io.

In questo modo puoi separare prodotti, vendite, valute ecc. per tenere traccia di ogni Sito.

1. Inizia creando il tuo Store principale e segui la Guida di Configurazione per collegare il tuo Store a Clerk e scegliere i Recommendations e/o i Search Results che vuoi visualizzare sul tuo webshop.

2. Quando hai terminato la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (cliccando sul logo Clerk nell’angolo in alto a sinistra del menu laterale) e poi clicca su "+ Add new store" nell’ultima opzione della lista a discesa (in genere sotto lo/gli store esistente/i e il nome della tua azienda):

3. Nella pagina Add New Store, clicca su Advanced per visualizzare tutte le impostazioni.

4. Compila i dettagli del tuo webshop e scegli il tuo Store principale dal menu a tendina Copy Elements From Existing Store, poi clicca su Add Store.

Questo trasferirà gli Elements e i Designs dal tuo Store principale.

5. Ora puoi seguire di nuovo la Guida di Configurazione, per attivare Clerk cliccando su Getting Started, per Sync Data per il nuovo sito.

6. Nel backend di SmartWeb Classic, passa al Sito che desideri configurare.

7. Questo ti permetterà di attivare Clerk sul Sito tramite la Guida di Configurazione su my.clerk.io.

8. Quando la Data Sync è terminata, il tuo Sito è pronto e utilizza la stessa configurazione del tuo Store principale.

Ricordati di tradurre le Intestazioni, in Element-> Edit -> Select Design anche nella lingua corretta.

Puoi seguire questo processo per tutti i siti su cui desideri utilizzare Clerk.