FAQ

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.

Esegui la 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 mostrato sul sito web.

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

Fornisci 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 oppure fornendo il suo indirizzo email o ID cliente.

Il contesto di prezzo può essere fornito sia negli attributi HTML per il tag anchor del contenuto stesso, sia 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 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 predefiniti 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, utilizzeresti le variabili rese disponibili dal tema Stencil, invece di inserire manualmente 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 di prezzo:

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

Utilizzo dei formatter #

Clerk.js ti consente 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 tracciamento che viene inserito in tutte le pagine, dove è possibile aggiungere formatter multipli contemporaneamente.

Esempio di formatter #

Un esempio può essere visto qui sotto. Tieni presente che si tratta di Clerk V2 (versione più recente):

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

Formatter multipli #

Puoi scrivere qualsiasi numero di formatter, separati da virgola, 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 designs #

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

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