Stores

Grundlagen #

Ein Store ist eine separate Einheit in Clerk.io, die alle Daten und Einstellungen für eine bestimmte Domain enthält. Dies kann ein einzigartiger Webshop, eine Plattform, eine Sprachversion oder alles andere sein, das als eigenständige Einheit fungieren soll.

Sie arbeiten völlig unabhängig voneinander und teilen keine Daten untereinander. Die einzige Ausnahme ist, dass einige Funktionen wie Merchandising und Synonyms bei Bedarf über mehrere Stores hinweg hinzugefügt werden können.

Jeder Store verfügt über einen eigenen Satz von API-Schlüsseln, um über Clerk’s API zu kommunizieren, unabhängig davon, welche Art von Setup verwendet wird.

Stores können für jede unserer 54 unterstützten Sprachen konfiguriert werden. Search und Indexierung funktionieren über alle unterstützten Sprachen hinweg. Keine Migration ist nötig; die Änderungen stehen sofort zur Verfügung. Siehe die vollständige Liste der unterstützten Sprachen.

Verwaltung von Stores #

Ein Unternehmen kann beliebig viele Stores haben, die nach Bedarf erstellt, kopiert und gelöscht werden können.

Neu hinzufügen #

Neue Stores werden in my.clerk.io hinzugefügt, indem man auf den aktuellen Store-Namen in der oberen linken Ecke klickt und dann + Add New Store. auswählt.

Gib die Details für deinen Store ein und klicke auf Add New Store.

Die Plattform, die du auswählst, passt die Setup-Anleitung des Stores so an, dass sie zum Setup von Clerk auf der gewählten Plattform passt. Daher ist es wichtig, die richtige auszuwählen.

Die Währung dient lediglich dazu, die richtige Währung in den Dashboards des Stores anzuzeigen und hat keinen Einfluss auf das Tracking.

Von bestehendem kopieren #

Wenn du einen neuen Store in my.clerk.io erstellst, kannst du dir viel Arbeit sparen, indem du das gleiche Setup wie bei einem bestehenden Store verwendest und einfach Inhalte, Designs und andere Einstellungsaspekte kopierst, die du wiederverwenden möchtest.

Das ist besonders praktisch, wenn du einen neuen Store für eine andere Sprache oder eine neue Domain für deinen ursprünglichen Store erstellst.

Unter Copy Content From Existing Store wählst du den Store, den du duplizieren möchtest, aus dem Dropdown-Menü. Du kannst auswählen, welche spezifischen Elemente kopiert werden sollen:

• Inhalt
• Designs
• Synonyms
• Accessories
• Audiences
• Rules
• Merchandising
• Modifiers

Nun brauchst du nur noch kleinere Anpassungen an den Designs vornehmen (z. B. Währungssymbole und Buttontexte ändern).

Der neue Store muss trotzdem mit deinem Katalog synchronisiert werden und erhält einen eigenen Satz von API-Schlüsseln.

Einen Store löschen #

Wenn du einen Store löschst, werden dessen Einstellungen und Daten für immer entfernt und können nicht wiederhergestellt werden.

Du kannst ihn löschen, indem du zu Settings > Store settings gehst und dann ganz unten auf der Seite auf Delete Store klickst. Bestätige im nächsten Dialog, danach wird dein Store gelöscht.

API-Schlüssel #

Wenn du nach der Ersteinrichtung die Schlüssel deines Stores noch einmal benötigst, findest du sie unter Developers > API Keys.

Jeder Store hat einen festen Public API key und mehrere Private API keys.

Der Public API key wird für grundlegende Anfragen an Clerk verwendet und kann überall geteilt werden, da er keinen Zugriff auf sensible Daten gewährt.

In Kombination mit einem Private API key erhältst du Zugriff auf sensible Daten wie E-Mail-Adressen und kannst Änderungen an den Daten im Store vornehmen.

Aus Sicherheitsgründen für Clerk wird der Private API Key beim Erstellen eines Stores generiert und an den Besitzer des MyClerk-Kontos gesendet.

API-Status #

Hier findest du eine Übersicht aller API-Aufrufe innerhalb eines definierten Zeitraums. Es gibt verschiedene Informationspunkte:

API: Das aufgerufene API-Endpoint, z.B. recommendations/popular

Labels: Kennzeichnung, mit der Clerk die Ergebnisse verfolgt, z.B. Homepage / Popular

Hits: Die Gesamtzahl der vom Endpoint gefundenen Ergebnisse.

Results: Die Gesamtzahl der tatsächlich den Kunden angezeigten Ergebnisse. Diese kann sich von den Hits unterscheiden, wenn du Filter oder geringere Limits verwendest.

Avg. Response Time: Durchschnittliche Millisekunden, die das API-Endpoint für eine Antwort benötigt.

Success Rate: Prozentsatz der API-Aufrufe, die tatsächlich Ergebnisse geliefert haben.

