FAQ

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

Prezzi dei gruppi clienti #

La configurazione dei prezzi dei gruppi 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.

Eseguire 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 ogni prodotto e verranno utilizzate quando il prodotto viene visualizzato sul sito web.

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

Fornire il contesto di prezzo #

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

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

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

Attributi HTML #

Ecco alcuni esempi di come questo codice apparirebbe 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 questo potrebbe apparire 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, puoi utilizzare le variabili disponibili 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 cliente 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>

Utilizzo dei formatter #

Clerk.js ti permette di scrivere funzioni personalizzate JavaScript 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 tracciamento che viene inserito su tutte le pagine, dove più formatter possono essere aggiunti contemporaneamente.

Esempio di formatter #

Un esempio può essere visto qui sotto. Nota che questa è Clerk V2 (ultima versione):

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

Più formatter #

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

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

Uso nei design #

Dopo aver creato i tuoi formatter, puoi usarli nei Designs usando questa sintassi:

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