Jtl

Get Started

Installieren Sie Clerk auf JTL, indem Sie diesen einfachen Schritten folgen

Bringen Sie Clerk in nur wenigen Schritten in Ihrem JTL-Shop zum Laufen. Diese Anleitung führt Sie durch das Verbinden Ihres Shops, die Konfiguration 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 einen persönlichen Überblick 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 eingeloggt haben, müssen Sie zunächst Ihren Shop hinzufügen:

Beispiel wie es aussehen sollte
  1. Geben Sie den Name und die Domain Ihres Webshops ein.

  2. Wählen Sie JTL als Plattform und wählen Sie Ihre Währung.

  3. Klicken Sie auf Add Store.

  4. Sobald der Shop erstellt ist, wird eine E-Mail über Ihre Public und Private Keys an den Inhaber der Kontoinhaber-Email gesendet.

Verbindung konfigurieren #

Wählen Sie im Hauptmenü der Setup-Anleitung Install Extension:

Install extension page

Auf der nächsten Seite sehen Sie, was zu tun ist, um die JTL-Verbindung zu konfigurieren.

Gehen Sie zu Ihrem Clerk-Plugin im JTL-Backend und fügen Sie die Public und Private Keys aus dem Clerk Shop in die entsprechenden Felder ein.

Shop synchronisieren #

Nachdem Sie den Zugriff erlaubt haben, müssen Sie nur noch Ihren Shop synchronisieren.

Gehen Sie zurück zur Setup-Anleitung und klicken Sie auf Sync Your Data:

Sync your data page

Geben Sie die Details Ihres Shops ein und klicken Sie auf Start Sync.

Die JTL-Feed-URL sollte anhand dieser Anleitung erstellt werden: Erstellung von Datenfeeds 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 die folgenden Schritte:

Einen Store hinzufügen #

Jeder Store in Clerk ist eine isolierte Umgebung mit eigenen Daten, API-Schlüsseln und Dashboard.

Das erste, was Sie bei der Einrichtung Ihres Clerk-Kontos tun müssen, ist, Ihren ersten Store zu erstellen:

Wie der Store-Erstellungsbildschirm aussieht

Danach führt Sie die Setup-Anleitung durch den weiteren Setup-Prozess.

Beachten Sie, dass bei jeder Erstellung eines Shops eine E-Mail mit Public und Private Keys an den Inhaber des Firmenkontos gesendet wird. Dies wird verwendet, um einen sicheren Zugang zwischen Clerk und JTL herzustellen.

Tracking-Skripte installieren #

Mit dem S360 Clerk-Plugin können Sie sowohl das Besucher- als auch das Bestelltracking aktivieren. Die Skripte werden in Teile des Webshops eingebunden:

  • Das Visitor Tracking Script, das Clerk initialisiert. Dieses muss im Header des Webshops eingebunden werden.

  • Das Order Tracking Script, das das Tracking von Bestellungen in Echtzeit ermöglicht. Dies wird normalerweise auf der Bestellbestätigungsseite installiert.

Sie können diese im JTL-Plugin unter dem Abschnitt ALLGEMEIN aktivieren:

Im Clerk-Plugin, wenn Sie etwas nach unten scrollen

Wenn beide Skripte eingefügt wurden, wird Clerk initialisiert.

Ihren Shop synchronisieren #

Damit Ergebnisse angezeigt werden, muss Clerk mit Produkten, Kategorien, Verkäufen, Seiten und Kunden aus JTL über einen generierten Datenfeed synchronisiert werden.

Dies geschieht durch das Einrichten eines Datenfeeds, der den regelmäßigen Zugriff auf die Daten ermöglicht.

Dies wird in dieser Anleitung Erstellung von Datenfeeds in JTL weiter erläutert.

Wenn der Datenfeed generiert und in Ihre Data Sync-Einstellungen unter Systemstatus im Backend von my.clerk.io hinzugefügt wurde.

Search und Recommendations hinzufügen #

