Get Started
Bringen Sie Clerk in nur wenigen Schritten auf Ihrem JTL-Shop zum Laufen. Diese Anleitung führt Sie durch das Verbinden Ihres Shops, das Konfigurieren des Plugins und das Synchronisieren Ihrer Daten.
Ihren Shop verbinden #
Der erste Schritt bei der Installation von Clerk ist das Verbinden Ihres Shops mit Ihrem Clerk-Konto.
Nachdem Sie diese einfachen Schritte befolgt haben, können Sie Ihren Demo Store sehen, der Ihnen eine persönliche Übersicht darüber gibt, wie Clerk in Ihrem Webshop funktionieren wird, bevor Sie den Rest des Systems einrichten.
Shop hinzufügen #
Nachdem Sie sich bei my.clerk.io angemeldet haben, müssen Sie als Erstes Ihren Shop hinzufügen:

Geben Sie den Name und die Domain Ihres Webshops ein.
Wählen Sie JTL als Plattform und Ihre Währung aus.
Klicken Sie auf Add Store.
Sobald der Shop erstellt wurde, erhält der Inhaber der Konten-Email eine E-Mail zu Ihren öffentlichen und privaten Schlüsseln.
Verbindung konfigurieren #
Im Hauptmenü des Setup Guide klicken Sie auf Install Extension:

Die nächste Seite zeigt, was Sie tun müssen, um die JTL-Verbindung zu konfigurieren.
Gehen Sie in Ihr Clerk-Plugin im JTL-Backend und fügen Sie die öffentlichen und privaten Schlüssel aus dem Clerk Store in die jeweiligen Felder ein.
Shop synchronisieren #
Nachdem Sie den Zugriff erlaubt haben, müssen Sie Ihren Shop einfach synchronisieren.
Gehen Sie zurück zum Setup Guide und klicken Sie auf Sync Your Data:

Tragen Sie die Details Ihres Shops ein und klicken Sie Start Sync.
Die JTL-Feed-URL sollte auf Grundlage dieser Anleitung erstellt werden: Creation of Data Feeds in JTL.
Vollständiges Installationsbeispiel #
WICHTIG: Sie sollten das Plugin (S360 CLerk) in Ihrem JTL-Backend unter Plugins installiert haben
Diese Dokumentation führt Sie durch folgende Schritte:
Shop hinzufügen #
Jeder Store in Clerk ist eine isolierte Umgebung mit eigenen Daten, API-Schlüsseln und Dashboard.
Das Erste, was Sie beim Einrichten Ihres Clerk-Kontos tun müssen, ist, Ihren ersten Store zu erstellen:
Danach führt Sie der Setup Guide durch den restlichen Einrichtungsprozess.
Beachten Sie, dass jedes Mal, wenn ein Store erstellt wird, eine E-Mail mit öffentlichen und privaten Schlüsseln an den Inhaber des Firmenkontos gesendet wird. Dies wird verwendet, um einen sicheren Zugriff zwischen Clerk und JTL zu ermöglichen.
Tracking-Skripte installieren #
Mit dem S360 Clerk-Plugin können Sie sowohl Besucher- als auch Bestelltracking-Skripte aktivieren, die in Teile des Webshops eingefügt werden:
Das Besucher-Tracking-Skript, das Clerk initialisiert. Dieses muss im Header des Webshops eingefügt werden.
Das Bestell-Tracking-Skript, mit dem Bestellungen in Echtzeit verfolgt werden können. Dieses wird üblicherweise auf der Bestellbestätigungsseite installiert.
Sie können diese im JTL-Plugin unter dem Abschnitt ALLGEMEIN aktivieren:
Wenn beide Skripte eingefügt wurden, ist Clerk initialisiert.
Ihren Shop synchronisieren #
Um Ergebnisse anzuzeigen, muss Clerk mit den Produkten, Kategorien, Verkäufen, Seiten und Kunden von JTL in einem generierten Datenfeed synchronisiert werden.
Dies geschieht durch das Einrichten eines Datenfeeds, der es ermöglicht, regelmäßig auf die Daten zuzugreifen.
Das wird ausführlich in dieser Anleitung erklärt: Creation of Data Feeds in JTL.
Wenn der Datenfeed generiert und in Ihre Data-Sync-Einstellungen unter Systemstatus im my.clerk.io Backend hinzugefügt wurde.
Search und Recommendations hinzufügen #
Frontend-Elemente in Clerk bestehen aus zwei Teilen:
Einem Design, das die visuelle Darstellung der Produkte steuert. Dieses kann an Ihr gewünschtes Styling angepasst werden, oder Sie können eines unserer Standard-Design-Templates verwenden Template Design to use in Clerk.
In der Regel verwenden Sie 3 Designs: Eines für Instant Search, die Suchseite und Recommendations.

