Get Started
Ihren Shop verbinden #
Der erste Schritt bei der Installation von Clerk.io besteht darin, Ihren Shop mit Ihrem Clerk.io-Konto zu verbinden.
Das folgende Video zeigt Ihnen Schritt für Schritt, was zu tun ist. Nutzen 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 funktioniert. Wenden Sie sich an Ihren Clerk.io-Ansprechpartner, um die Live-Demo zu sehen.
1. Shop hinzufügen #
Melden Sie sich bei my.clerk.io an. Beim ersten Login sehen Sie die Seite “Add New Store”.
Geben Sie den Name und die Domain Ihres Webshops ein.
Wählen Sie Shopware 6 als Platform und Ihre Currency.
Klicken Sie auf Add Store.

2. Plugin installieren und konfigurieren #
Für Shopware v6.4 und neuer:
- Gehen Sie in Ihrem Shopware-Admin zu Extensions > Store und suchen Sie nach “Clerk”.

- Klicken Sie auf Add extension, um zu installieren.
Für Shopware v6.3 und älter:
- Laden Sie das Plugin herunter:
Releases for v6.3 and earlier.

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

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

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

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

Key-Standort: Ihr Public Key und Private Key befinden sich unter my.clerk.io > Developers > API Keys.
3. Daten synchronisieren #
Die Datensynchronisierung verbindet Ihren Shopware 6 Shop mit Clerk und ermöglicht Clerk den Zugriff auf Ihre Produkte, Bestellungen, Kunden und andere Shop-Informationen. So kann Clerk personalisierte Recommendations und Suchergebnisse auf Basis Ihrer Shopdaten bereitstellen. Befolgen Sie die Schritte in der Sync Data guide, um die Datensynchronisierung 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 verwendet den Storefront-Channel, um Sprach- und Währungsreferenzen während der Synchronisierung aufzulösen.
- Erstellen Sie einen Storefront Sales Channel und halten Sie ihn von der Navigation verborgen.
- 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 beim Einrichten der Synchronisierung aus.
Dadurch werden alle Sprach- und Währungsreferenzen bereitgestellt, sodass die Datensynchronisation korrekt abgeschlossen werden kann.
Weitere Informationen zum Erstellen und Konfigurieren von Sales Channels finden Sie in der Shopware-Dokumentation: Sales Channel settings.
Mehrere Sprachen #
Shopware verwendet Language IDs, um jede einzigartige Sprache im Webshop zu identifizieren. Diese sind im Shopware-Backend nicht sichtbar, daher müssen sie über das Frontend-HTML gefunden werden.
Check this video, um zu sehen, wie Sie die Language IDs identifizieren.
Der beste Weg, um mehrere Sprachen in Clerk zu handhaben, ist, für jede Sprache einen eigenen Store zu erstellen und ihn mit der richtigen Language ID zu synchronisieren.
So können Sie Produkte, Verkäufe, Währungen usw. für jede Sprache getrennt nachverfolgen.
Beginnen Sie mit dem Erstellen Ihres main Store und befolgen Sie die Setup-Anleitung, 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.
Nach Abschluss der ersten Einrichtung kehren Sie zur Startseite von my.clerk.io zurück (klicken Sie dazu auf das Clerk.io-Logo in der oberen linken Ecke des Seitenmenüs) und klicken Sie anschließend auf "+ Add new store", die letzte Option in der Auswahlliste (in der Regel unter Ihren bestehenden Store(s) und Ihrem Firmennamen):



Füllen Sie die Details Ihres Webshops aus und wählen Sie Ihren Hauptstore im Dropdown-Menü Copy Elements From Existing Store aus. Klicken Sie dann auf Add Store. Dadurch werden die Elements und Designs aus Ihrem Hauptstore übernommen.
Nun können Sie der Setup-Anleitung erneut folgen, um Clerk.io durch Klicken auf Getting Started zu aktivieren und die Daten für diese Sprache zu synchronisieren. Denken Sie daran, die korrekte Language ID wie im Video 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 verwendet die gleiche Einrichtung wie Ihr Hauptstore.
Denken Sie daran, Headlines in Element-> Edit -> Select Design ebenfalls in die richtige Sprache zu übersetzen.
Sie können diesen Prozess für alle Sprachen Ihres 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.