Frontend-Elemente in Clerk bestehen aus zwei Teilen:

  • Einem Design, das die visuelle Präsentation der Produkte steuert. Dies kann an Ihr gewünschtes Styling angepasst oder Sie können eines unserer Standarddesigns verwenden Template Design to use in Clerk.

  • Meistens werden Sie 3 Designs verwenden: Eins für Instant Search, die Suchseite und Recommendations.

Beispiel eines Recommendation-Sliders mit unserem Design-Editor
  • Einem Element mit einem angehängten Embedcode, das die Produkte anzeigt. Jedes Element hat einen spezifischen Namen in seinem Embedcode, den Sie im jeweiligen Feld unter Clerk TemplateName eintragen möchten. Dies wird zur Kommunikation zwischen Ihrem Webshop und dem jeweiligen Clerk-Element verwendet.

Die Setup-Anleitung zeigt Ihnen, wo jedes Element in den meisten JTL-Setups platziert werden muss.

Am Ende Ihres Setups sollten die Einstellungen im Plugin wie folgt aussehen. Die folgenden Abbildungen dienen nur zu Demonstrationszwecken.

Credentials
OptionBedeutung
API KeyIhr von Clerk bereitgestellter API Key
Private KeyIhr Legacy Private API Key von Clerk. Erforderlich, um den Zugriff auf den Datenfeed einzuschränken.
LanguageSprache des Datenfeeds
customer groupPreise für die Kundengruppe
CurrencyWährung im Datenfeed
Faceted designDesign der Facetten
Tracking und Sucheinstellungen
KomponenteOptionBedeutung
AllgemeinCookieloses Tracking verwendenTracking ohne Verwendung von Cookies
Warenkorb-Tracking verwenden?Informiert Clerk über Änderungen im Warenkorb (allgemeines Warenkorbtracking)
E-Mails anonymisierenE-Mail-Adressen werden anonymisiert (als Hash) an Clerk übertragen.
Live Suche (Header)Live Suche aktivieren?Wenn deaktiviert, wird die Clerk Live Search im Frontend nicht angezeigt.
Selektor LivesearchLive Search Selektor unabhängig von Clerk
Clerk TemplateName LivesucheTemplate für die Live Search (Clerk Backend → Search → Elements → Live Search → In Webseite einfügen → Im Code Wert von “data-template="@WERT’”)
Anzahl der Suchvorschläge in der Live SucheAnzahl der anzuzeigenden Suchvorschläge
Anzahl der KategorievorschlägeAnzahl der anzuzeigenden Kategorievorschläge
Anzahl der SeitenvorschlägeAnzahl der anzuzeigenden Seitenvorschläge
PositionPosition des Suchergebnisses im Verhältnis zum Selektor
Search (Ergebnisseite)Ergebnisseite aktivieren?Wenn deaktiviert, wird die Clerk-Ergebnisseite im Frontend nicht angezeigt.
Clerk TemplateName SearchTemplate für die Live Search (Clerk Backend → Search → Elements → Search → In Webseite einfügen → Im Code Wert von “data-template="@WERT’”)
Position FacettenPosition der Facetten
Facetten in URL anzeigenFacetten in URL anzeigen
Clerk Facets AttributeKommagetrennte Liste verfügbarer Facetten (JTL Merkmale)
Clerk Facets Attributes Multiple ValuesKommagetrennte Liste verfügbarer Facetten mit mehreren Werten (JTL Merkmale für ODER-Filterung)
Data feed und Recommendation Einstellungen
KomponenteOptionBedeutung
Data FeedCron-VerarbeitungWie der Cron zum Generieren des Datenfeeds getriggert wird (siehe Abschnitt Möglichkeiten der Datenfeed-Erstellung)
Batch SizeBatchgröße der Feed-Produkte (siehe Abschnitt Batchgröße)
ProduktseiteProduktseitenslider aktivieren?Wenn deaktiviert, wird der Slider auf der Produktseite im Frontend nicht angezeigt.
Artikel Selektor SliderSelektor für den Artikelslider unabhängig von Clerk
Clerk TemplateName ArticleNamen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden.
Slider Einfüge-MethodeWie der Slider dem Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Duplikate filternVerhindert, dass nachfolgende Slider Produkte von vorherigen Slidern enthalten (Standard: Ja)
WarenkorbseiteWarenkorbslider aktivieren?Wenn deaktiviert, wird der Slider auf der Warenkorbseite im Frontend nicht angezeigt.
Warenkorb Selektor SliderSelektor für den Warenkorbslider unabhängig von Clerk
Clerk TemplateName Shopping CartNamen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden.
Slider Einfüge-MethodeWie der Slider dem Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Duplikate filternVerhindert, dass nachfolgende Slider Produkte von vorherigen Slidern enthalten (Standard: Ja)
PowerstepPowerstep-Slider aktivieren?Wenn deaktiviert, wird der Slider im Powerstep nicht im Frontend angezeigt.
Powerstep SelektorSelektor für den Powerstep-Slider unabhängig von Clerk
Clerk TemplateName PowerstepNamen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden.
Powerstep Einfüge-MethodeWie der Slider dem Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Duplikate filternVerhindert, dass nachfolgende Slider Produkte von vorherigen Slidern enthalten (Standard: Ja)
Kategorie- und Exit-Intent-Einstellungen
KomponenteOptionBedeutung
KategorieseiteKategorie-Seiten-Slider aktivieren?Ist dies deaktiviert, wird der Slider auf der Kategorieseite nicht im Frontend angezeigt.
Kategorie Selektor SliderSelektor für den Kategorieslider unabhängig von Clerk
Clerk TemplateName Shopping CartNamen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden.
Slider Einfüge-MethodeWie der Slider dem Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Duplikate filternVerhindert, dass nachfolgende Slider Produkte von vorherigen Slidern enthalten (Standard: Ja)
Exit IntentExit Intent Slider aktivieren?Wenn deaktiviert, wird der Exit Intent nicht im Frontend angezeigt.
Clerk TemplateName Exit IntentTemplate für den Exit Intent

Mehrere Domains #

Der einfachste Weg, Clerk in mehreren Domains in Standard-Setups zu implementieren, besteht darin, für jede Domain einen separaten Store in my.clerk.io zu erstellen und diese dann jeweils mit Ihrer JTL-Sprachdomain zu synchronisieren.

So können Sie Produkte, Verkäufe, Währungen usw. getrennt halten und jeder Domain zuordnen.

  1. Erstellen Sie zunächst Ihren Haupt-Store und folgen Sie der Setup-Anleitung, um Ihren Store mit Clerk zu verbinden, und wählen Sie die Recommendations und/oder Search Results, die Sie in Ihrem Webshop anzeigen möchten.

  2. Nachdem Sie das erste Setup abgeschlossen haben, kehren Sie zur Startseite von my.clerk.io zurück (klicken Sie auf das Clerk-Logo in der oberen linken Ecke des Seitenmenüs) und klicken Sie auf "+ Add new store" als letzten Punkt in der Dropdown-Liste (meistens unter dem/den bestehenden Store(s) und Ihrem Firmennamen):

Add new store dropdown
  1. Auf der Seite Add New Store klicken Sie auf Advanced, um alle Einstellungen zu sehen.
Advanced settings
  1. Tragen Sie die Details Ihrer Domain ein und wählen Sie Ihren Haupt-Store im Dropdown Copy Elements From Existing Store aus, dann klicken Sie auf Add Store. Dadurch werden die Elements und Designs aus Ihrem Haupt-Store übernommen.
Inhalt von vorhandenem Store kopieren
  1. Nun können Sie der Setup-Anleitung erneut folgen, um Clerk zu aktivieren, indem Sie auf Getting Started klicken, um Data Sync für die neue Domain durchzuführen.
Getting started page
  1. Dadurch können Sie Ihre Domain über die Setup-Anleitung mit Ihrem Store bei my.clerk.io synchronisieren.

  2. Wenn Data Sync abgeschlossen ist, ist Ihre Domain einsatzbereit und verwendet das gleiche Setup wie Ihr Haupt-Store.

  3. Wiederholen Sie diesen Vorgang für jede Ihrer JTL-Sprachdomains. Denken Sie daran, die Überschriften in Element-> Edit -> Select Design ebenfalls in die passende Sprache zu übersetzen.

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.