FAQ

Riscontri problemi con la tua integrazione BigCommerce? Questa FAQ copre i problemi più comuni e le relative soluzioni, dai prezzi dei gruppi di clienti ai formatter.

Utilizzo dei formatter #

Clerk.js ti 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 tracking-script che viene inserito su tutte le pagine, dove possono essere aggiunti più formatter contemporaneamente.

Esempio di formatter #

Un esempio è visibile di seguito. Si prega di notare che si tratta di Clerk V2 (ultima versione):

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

Formatter multipli #

Puoi scrivere un numero qualsiasi di formatter separati da virgole, in questo modo:

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 i tuoi formatter, puoi utilizzarli nei Designs con questa sintassi:

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

Prezzi dei gruppi di clienti (Legacy) #

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

La configurazione dei prezzi dei gruppi di clienti consiste in 2 passaggi:

1. Esegui una sincronizzazione completa tra Clerk e BigCommerce.

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

Esegui sincronizzazione completa #

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

Queste regole verranno memorizzate separatamente per ogni prodotto e saranno utilizzate quando il prodotto viene visualizzato sul sito.

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

Fornire il contesto di prezzo #

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

Ciò 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 negli attributi HTML del tag anchor del contenuto stesso, oppure 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"
    }
  }
})

L’approccio sopra può essere combinato con altri valori di default impostati al caricamento della pagina:

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

Iniezione dinamica #

Per iniettare dinamicamente questo contenuto, utilizzerai le variabili messe a disposizione nel tuo tema Stencil, invece di inserire manualmente un indirizzo email o un ID utente specifico.

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

Customer Object BigCommerce

Ecco un esempio di come potresti utilizzare l’oggetto customer nel tuo tema per impostare dinamicamente il contesto di prezzo:

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