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 etwas anderes sein, das als separate Einheit fungieren soll.

Sie arbeiten vollkommen 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 ein eigenes Set 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. Es ist keine Migration notwendig; die Änderungen stehen sofort zur Verfügung. Siehe die vollständige Liste der unterstützten Sprachen.

Stores verwalten #

Ein Unternehmen kann beliebig viele Stores haben, die damit verknüpft sind. Sie können je nach Bedarf erstellt, kopiert und gelöscht werden.

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.

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

Die von Ihnen gewählte Plattform passt die Setup-Anleitungen des Stores an die Einrichtung von Clerk auf der Plattform an. Daher ist es wichtig, die richtige auszuwählen.

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

Von bestehendem kopieren #

Wenn Sie einen neuen Store in my.clerk.io erstellen, können Sie sich viel Arbeit ersparen, indem Sie einfach das Setup Ihrer bestehenden Instanz verwenden und die Inhalte, Designs und andere Setup-Aspekte, die Sie wiederverwenden möchten, einfach kopieren.

Das ist besonders praktisch, wenn Sie einen neuen Store für eine andere Sprache oder eine neue Domain Ihres ursprünglichen Stores erstellen.

Unter Copy Content From Existing Store wählen Sie aus der Dropdown-Liste den Store aus, von dem Sie kopieren möchten. Sie können auswählen, welche spezifischen Elemente Sie kopieren möchten:

• Content
• Designs
• Synonyms
• Accessories
• Audiences
• Rules
• Merchandising
• Modifiers
• Chat settings
• AI integrations

Nun müssen Sie nur noch kleinere Anpassungen an den Designs vornehmen (z.B. Währungssymbole und Button-Texte ändern).

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

Einen Store löschen #

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

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

API-Schlüssel #

Wenn Sie die Schlüssel Ihres Stores nach der ersten Integration für irgendeinen Zweck benötigen, finden Sie diese unter Developers > API Keys.

Jeder Store verfügt über einen festen Public API key und eine Anzahl von Private API keys.

Der Public API key wird bei grundlegenden API-Aufrufen an Clerk verwendet und kann überall geteilt werden, da er allein keinen Zugriff auf sensiblen Daten gibt.

In Kombination mit einem Private API key erhalten Sie Zugriff auf sensible Daten wie E-Mail-Adressen und können Änderungen an den Daten eines Stores vornehmen.

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

Schlüssel-Rotation #

Wenn Ihr Store einen Legacy Private Key hat, können Sie diesen direkt unter Developers > API Keys rotieren, indem Sie auf den Dreh-Button daneben klicken.

Die Rotation macht den alten Schlüssel sofort ungültig – jede Integration, die ihn nutzt, funktioniert sofort nicht mehr. Stellen Sie sicher, dass Sie bereit sind, ihn überall zu ersetzen, bevor oder direkt nachdem Sie rotieren.

Nach der Rotation müssen Sie sich eventuell aus dem Clerk.io Backend ausloggen und erneut anmelden, da der alte Schlüssel noch in Ihrer aktuellen Sitzung aktiv sein kann.

Für ein übersichtlicheres Setup nutzen Sie stattdessen die Standard-Private API Keys. Sie können beliebig viele für unterschiedliche Zwecke erstellen und diese einzeln widerrufen, ohne die anderen zu beeinflussen.

API-Status #

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

API: Der aufgerufene API-Endpunkt, z.B. recommendations/popular

Labels: Kennzeichnung, die Clerk zur Nachverfolgung der Ergebnisse verwendet. Z.B. Homepage / Popular

Hits: Die Gesamtanzahl der vom Endpunkt gefundenen Ergebnisse.

Results: Die Gesamtanzahl der tatsächlich den Kunden angezeigten Ergebnisse. Diese kann sich von den Hits unterscheiden, wenn Sie Filter oder niedrigere Limits beim Anzeigen verwenden.

Avg. Response Time: Durchschnittliche Millisekunden, in denen der API-Endpunkt antwortet.

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

Entwickler-Logs #

Mithilfe der Developer Logs können Sie Anfragen, Fehler und Warnungen für Ihren Store in Echtzeit einsehen. Navigieren Sie zu Developers > Logs.

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

Debug Dashboard #

Verwenden Sie Debug, um API-Anfragen zu erstellen und zu untersuchen, warum ein bestimmter Ergebnissatz zurückgegeben wurde.

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

Einfach vs. Erweitert #

• Einfach: Jeder API-Parameter wird in einem eigenen Feld konfiguriert. Zu Beginn werden nur die erforderlichen Felder angezeigt. Mit Additional fields können Sie optionale Parameter hinzufügen.
• Erweitert: Erstellen Sie manuell einen vollständigen GET-API-Aufruf (zum Beispiel durch Einfügen der vollständigen URL). Nützlich, wenn Sie bereits einen API-Aufruf aus Code oder der Browser-Netzwerk-Ansicht reproduzieren möchten.

