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 Instanz funktionieren soll.

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

Jeder Store hat seinen eigenen Satz an API-Schlüsseln, mit denen über Clerk’s API kommuniziert wird – unabhängig davon, welche Art von Einrichtung verwendet wird.

Stores können für jede unserer 54 unterstützten Sprachen konfiguriert werden. Search und Indexierung funktionieren in allen unterstützten Sprachen. Es ist keine Migration nötig; die Änderungen stehen sofort zur Verfügung. Siehe die vollständige Liste aller unterstützten Sprachen.

Verwaltung von Stores #

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

Neu hinzufügen #

Neue Stores werden in my.clerk.io hinzugefügt, indem Sie oben links auf den aktuellen Store-Namen klicken und dann + Add New Store. auswählen.

Geben Sie die Details für Ihren Store ein und klicken Sie auf Add New Store.

Die gewählte Plattform passt die Setup-Anleitungen des Stores so an, dass sie zu Ihrer Clerk-Integration auf dieser Plattform passen – daher ist es wichtig, die richtige zu wählen.

Die Währung wird nur dazu verwendet, die korrekte Währung in den Dashboards des Stores anzuzeigen, und beeinflusst das Tracking nicht.

Von bestehendem kopieren #

Wenn Sie einen neuen Store in my.clerk.io erstellen, können Sie sich viel Arbeit ersparen, wenn Sie das gleiche Setup wie bei einem bestehenden Store verwenden, indem Sie einfach den gewünschten Inhalt, das Design und andere Setup-Aspekte kopieren.

Dies ist sehr praktisch, wenn Sie einen Store für eine andere Sprache oder eine neue Domain für Ihren ursprünglichen Store erstellen.

Unter Copy Content From Existing Store wählen Sie im Dropdown den Store aus, den Sie duplizieren möchten. Sie können auswählen, welche Elemente Sie kopieren möchten:

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

Jetzt müssen Sie nur noch kleinere Änderungen im Design vornehmen (z.B. Währungssymbole und Button-Texte anpassen).

Der neue Store muss weiterhin mit Ihrem Katalog synchronisiert werden und erhält eigene API-Schlüssel.

Einen Store löschen #

Wenn Sie einen Store löschen, werden alle Einstellungen und Daten permanent entfernt und können nicht wiederhergestellt werden.

Sie können einen Store löschen, indem Sie zu Settings > Store settings gehen und unten auf der Seite Delete Store klicken. Bestätigen Sie im nächsten Schritt – danach ist Ihr Store gelöscht.

API-Schlüssel #

Falls Sie später erneut die Schlüssel Ihres Store benötigen, finden Sie diese unter Developers > API Keys.

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

Der Public API key wird für grundlegende Calls an Clerk verwendet und kann überall geteilt werden, da er allein keinen Zugang zu sensiblen Daten erlaubt.

Kombiniert mit einem Private API key erhält man Zugriff auf sensible Daten wie E-Mail-Adressen und kann Änderungen an Store-Daten vornehmen.

Zur Sicherheit für Clerk wird der Private API Key bei der Store-Erstellung generiert und an den Eigentümer des MyClerk-Kontos gesendet.

Key Rotation #

Falls Ihr Store einen Legacy Private Key hat, kann dieser direkt unter Developers > API Keys durch Klick auf den Rotate-Button daneben ersetzt werden.

Durch das Rotieren wird der alte Schlüssel sofort ungültig – alle Integrationen, die ihn verwenden, funktionieren nicht mehr. Stellen Sie sicher, dass Sie den Schlüssel überall ersetzt haben, bevor oder unmittelbar nachdem Sie ihn rotieren.

Nach der Rotation kann es erforderlich sein, sich im Clerk.io Backend ab- und wieder anzumelden, da der alte Schlüssel möglicherweise in Ihrer aktuellen Sitzung aktiv bleibt.

Für eine besser handhabbare Einrichtung verwenden Sie lieber die Standard-Private API Keys. Sie können beliebig viele Schlüssel für verschiedene Zwecke anlegen und jeweils einzeln widerrufen, ohne andere zu beeinflussen.

API-Status #

Hier erhalten Sie einen Überblick über alle API-Aufrufe in einem festgelegten Zeitraum. Es gibt verschiedene Informationspunkte:

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

Labels: Kennzeichnungen, mit denen Clerk Ergebnisse nachverfolgt, z.B. Homepage / Popular

Hits: Die Gesamtzahl der vom Endpoint gefundenen Ergebnisse.

Results: Die tatsächlich den Kunden angezeigte Anzahl von Ergebnissen. Diese kann von den Hits abweichen, wenn Sie Filter oder niedrigere Grenzwerte anwenden.

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

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

Entwickler-Logs #

Nutzen Sie die Entwickler-Logs, um Anfragen, Fehler und Warnungen Ihres Stores in Echtzeit zu überprüfen. Gehen Sie zu Developers > Logs.

Lesen Sie hier die vollständige Funktionsübersicht: /platform/company/developer-logs/.

Debug Dashboard #

Verwenden Sie Debug, um API-Requests zu erstellen und zu prüfen, warum ein bestimmtes Ergebnis zurückgegeben wurde.

Sie finden es unter Developers > Debug für den Store, an dem Sie arbeiten.

Einfach vs. Erweitert #