- Ein Element mit einem angehängten Embedcode, das die Produkte anzeigt. Jedes Element hat einen spezifischen Namen in seinem Embedcode, den Sie in das entsprechende Feld “Clerk TemplateName” eintragen möchten. Dies dient zur Kommunikation zwischen Ihrem Webshop und dem jeweiligen Clerk-Element.
Der Setup Guide führt Sie durch die Platzierung der Elemente, wie sie in den meisten JTL-Installationen notwendig sind.
Am Ende Ihrer Einrichtung sollten die Einstellungen im Plugin wie folgt aussehen. Die folgenden Bilder dienen nur zur Veranschaulichung.

| Option | Bedeutung |
|---|---|
| API Key | Ihr von Clerk erhaltener API-Schlüssel |
| Private Key | Ihr Legacy Private API-Schlüssel von Clerk. Erforderlich, um den Zugriff auf den Datenfeed zu beschränken. |
| Language | Sprache des Datenfeeds |
| customer group | Preise für die Kundengruppe |
| Currency | Währung im Datenfeed |
| Faceted design | Design der Facetten |

| Komponente | Option | Bedeutung |
|---|---|---|
| Allgemein | Benutze cookieloses Tracking | Tracking ohne Cookies |
| Warenkorbtracking nutzen? | Informiert Clerk über Änderungen am Warenkorb (allgemeines Tracking des Warenkorbs) | |
| E-Mails anonymisieren | E-Mail-Adressen werden anonym (als Hash) an Clerk übermittelt. | |
| Live Suche (Header) | Live Suche aktivieren? | Wenn deaktiviert, wird die Clerk Live Suche nicht im Frontend angezeigt. |
| Selector Live Suche | Live Suche Selektor unabhängig von Clerk | |
| Clerk TemplateName Livesuche | Template für die Live Suche (Clerk Backend → Search → Elements → Live Suche → In Webseite einfügen → Im Code Wert aus “data-template=’@WERT’”) | |
| Anzahl Suchvorschläge in der Live Suche | Anzahl der anzuzeigenden Suchvorschläge | |
| Anzahl Kategorievorschläge | Anzahl der anzuzeigenden Kategorievorschläge | |
| Anzahl Seitvorschläge | Anzahl der anzuzeigenden Seitvorschläge | |
| Position | Position des Live Suche Ergebnisses in Bezug auf den Selektor | |
| Search (Ergebnisseite) | Ergebnisseite aktivieren? | Wenn deaktiviert, wird die Clerk Ergebnisseite nicht im Frontend angezeigt. |
| Clerk TemplateName Search | Template für Live Suche (Clerk Backend → Search → Elements → Search → In Webseite einfügen → Im Code Wert aus “data-template=’@WERT’”) | |
| Position Facetten | Position der Facetten | |
| Zeige Facetten in URL | Facetten in der URL anzeigen | |
| Clerk Facets Attribute | Kommagetrennte Liste verfügbarer Facetten (JTL Merkmale) | |
| Clerk Facets Attributes Multiple Values | Kommagetrennte Liste verfügbarer Facetten mit Mehrfachwerten (JTL Merkmale für ODER-Filterung) |