Anfrage ausführen #

1. Wählen Sie einen Endpoint (z.B. Search Products oder Complementary Products).
2. Füllen Sie die erforderlichen Felder aus.
3. Optional: Erweitern Sie Additional fields und fügen Sie zusätzliche Parameter hinzu, die Sie testen wollen.
4. Klicken Sie auf Run Request (oder Make full API call im erweiterten Modus).

Debug-Ausgabe #

Nach Ausführung einer Anfrage zeigt die Seite sowohl die results als auch diagnostics an, die erklären, was diese beeinflusst hat. Abhängig vom Endpunkt und der Konfiguration kann dies beinhalten:

• Customized search rules: Abfrage-spezifische Konfiguration, die das Ergebnis beeinflusst hat.
• Merchandising: Angewendete Kampagnen und ihre Auswirkungen.
• Backfill: Produkte, die hinzugefügt wurden, um das Limit zu füllen.
• Metadata: Weitere berechnete Details zum Aufruf.

Features #

Stores haben eine Reihe von Schaltern, mit denen Sie steuern können, welche Funktionen aktiviert sind.

Anpassungseinstellungen #

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

Aktuell schaltbare Features sind:

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

Early Access #

Dies sind Funktionen, die sich noch in aktiver Entwicklung befinden. Sie können manuell aktiviert werden, um neue Features zu testen, bevor sie überall veröffentlicht werden.

Die meisten können von jedem Benutzer im Store aktiviert werden, einige können nur von Clerk-Mitarbeitern aktiviert werden, wenn sie sich noch im Beta-Stadium befinden, der Stufe vor der öffentlichen Early Access-Phase.

Sollten einige der untenstehenden Funktionen nicht sichtbar sein, liegt das daran, dass sie noch im Beta-Stadium sind. Wenden Sie sich an einen Clerk-Mitarbeiter, wenn Sie Beta-Funktionen testen möchten.

Search 3.0 Im Demo Store #

Die neueste Version unserer Search engine kann speziell im Demo Store aktiviert werden, um den Unterschied zur Live-Seite zu überprüfen.

Search 3.0 ist eine große Verbesserung hinsichtlich des Verständnisses aller Anfragetypen und der Relevanzbewertung der Suchergebnisse.

AI Demo Shop Assistant #

Aktiviert den Chat im Demo Store, sodass dieser getestet werden kann. Funktioniert nur, wenn auch Search 3.0 aktiviert ist. Weitere Infos auf der Chat-Intro-Seite.

Search 3.0 #

Aktiviert die neueste Version unserer Search engine auf Ihrer Live-Seite. Search 3.0 ist eine große Verbesserung hinsichtlich des Verständnisses aller Anfragetypen und der Relevanzbewertung der Suchergebnisse.

Es ist keine Neuinstallation von Search auf Ihrer Seite notwendig, da die Änderung auf API-Ebene erfolgt. Sie funktioniert mit Ihrem bestehenden Setup.

Semantic Fallback (Beta) #

Eine bahnbrechende Methode, um Suchanfragen mit ganzen Sätzen zu bearbeiten.

Wenn keine direkte Übereinstimmung gefunden werden kann, analysiert Clerk die Anfrage und versteht semantisch, wonach Besucher suchen. z.B. liefert eine Suche nach “etwas, um mein Essen zu kühlen” 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 aktuell für diese Logiken:

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

Dies erfordert keine Neuinstallation von Recommendations, da die Änderung auf API-Ebene erfolgt.

Order Scoring (Legacy) #

Eine andere Methode der Produktbewertung auf Basis ihrer Bestelldaten in Suchergebnissen älterer Search-Versionen. Wird ausgemustert, da die neueste Version von Search (3.0) das deutlich besser handhabt.

Spell Fix (Legacy) #

Eine andere Methode zur Handhabung von Rechtschreibfehlern in älteren Versionen von Search. Wird ausgemustert, da Search (3.0) dies besser verarbeitet.

SKU Search Optimization (Legacy) #

Eine andere Methode zur Verarbeitung von SKU-Suchen in älteren Versionen von Search. Wird ausgemustert, da Search (3.0) dies besser macht.

Autocomplete Improvement (Legacy) #

Eine andere Methode der Autovervollständigung in älteren Versionen von Search. Wird ausgemustert, da Search (3.0) dies deutlich verbessert.

Improved Category Search (Legacy) #

Eine andere Methode für die Kategoriensuche in älteren Versionen von Search. Wird ausgemustert, da Search (3.0) dies besser abdeckt.

Farbschema #

Stores übernehmen das bevorzugte Farbschema Ihres Betriebssystems. Sowohl Light- als auch Dark-Mode werden unterstützt.