• Einfach: Jeder API-Parameter wird im eigenen Feld konfiguriert. Zu Beginn werden nur die Pflichtfelder angezeigt, unter Additional fields können Sie optionale Parameter einblenden.
• Erweitert: Erstellen Sie einen vollständigen GET-API-Aufruf manuell (z.B. durch Einfügen der vollständigen URL). Dies ist nützlich, wenn Sie bereits einen API-Call aus dem Code oder aus den Dev-Tools des Browsers reproduzieren möchten.

Eine Anfrage senden #

1. Wählen Sie ein Endpoint (z.B. Search Products oder Complementary Products).
2. Füllen Sie die erforderlichen Felder aus.
3. Optional: Klappen Sie Additional fields auf und fügen Sie weitere zu testende Parameter hinzu.
4. Klicken Sie auf Run Request (bzw. Make full API call im erweiterten Modus).

Debug-Ausgabe #

Nach dem Absenden einer Anfrage zeigt die Seite sowohl results als auch diagnostics an, die erklären, warum welche Ergebnisse gezeigt wurden. Je nach Endpoint und Konfiguration können folgende Informationen dabei sein:

• Customized search rules: Abfragebezogene Konfigurationen, die die Ergebnisse beeinflusst haben.
• Merchandising: Kampagnen, die angewendet wurden und welche Änderungen sie bewirkt haben.
• Backfill: Produkte, die hinzugefügt wurden, um das Limit zu füllen.
• Metadata: Weitere berechnete Details zum Aufruf.

Funktionen #

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

Anpassungs-Einstellungen #

Standardfunktionen, die ein- und ausgeschaltet werden können. Hauptsächlich zur Fehlerdiagnose, wenn Clerk’s Standardverhalten modifiziert wurde. Ist eine Funktion deaktiviert, funktioniert die zugehörige Funktionalität nicht mehr.

Aktuell können folgende Funktionen umgeschaltet werden:

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

Early Access #

Diese Funktionen befinden sich noch im Aufbau. Sie können manuell aktiviert werden, um neue Features vor offizieller Veröffentlichung zu testen.

Die meisten können von jedem User auf einem Store aktiviert werden, manche aber nur von Clerk-Mitarbeitern, wenn sie noch im Beta-Status sind – das ist die Stufe vor Early Access für alle.

Sollten einige der folgenden Funktionen für Sie nicht sichtbar sein, sind sie noch im Beta-Status. Kontaktieren Sie einen Clerk-Mitarbeiter, wenn Sie Lust auf Tests von Beta-Features haben.

Search 3.0 im Demo Store #

Die neueste Version unserer Search-Engine kann im Demo Store aktiviert werden, um die Unterschiede zur Live-Seite zu sehen.

Search 3.0 ist eine große Verbesserung in Bezug auf das Verständnis jeder Art von Anfrage und die Relevanzbewertung der Suchergebnisse.

AI Demo Shop Assistant #

Aktiviert Chat im Demo Store zur Erprobung. Funktioniert nur, wenn Search 3.0 ebenfalls aktiviert ist. Weitere Informationen auf der Chat-Einführungsseite.

Search 3.0 #

Aktiviert die neueste Search-Engine-Version auf der Live-Seite. Search 3.0 bringt einen deutlich besseren Umgang mit jeder Art von Anfrage und eine optimierte Suchergebnisbewertung.

Es ist keine Neuinstallation von Search auf Ihrer Seite nötig, da der Wechsel auf API-Ebene erfolgt. Ihr bestehendes Setup bleibt bestehen.

Semantic Fallback (Beta) #

Eine revolutionäre Methode für die Verarbeitung von Suchanfragen mit ganzen Phrasen.

Wenn keine direkte Übereinstimmung gefunden wird, analysiert Clerk die Anfrage semantisch und versteht, was die Besucher suchen. Beispiel: Eine Suche nach „etwas zum Kühlen meiner Lebensmittel“ liefert Kühlschränke.

Recommendations 3.0 (Beta) #

Eine wesentlich schnellere Möglichkeit, Recommendations-Ergebnisse anzuzeigen, basierend auf dem gleichen Framework wie Search 3.0.

Derzeit verfügbar für folgende Logiken:

• Bestsellers (recommendations/popular)
• Bestsellers in Category (recommendations/category/popular)

Ein erneutes Installieren von Recommendations ist nicht erforderlich, da sich die Änderung auf API-Ebene vollzieht.

Order Scoring (Legacy) #

Eine alternative Methode, Produkte basierend auf ihren Bestelldaten in älteren Versionen von Search zu bewerten. Diese Methode wird eingestellt, da die neueste Version von Search (3.0) dies wesentlich besser erledigt.

Spell Fix (Legacy) #

Eine alternative Behandlung von Tippfehlern in älteren Versionen von Search. Diese wird eingestellt, weil die aktuelle Search (3.0) dies deutlich besser abbildet.

SKU Search Optimization (Legacy) #

Eine andere Methode der SKU-Suchbehandlung in älteren Versionen von Search, die von Search 3.0 abgelöst wird.

Autocomplete Improvement (Legacy) #

Ein anderes Autocompletion-Verhalten in älteren Search-Versionen. Diese wird durch die neue Search (3.0) besser behandelt und daher eingestellt.

Improved Category Search (Legacy) #

Eine andere Art, Kategorien in älteren Search-Versionen zu durchsuchen, wird durch Search 3.0 ersetzt.

Farbschema #

Stores übernehmen das bevorzugte Farbschema Ihres Betriebssystems. Es wird sowohl helle als auch dunkle Darstellung unterstützt.