| Komponente | Option | Bedeutung |
|---|---|---|
| Data Feed | Cron-Verarbeitung | Wie der Cron für die Generierung des Datenfeeds ausgelöst werden soll (näher erläutert im Abschnitt Möglichkeiten der Datenfeed-Erstellung) |
| Batch-Größe | Batch-Größe der Produkte des Feeds (näher erläutert im Abschnitt Batch-Größe) | |
| Produktseite | Produktseiten-Slider aktivieren? | Wenn deaktiviert, wird der Slider auf der Produktseite nicht im Frontend angezeigt. |
| Artikel Selektor Slider | Selektor für den Artikelslider unabhängig von Clerk | |
| Clerk TemplateName Article | Namen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden. | |
| Slider Insert method | Wie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith) | |
| Doppelte filtern | Verhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja) | |
| Warenkorbseite | Warenkorb-Slider aktivieren? | Wenn deaktiviert, wird der Slider auf der Warenkorbseite nicht im Frontend angezeigt. |
| Warenkorb Selektor Slider | Selektor für den Warenkorb-Slider unabhängig von Clerk | |
| Clerk TemplateName Shopping Cart | Namen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden. | |
| Slider Insert method | Wie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith) | |
| Doppelte filtern | Verhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja) | |
| Powerstep | Powerstep-Slider aktivieren? | Wenn deaktiviert, wird der Slider im Powerstep nicht im Frontend angezeigt. |
| Powerstep Selektor | Selektor für den Powerstep-Slider unabhängig von Clerk | |
| Clerk TemplateName Powerstep | Namen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden. | |
| Powerstep Einfügemethode | Wie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith) | |
| Doppelte filtern | Verhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja) |

| Komponente | Option | Bedeutung |
|---|---|---|
| Kategorieseite | Kategorieseiten-Slider aktivieren? | Wenn deaktiviert, wird der Slider auf der Kategorieseite nicht im Frontend angezeigt. |
| Kategorie Selektor Slider | Selektor für den Kategorieslider unabhängig von Clerk | |
| Clerk TemplateName Shopping Cart | Namen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden. | |
| Slider Insert method | Wie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith) | |
| Doppelte filtern | Verhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja) | |
| Exit Intent | Exit Intent-Slider aktivieren? | Wenn deaktiviert, wird der Exit Intent nicht im Frontend angezeigt. |
| Clerk TemplateName Exit Intent | Template für den Exit Intent |
Mehrere Domains #
Der einfachste Weg, Clerk in mehreren Domains bei Standard-Setups zu verwenden, besteht darin, für jede Domain einen separaten Store in my.clerk.io anzulegen und sie dann mit jeder Ihrer JTL-Sprachdomains zu synchronisieren.
So können Sie Produkte, Verkäufe, Währungen usw. pro Domain getrennt erfassen.
Beginnen Sie mit der Erstellung Ihres Haupt-Stores und folgen Sie dem Setup Guide zum Verbinden Ihres Stores mit Clerk, und wählen Sie die Recommendations und/oder Search Results, die Sie auf Ihrem Webshop anzeigen möchten.
Nach Abschluss der Grundeinrichtung gehen Sie zurück zur Startseite von my.clerk.io (durch Klicken auf das Clerk-Logo in der oberen linken Ecke des Seitenmenüs) und dann auf "+ Add new store" als letzte Option in der Auswahlliste (normalerweise unter dem/den bestehenden Store(s) und Ihrem Firmennamen):

- Auf der Add New Store-Seite klicken Sie auf Advanced, um alle Einstellungen zu sehen.

- Tragen Sie die Details Ihrer Domain ein, wählen Sie Ihren Haupt-Store aus dem Dropdown Copy Elements From Existing Store und klicken Sie dann auf Add Store. Dadurch werden die Elements und Designs von Ihrem Haupt-Store übernommen.

- Jetzt können Sie den Setup Guide erneut aufrufen, um Clerk zu aktivieren, indem Sie auf Getting Started klicken, um Sync Data für die neue Domain zu starten.

Damit können Sie Ihre Domain mit Ihrem Store bei my.clerk.io über den Setup Guide synchronisieren.
Sobald Data Sync abgeschlossen ist, ist Ihre Domain einsatzbereit und verwendet dieselbe Konfiguration wie Ihr Haupt-Store.
Wiederholen Sie diesen Vorgang für jede Ihrer JTL-Sprachdomains. Denken Sie daran, Headlines in Element-> Edit -> Select Design ebenfalls in die richtige Sprache zu übersetzen.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.