FAQ

Problemi con l’integrazione BigCommerce? Questa FAQ copre i problemi più comuni e le relative soluzioni, dai prezzi dei gruppi clienti ai formatter.

Utilizzo dei formatter #

Clerk.js permette di scrivere funzioni JavaScript personalizzate che aggiungono nuove funzionalità ai tuoi Designs.

I formatter possono essere aggiunti in due modi:

• Tramite my.clerk.io > Developers > Formatters, dove ogni Formatter può essere creato come voce separata.

• Come configurazione per Clerk.js, nello script di tracking che viene inserito su tutte le pagine, dove più formatter possono essere aggiunti contemporaneamente.

Esempio di formatter #

Un esempio può essere visto qui sotto. Si prega di notare che si tratta di Clerk V2 (ultima versione):

Clerk('config', {
  key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
  formatters: {
    log_price: function(price) {
      console.log(price);
    }
  }
});

Più formatter #

Puoi scrivere un numero qualsiasi di formatter, separati da virgola, come segue:

formatters: {
  log_price: function(price) {
    console.log(price);
  },
  calculate_discount: function(price, special_price) {
    return price - special_price;
  },
  substring: function(text) {
    var short_string = text.substring(0, 20);
    return short_string;
  }
}

Utilizzo nei design #

Dopo aver creato un formatter, chiamalo dal template Liquid del tuo Design usando il nome del formatter.

Questo ti permette di creare qualsiasi funzionalità nei tuoi Designs che desideri usare con Clerk nel tuo webshop.

Prezzi per gruppi di clienti (Legacy) #

Questa funzione è deprecata e può essere utilizzata solo se già attivata. Non funziona con Search 3.0 e non sarà supportata in futuro.

La configurazione dei prezzi per gruppi di clienti si compone di 2 passaggi:

1. Esegui una sincronizzazione completa tra Clerk e BigCommerce.

2. Fornisci un contesto di prezzo quando mostri il contenuto sulla pagina.

Esegui una sincronizzazione completa #

Quando esegui una sincronizzazione completa tra Clerk e BigCommerce, Clerk memorizzerà i diversi prezzi dei gruppi clienti e le regole di prezzo attive per il negozio.

Queste regole verranno memorizzate separatamente per ciascun prodotto e verranno utilizzate quando si mostra il prodotto sul sito.

Queste regole verranno aggiornate solo quando viene eseguita una sincronizzazione completa.

Fornire il contesto di prezzo #

Quando mostri il prodotto sul sito, devi fornire a Clerk un contesto di prezzo.

Questo può essere fatto fornendo l’ID del gruppo cliente dell’utente corrente o il suo indirizzo email o ID cliente.

Il contesto di prezzo può essere fornito sia negli attributi HTML del tag anchor del contenuto stesso, sia come parte della chiamata Clerk('config', ...).

Attributi HTML #

Ecco alcuni esempi di come apparirebbe questo codice se fornito direttamente nel tag anchor:

<span
  class="clerk"
  data-template="@content-1"
  data-price_context='{"customer":{"email": "support@clerk.io"}}'
></span>

<span
  class="clerk"
  data-template="@content-2"
  data-price_context='{"customer":{"id": 12345}}'
></span>

<span
  class="clerk"
  data-template="@content-3"
  data-price_context='{"qualifiers":{"customer_group_id": 0}}'
></span>

Configurazione Clerk #

Ecco un esempio di come apparirebbe se fornito come parte della chiamata Clerk('config', ...):

Clerk('config', {
  price_context: {
    customer: {
      email: "support@clerk.io"
    }
  }
})

Il metodo sopra può essere combinato con altri valori predefiniti impostati al caricamento della pagina:

Clerk('config', {
  key: 'YOUR_PUBLIC_KEY',
  language: 'english',
  price_context: {
    customer: {
      email: "support@clerk.io"
    }
  }
})

Inserimento dinamico #

Per inserire dinamicamente questo contenuto, è necessario utilizzare le variabili messe a disposizione dal tuo tema Stencil, invece di preimpostare l’input a un determinato indirizzo email o ID utente.

Puoi trovare come stampare le varie variabili del cliente nel tema qui sotto:

Customer Object BigCommerce

Ecco un esempio di come potresti usare l’oggetto cliente nel tuo tema per impostare dinamicamente il contesto del prezzo:

<span
  class="clerk"
  data-template="@content-1"
  data-price_context='{"customer":{"email": "{{ customer.email }}"} }'
></span>