Jtl

Get Started

Installiere Clerk auf JTL, indem du diese einfachen Schritte befolgst

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:

Example of how it should look
  1. Geben Sie den Name und die Domain Ihres Webshops ein.

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

  3. Klicken Sie auf Add Store.

  4. 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:

Install extension page

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:

Sync your data page

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:

How the store creation screen looks

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:

Inside the clerk plugin if you scroll a bit down

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.

Example of a recommendation slider using our design editor
  • 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.

Credentials
OptionBedeutung
API KeyIhr von Clerk erhaltener API-Schlüssel
Private KeyIhr Legacy Private API-Schlüssel von Clerk. Erforderlich, um den Zugriff auf den Datenfeed zu beschränken.
LanguageSprache des Datenfeeds
customer groupPreise für die Kundengruppe
CurrencyWährung im Datenfeed
Faceted designDesign der Facetten
Tracking and Search settings
KomponenteOptionBedeutung
AllgemeinBenutze cookieloses TrackingTracking ohne Cookies
Warenkorbtracking nutzen?Informiert Clerk über Änderungen am Warenkorb (allgemeines Tracking des Warenkorbs)
E-Mails anonymisierenE-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 SucheLive Suche Selektor unabhängig von Clerk
Clerk TemplateName LivesucheTemplate 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 SucheAnzahl der anzuzeigenden Suchvorschläge
Anzahl KategorievorschlägeAnzahl der anzuzeigenden Kategorievorschläge
Anzahl SeitvorschlägeAnzahl der anzuzeigenden Seitvorschläge
PositionPosition 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 SearchTemplate für Live Suche (Clerk Backend → Search → Elements → Search → In Webseite einfügen → Im Code Wert aus “data-template=’@WERT’”)
Position FacettenPosition der Facetten
Zeige Facetten in URLFacetten in der URL anzeigen
Clerk Facets AttributeKommagetrennte Liste verfügbarer Facetten (JTL Merkmale)
Clerk Facets Attributes Multiple ValuesKommagetrennte Liste verfügbarer Facetten mit Mehrfachwerten (JTL Merkmale für ODER-Filterung)
Data feed and Recommendation settings
KomponenteOptionBedeutung
Data FeedCron-VerarbeitungWie 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ößeBatch-Größe der Produkte des Feeds (näher erläutert im Abschnitt Batch-Größe)
ProduktseiteProduktseiten-Slider aktivieren?Wenn deaktiviert, wird der Slider auf der Produktseite nicht im Frontend 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 Insert methodWie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Doppelte filternVerhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja)
WarenkorbseiteWarenkorb-Slider aktivieren?Wenn deaktiviert, wird der Slider auf der Warenkorbseite nicht im Frontend angezeigt.
Warenkorb Selektor SliderSelektor für den Warenkorb-Slider unabhängig von Clerk
Clerk TemplateName Shopping CartNamen der auszugebenden Slider-Templates. Mehrere Template-Namen können kommagetrennt angegeben werden.
Slider Insert methodWie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Doppelte filternVerhindert, dass nachfolgende Slider Produkte aus 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ügemethodeWie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Doppelte filternVerhindert, dass nachfolgende Slider Produkte aus vorherigen Slidern enthalten (Standard: Ja)
Category and exit intent settings
KomponenteOptionBedeutung
KategorieseiteKategorieseiten-Slider aktivieren?Wenn 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 Insert methodWie der Slider zum Selektor hinzugefügt wird (After, Append, Before, Prepand, ReplaceWith)
Doppelte filternVerhindert, dass nachfolgende Slider Produkte aus 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 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.

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

  2. 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):

Add new store dropdown
  1. Auf der Add New Store-Seite klicken Sie auf Advanced, um alle Einstellungen zu sehen.
Advanced settings
  1. 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.
Copy content from existing store
  1. 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.
Getting started page
  1. Damit können Sie Ihre Domain mit Ihrem Store bei my.clerk.io über den Setup Guide synchronisieren.

  2. Sobald Data Sync abgeschlossen ist, ist Ihre Domain einsatzbereit und verwendet dieselbe Konfiguration wie Ihr Haupt-Store.

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