Get Started
Ihren Shop verbinden #
Der erste Schritt bei der Installation von Clerk.io ist, Ihren Shop mit Ihrem Clerk.io-Konto zu verbinden.
Das untenstehende Video zeigt Ihnen Schritt für Schritt, was zu tun ist. Verwenden Sie den Rest der Anleitung als Referenz :)
Nachdem Sie diese einfachen Schritte befolgt haben, können Sie Ihren Live Demo Store sehen, der Ihnen einen persönlichen Überblick darüber gibt, wie Clerk.io in Ihrem Webshop funktionieren wird. Kontaktieren Sie Ihre Clerk.io-Ansprechperson, um die Live-Demo zu sehen.
1. Shop hinzufügen #
Melden Sie sich bei my.clerk.io an. Beim ersten Mal sehen Sie die Seite “Add New Store”.
Geben Sie den Namen und die Domain Ihres Webshops ein.
Wählen Sie Shopware 6 als Plattform und wählen Sie Ihre Währung.
Klicken Sie auf Add Store.

2. Plugin installieren und konfigurieren #
Für Shopware v6.4 und neuer kann das Plugin aus dem Shopware Extension Store installiert oder manuell von GitHub hochgeladen werden.
Option A: Installation aus dem Extension Store
- Gehen Sie in Ihrem Shopware Admin zu Extensions > Store und suchen Sie nach “Clerk”.

- Klicken Sie auf Add extension, um zu installieren.
Option B: Manuell von GitHub installieren
Wenn das Plugin im Shopware Extension Store nicht verfügbar ist, kann es von GitHub heruntergeladen und manuell hochgeladen werden.
- Gehen Sie zu den
Clerk Shopware 6.4 Plugin Releases auf GitHub und laden Sie die neueste
.zip-Datei herunter. - Gehen Sie in Ihrem Shopware Admin zu Extensions > My extensions.
- Klicken Sie auf Upload extension und wählen Sie die heruntergeladene
.zip-Datei aus. - Nach dem Hochladen klicken Sie auf Install und aktivieren Sie dann das Plugin.
Für Shopware v6.3 und älter:
- Laden Sie das Plugin herunter:
Releases für v6.3 und älter.

- Gehen Sie in Ihrem Shopware Admin zu Settings > System > Plugins.

- Klicken Sie auf Upload plugin, wählen Sie die heruntergeladene Datei, dann ... > Install und aktivieren Sie das Plugin.

Plugin konfigurieren:
- Klicken Sie auf ... > Config. im Clerk Plugin.

- Wählen Sie den richtigen Sales Channel.
- Unter General setzen Sie Status auf Enabled.
- Geben Sie Ihren Public Key und Private Key ein und klicken Sie dann auf Save.

Schlüssel-Standort: Ihr Public Key und Private Key befinden sich unter my.clerk.io > Developers > API Keys.
3. Daten synchronisieren #
Die Datensynchronisation verbindet Ihren Shopware 6 Shop mit Clerk, sodass Clerk auf Ihre Produkte, Bestellungen, Kunden und andere Shop-Informationen zugreifen kann. Dies ermöglicht Clerk, personalisierte Empfehlungen und Suchergebnisse auf Basis Ihrer tatsächlichen Shopdaten zu bieten. Folgen Sie den Schritten im Sync Data guide, um die Datensynchronisation einzurichten.
Headless Setups #
Für Headless Shopware-Installationen erstellen Sie einen versteckten Storefront Sales Channel mit den gleichen Sprachen und Währungen wie Ihr Hauptshop. Clerk nutzt den Storefront Channel, um Sprach- und Währungsreferenzen während der Synchronisation aufzulösen.
- Erstellen Sie einen Storefront Sales Channel und halten Sie ihn verborgen in der Navigation.
- Fügen Sie alle Sprachen und Währungen hinzu, die Ihr Headless-Shop verwendet.
- Wählen Sie diesen Storefront Sales Channel in der Clerk Plugin-Konfiguration aus, wenn Sie das Sync einrichten.
Dies stellt sicher, dass alle Sprach- und Währungsreferenzen verfügbar sind, damit die Datensynchronisation korrekt abgeschlossen werden kann.
Weitere Informationen zum Erstellen und Konfigurieren von Sales Channels finden Sie in Shopware’s Dokumentation: Sales Channel settings.
Mehrere Sprachen #
Shopware verwendet Language IDs, um jede eindeutige Sprache im Webshop zu identifizieren. Diese sind im Shopware Backend nicht sichtbar, daher müssen sie über das Frontend-HTML gefunden werden.
Sehen Sie sich dieses Video an, um zu sehen, wie man die Language IDs ermittelt.
Der beste Weg, Mehrsprachigkeit mit Clerk zu handhaben, ist, für jede Sprache einen eigenen Store zu erstellen und ihn mit der korrekten Language ID zu synchronisieren.
So können Sie Produkte, Verkäufe, Währungen usw. trennen, um jede Sprache im Blick zu behalten.
Beginnen Sie damit, Ihren Haupt-Store zu erstellen und folgen Sie dem Setup-Guide, um Ihren Store mit Clerk.io zu verbinden, und wählen Sie die Recommendations und/oder Search Results aus, die Sie in Ihrem Webshop anzeigen möchten.
Nachdem Sie das Initial-Setup abgeschlossen haben, gehen Sie zurück zur Startseite von my.clerk.io (indem Sie auf das Clerk.io Logo in der oberen linken Ecke des Seitenmenüs klicken) und klicken Sie dann auf "+ Add new store", die letzte Option in der Ausklappliste (in der Regel unter Ihrem bestehenden Store(n) und Ihrem Firmennamen):



Füllen Sie die Details Ihres Webshops aus und wählen Sie Ihren Haupt-Store aus dem Dropdown Copy Elements From Existing Store aus. Klicken Sie dann auf Add Store. Dadurch werden die Elements und Designs von Ihrem Haupt-Store übernommen.
Nun können Sie dem Setup-Guide erneut folgen, um Clerk.io zu aktivieren, indem Sie auf Getting Started klicken, um Sync Data für diese Sprache zu starten. Denken Sie daran, die korrekte Language ID wie im Video oben im Guide beschrieben zu verwenden. Die Store URL, Access Key und Secret Access Key sind für alle Stores gleich.

Sobald die Data Sync abgeschlossen ist, ist Ihr Webshop bereit und nutzt das gleiche Setup wie Ihr Haupt-Store.
Denken Sie daran, Headlines unter Element-> Edit -> Select Design ebenfalls in die richtige Sprache zu übersetzen.
Sie können diesen Prozess für alle Sprachen des Webshops wiederholen, mit denen Sie Clerk.io verwenden möchten.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.