FAQ

Probleme mit Ihrer BigCommerce-Integration? Diese FAQ behandelt die häufigsten Probleme und deren Lösungen, von Kundengruppenpreisen bis zu Formatierern.

Formatierer verwenden #

Clerk.js ermöglicht es Ihnen, eigene JavaScript-Funktionen zu schreiben, die Ihren Designs neue Funktionalität hinzufügen.

Formatierer können auf zwei Arten hinzugefügt werden:

• Über my.clerk.io > Developers > Formatters, wobei jeder Formatierer als eigener Eintrag erstellt werden kann.

• Als Konfiguration für Clerk.js, im tracking-script, das auf allen Seiten eingebunden wird, wobei mehrere Formatierer gleichzeitig hinzugefügt werden können.

Beispiel-Formatter #

Ein Beispiel ist unten zu sehen. Bitte beachten Sie, dass dies Clerk V2 (neueste Version) ist:

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

Mehrere Formatierer #

Sie können beliebig viele Formatierer schreiben, getrennt durch Kommata, wie folgt:

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

Verwendung in Designs #

Nachdem Sie Ihre Formatierer erstellt haben, können Sie diese in Designs mit folgender Syntax verwenden:

Dies ermöglicht es Ihnen, jede gewünschte Funktionalität in Ihren Designs zu erstellen, die Sie mit Clerk in Ihrem Webshop nutzen möchten.

Kundengruppenpreise (Legacy) #

Diese Funktion ist veraltet und kann nur verwendet werden, wenn sie bereits aktiviert ist. Sie funktioniert nicht mit Search 3.0 und wird in Zukunft nicht unterstützt.

Die Einrichtung von Kundengruppenpreisen besteht aus 2 Schritten:

1. Führen Sie eine vollständige Synchronisierung zwischen Clerk und BigCommerce durch.

2. Geben Sie beim Anzeigen des Inhalts auf der Seite einen Preiskontext an.

Volle Synchronisierung durchführen #

Bei der vollständigen Synchronisierung zwischen Clerk und BigCommerce speichert Clerk die verschiedenen Kundengruppenpreise und Preisregeln, die für den Shop aktiv sind.

Diese Regeln werden für jedes Produkt einzeln gespeichert und beim Anzeigen des Produkts auf der Website verwendet.

Diese Regeln werden ebenfalls nur aktualisiert, wenn eine vollständige Synchronisierung durchgeführt wird.

Preiskontext angeben #

Beim Anzeigen des Produkts auf der Website müssen Sie einen Preiskontext an Clerk übergeben.

Dies kann geschehen, indem Sie die Kundengruppen-ID des aktuellen Kunden oder dessen E-Mail-Adresse oder Kunden-ID angeben.

Der Preiskontext kann entweder in den HTML-Attributen für das Ankerelement des Inhalts selbst bereitgestellt werden oder als Teil des Aufrufs von Clerk('config', ...).

HTML-Attribute #

Hier sind einige Beispiele, wie dieser Code aussieht, wenn er direkt im Ankerelement angegeben wird:

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

Clerk-Konfiguration #

Hier ein Beispiel, wie dies aussieht, wenn es als Teil des Aufrufs von Clerk('config', ...) übergeben wird:

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

Die obige Methode kann mit anderen Standardwerten kombiniert werden, die beim Laden der Seite gesetzt werden:

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

Dynamische Einbindung #

Um diesen Inhalt dynamisch einzubinden, nutzen Sie die im Stencil-Theme verfügbaren Variablen, statt die Eingabe auf eine bestimmte E-Mail-Adresse oder Benutzer-ID fest zu codieren.

Wie Sie die verschiedenen Kundenvariablen im Theme ausgeben können, finden Sie hier:

Customer Object BigCommerce

Hier ein Beispiel, wie Sie das Kundenobjekt im Theme nutzen können, um den Preiskontext dynamisch zu setzen:

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