Stores

Grundlagen #

Ein Store ist eine separate Entität 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 funktionieren soll.

Sie arbeiten völlig unabhängig und teilen keine Daten untereinander. Die einzige Ausnahme ist, dass einige Funktionen wie Merchandising und Synonyme 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 damit zu kommunizieren, unabhängig davon, welche Art von Setup Sie verwenden.

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 erforderlich; die Änderungen sind sofort verfügbar. Siehe die vollständige Liste der unterstützten Sprachen.

Verwaltung von Stores #

Ein Unternehmen kann beliebig viele Stores zugeordnet haben, und sie können 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. auswählen.

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

Die von Ihnen gewählte Plattform stimmt die Einrichtungsanleitungen des Stores darauf ab, wie Clerk auf der Plattform eingerichtet ist. Daher ist es wichtig, die richtige auszuwählen.

Die Währung wird nur verwendet, um die richtige Währung im Dashboard des Stores anzuzeigen, hat aber keinen Einfluss auf das Tracking.

Von bestehendem kopieren #

Wenn Sie einen neuen Store in my.clerk.io erstellen, können Sie sich viel Arbeit sparen, indem Sie einfach das Setup, die Inhalte, Designs und andere Aspekte Ihres bestehenden Stores kopieren.

Das ist sehr praktisch, wenn Sie einen neuen 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 den Store, den Sie duplizieren möchten, aus dem Dropdown-Menü aus. Sie können auswählen, welche spezifischen Elemente Sie kopieren möchten:

• Inhalte
• Designs
• Synonyme
• Accessoires
• Audiences
• Regeln
• Merchandising
• Modifier

Jetzt müssen Sie nur noch kleine Änderungen in den Designs vornehmen (wie z.B. das Ändern der Währungssymbole und Button-Texte).

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

Einen Store löschen #

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

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

API-Schlüssel #

Wenn Sie nach der ersten Integration die Schlüssel Ihres Stores benötigen, finden Sie sie unter Developers > API Keys.

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

Der Public API key wird verwendet, wenn grundlegende Anforderungen an Clerk gestellt werden und kann überall geteilt werden, da er allein keinen Zugang zu sensiblen Daten gewährt.

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 von Clerk wird der Private API Key bei der Store-Erstellung generiert und an den Inhaber des MyClerk-Kontos gesendet.

API-Status #

Dies enthält eine Übersicht aller API-Aufrufe in einem definierten Zeitraum. Es enthält eine Vielzahl von Informationen:

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

Labels: Zur Identifikation für Clerk, um Ergebnisse zu verfolgen, z.B. Homepage / Popular

Hits: Die Gesamtzahl der vom Endpunkt gefundenen Ergebnisse.

Results: Die Gesamtzahl der tatsächlich den Kunden angezeigten Ergebnisse. Dies kann von den Hits abweichen, wenn Sie Filter oder niedrigere Limits bei der Anzeige der Ergebnisse verwenden.

Durchschn. Antwortzeit: Durchschnittliche Millisekunden, die das API-Endpunkt für die Antwort benötigt.

Erfolgsrate: Prozentsatz der API-Anfragen, die tatsächlich Ergebnisse zurückgegeben haben.

Entwickler-Logs #

Verwenden Sie die Developer Logs, um Anfragen, Fehler und Warnungen für Ihren Store in Echtzeit zu überprüfen. Gehen Sie zu Developers > Logs.

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

Debug-Dashboard #

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

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

Einfach vs. Erweitert #

• Einfach: Jeder API-Parameter wird in einem eigenen Feld konfiguriert. Zu Beginn werden nur die Pflichtfelder angezeigt und Sie können Zusätzliche Felder erweitern, um optionale Parameter hinzuzufügen.
• Erweitert: Erstellen Sie manuell eine vollständige GET API-Anfrage (z.B. durch Einfügen der kompletten URL). Dies ist nützlich, wenn Sie bereits einen API-Aufruf aus dem Code oder aus dem Netzwerkanalysetab des Browsers haben, den Sie reproduzieren möchten.

Eine 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 Zusätzliche Felder und fügen Sie beliebige weitere zu testende Parameter hinzu.
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 Ergebnisse als auch Diagnosen, die erklären, was sie beeinflusst hat. Je nach Endpunkt und Konfiguration kann dies Folgendes umfassen:

• Angepasste Suchregeln: Abfrage-spezifische Konfigurationen, die die Ergebnisse beeinflusst haben.
• Merchandising: Kampagnen, die angewendet wurden und was sie verändert haben.
• Backfill: Produkte, die zu den Ergebnissen hinzugefügt wurden, um das Limit zu erreichen.
• Metadaten: Weitere berechnete Details zum Aufruf.

Features #

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

Anpassungseinstellungen #

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

Aktuell umschaltbare Features sind:

• Regeln
• Weiterleitungen
• Synonyme
• Merchandising
• AI-Kampagnen
• Vollname-Kategorien

Early Access #

Dies sind Funktionen, die noch aktiv entwickelt werden. Sie können manuell aktiviert werden, um neue Features vor ihrer allgemeinen Veröffentlichung zu testen.

Die meisten können von jedem Benutzer auf einem Store aktiviert werden, einige nur von Clerk-Mitarbeitenden, solange sie noch im Beta-Stadium sind (das Stadium vor Early Access).

Wenn einige der folgenden Funktionen für Sie nicht sichtbar sind, liegt das daran, dass sie noch in Beta sind. Kontaktieren Sie einen Clerk-Mitarbeitenden, wenn Sie Interesse am Testen von Beta-Features haben.

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 testen.

Search 3.0 ist eine große Verbesserung hinsichtlich des Verständnisses jeder Art von Anfrage und bei der Reihung der Suchergebnisse.

AI Demo Shop Assistant #

Aktiviert den Chat im Demo Store, damit dieser getestet werden kann. Funktioniert nur, wenn Search 3.0 ebenfalls aktiviert ist. Mehr Informationen auf der Chat-Einführungsseite.

Search 3.0 #

Aktiviert die neueste Version unserer Search-Engine auf Ihrer Live-Seite. Search 3.0 ist eine große Verbesserung beim Verständnis jeder Art von Suchanfrage und der Reihung der Ergebnisse.

Sie müssen Search nicht erneut auf Ihrer Website installieren, da die Änderung auf API-Ebene erfolgt. Es funktioniert mit Ihrem bestehenden Setup.

Semantischer Fallback (Beta) #

Eine bahnbrechende Art, ganze Phrasen in Suchanfragen zu verarbeiten.

Wenn keine direkte Übereinstimmung gefunden wird, analysiert Clerk die Anfrage und erkennt semantisch, wonach die Besucher suchen. Z.B. eine Suche nach “etwas, um mein Essen zu kühlen” liefert Kühlschränke.

Recommendations 3.0 (Beta) #

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

Derzeit funktioniert dies für folgende Logiken:

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

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

Order Scoring (Legacy) #

Eine andere Methode, Produkte in Suchergebnissen älterer Search-Versionen nach Bestelldaten zu bewerten. Diese Funktion wird eingestellt, da dies in unserer neuesten Version Search (3.0) viel besser gehandhabt wird.

Spell Fix (Legacy) #

Eine andere Methode, Rechtschreibfehler in älteren Versionen von Search zu handhaben. Diese Funktion wird eingestellt, da dies in unserer neuesten Version Search (3.0) viel besser gehandhabt wird.

SKU Search Optimization (Legacy) #

Eine andere Methode, SKU-Suchen in älteren Versionen von Search zu verarbeiten. Diese Funktion wird eingestellt, da dies in unserer neuesten Version Search (3.0) viel besser gehandhabt wird.

Autocomplete Improvement (Legacy) #

Eine andere Methode, Autovervollständigung in älteren Versionen von Search umzusetzen. Diese Funktion wird eingestellt, da dies in unserer neuesten Version Search (3.0) viel besser gehandhabt wird.

Verbesserte Kategoriesuche (Legacy) #

Eine andere Methode, nach Kategorien in älteren Versionen von Search zu suchen. Diese Funktion wird eingestellt, da dies in unserer neuesten Version Search (3.0) viel besser gehandhabt wird.

Farbschema #

Stores übernehmen das bevorzugte Farbschema Ihres Betriebssystems. Es werden sowohl der helle als auch der dunkle Modus unterstützt.