Developer Logs #

Nutze die Developer Logs, um Anfragen, Fehler und Warnungen deines Stores in Echtzeit zu überprüfen. Gehe zu Developers > Logs.

Die vollständige Feature-Übersicht findest du hier: /platform/company/developer-logs/.

Features #

Stores verfügen über verschiedene Schalter, mit denen gesteuert werden kann, welche Features aktiviert sind.

Einstellungen zur Anpassung #

Standardfunktionen, die ein- und ausgeschaltet werden können. Hauptsächlich zur Identifizierung von Problemen verwendet, die durch Änderungen am Standardverhalten von Clerk hervorgerufen werden. Wenn ein Feature deaktiviert ist, funktioniert jegliche Funktionalität innerhalb dieses Features nicht mehr.

Aktuell können folgende Features umgeschaltet werden:

• Rules
• Redirects
• Synonyms
• Merchandising
• AI Campaigns
• Fullname Categories

Early Access #

Dies sind Features, die noch aktiv entwickelt werden. Sie können manuell aktiviert werden, um neue Funktionen zu testen, bevor diese allgemein verfügbar sind.

Die meisten lassen sich von jedem Nutzer auf einem Store aktivieren, einige können nur von Clerk-Mitarbeitern freigeschaltet werden, wenn sie sich noch im Beta-Stadium befinden, also kurz vor Early Access.

Falls einige der folgenden Features für dich nicht sichtbar sind, liegen sie noch im Beta-Stadium. Kontaktiere einen Clerk-Mitarbeiter, wenn du Beta-Features testen möchtest.

Search 3.0 im Demo Store #

Die neueste Version unserer Search-Engine kann speziell im Demo Store aktiviert werden, um den Unterschied im Vergleich zur Live-Seite zu testen.

Search 3.0 ist ein großer Fortschritt im Verständnis aller Arten von Suchanfragen und im Ranking der Suchergebnisse.

KI Demo Shop Assistant #

Aktiviert den Chat im Demo Store, sodass er getestet werden kann. Funktioniert nur, wenn auch Search 3.0 aktiviert ist. Weitere Informationen auf der Chat-Einführungsseite.

Search 3.0 #

Aktiviert die neueste Version unserer Search-Engine auf deiner Live-Seite. Search 3.0 ist ein großer Fortschritt im Verständnis aller Arten von Suchanfragen und im Ranking der Suchergebnisse.

Du musst Search auf deiner Seite nicht neu installieren, da die Änderung auf API-Ebene stattfindet. Es funktioniert mit deinem bestehenden Setup.

Semantischer Fallback (Beta) #

Ein bahnbrechender Ansatz zur Verarbeitung von Suchanfragen mit vollen Phrasen.

Wenn keine direkte Übereinstimmung gefunden wird, analysiert Clerk die Anfrage und versteht semantisch, wonach Besucher suchen. Eine Suche nach “etwas, womit ich mein Essen kühlen kann” liefert z. B. Kühlschränke.

Recommendations 3.0 (Beta) #

Eine deutlich schnellere Methode, Recommendations-Ergebnisse anzuzeigen, basierend auf dem gleichen Framework wie in Search 3.0.

Funktioniert derzeit für folgende Logiken:

• Bestseller (recommendations/popular)
• Bestseller in einer Kategorie (recommendations/category/popular)

Es ist keine Neuinstallation von Recommendations nötig, da die Änderung auf API-Ebene erfolgt.

Order Scoring (Legacy) #

Eine andere Methode, Produkte basierend auf ihren Bestelldaten in Suchergebnissen in älteren Search-Versionen zu bewerten. Diese Funktion wird abgeschafft, da unsere neueste Version von Search (3.0) dies deutlich besser handhabt.

Spell Fix (Legacy) #

Eine andere Methode zur Behandlung von Rechtschreibfehlern in älteren Search-Versionen. Diese Funktion wird abgeschafft, da unsere neueste Version von Search (3.0) dies deutlich besser handhabt.

SKU Search Optimization (Legacy) #

Eine andere Methode zur Behandlung von SKU-Suchen in älteren Search-Versionen. Diese Funktion wird abgeschafft, da unsere neueste Version von Search (3.0) dies deutlich besser handhabt.

Autocomplete Improvement (Legacy) #

Eine andere Methode zur Autovervollständigung bei Suchanfragen in älteren Search-Versionen. Diese Funktion wird abgeschafft, da unsere neueste Version von Search (3.0) dies deutlich besser handhabt.

Verbesserte Kategoriesuche (Legacy) #

Eine andere Methode zum Suchen nach Kategorien in älteren Search-Versionen. Diese Funktion wird abgeschafft, da unsere neueste Version von Search (3.0) dies deutlich besser handhabt.

Farbschema #

Stores übernehmen das bevorzugte Farbschema deines Betriebssystems. Sowohl heller als auch dunkler Modus werden unterstützt.