FAQ

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

Verwendung von Formatierern #

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

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

• Über my.clerk.io > Developers > Formatters, wo jeder Formatierer 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 gleichzeitig hinzugefügt werden können.

Beispiel-Formatierer #

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

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

Mehrere Formatierer #

Sie können beliebig viele Formatierer schreiben, getrennt durch Kommas, 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 ein Formatierer erstellt wurde, rufen Sie ihn aus dem Liquid-Template Ihres Designs mit dem Namen des Formatierers auf.

So können Sie jede gewünschte Funktionalität in Ihren Designs 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 zwei 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.

Vollständige Synchronisation ausführen #

Beim Ausführen 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 angeben #

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 oder dessen E-Mail-Adresse oder Kunden-ID angeben.

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

HTML-Attribute #

Hier sind einige Beispiele, wie dieser Code aussehen würde, wenn er im Ankerelement 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 dies als Teil des Clerk('config', ...)-Aufrufs aussieht:

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

Der obige Ansatz 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, sollten Sie die in Ihrem Stencil-Theme bereitgestellten Variablen verwenden, anstatt die Eingabe auf eine bestimmte E-Mail-Adresse oder Benutzer-ID zu festzulegen.

Informationen dazu, wie Sie die verschiedenen Kundendaten 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>