FAQ

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

Kundengruppenpreise #

Die Einrichtung von Kundengruppenpreisen besteht aus 2 Schritten:

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

2. Stellen Sie einen Preiskontext bereit, wenn Sie den Inhalt auf der Seite anzeigen.

Vollständige Synchronisierung ausführen #

Bei der Durchführung einer 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 separat gespeichert und beim Anzeigen des Produkts auf der Website verwendet.

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

Preiskontext bereitstellen #

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

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

Der Preiskontext kann entweder in den HTML-Attributen des Inhalts selbst gesetzt werden oder als Teil des Clerk('config', ...)-Aufrufs bereitgestellt werden.

HTML-Attribute #

Hier sind einige Beispiele, wie dieser Code aussieht, wenn er im Ankertag selbst bereitgestellt 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 ist ein Beispiel, wie es aussieht, wenn es als Teil des Clerk('config', ...)-Aufrufs bereitgestellt wird:

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

Die obige Vorgehensweise kann mit anderen Standardwerten beim Laden der Seite kombiniert 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 in Ihrem Stencil-Theme verfügbaren Variablen, anstatt die Eingabe auf eine bestimmte E-Mail-Adresse oder Benutzer-ID festzuschreiben.

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

Customer Object BigCommerce

Hier ist ein Beispiel, wie Sie das Kundenobjekt in Ihrem Theme verwenden könnten, um den Preiskontext dynamisch zu setzen:

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

Verwendung von Formatierern #

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

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

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

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

Beispiel-Formatter #

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

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

Mehrere Formatter #

Sie können jede beliebige Anzahl von Formatierern schreiben, durch Kommas getrennt, 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 sie in Designs mit folgender Syntax verwenden:

Dies ermöglicht es Ihnen, jede gewünschte Funktionalität in Ihren Designs für die Verwendung mit Clerk in Ihrem Webshop zu erstellen.