Besucher

Übersicht #

Das Visitor-Log ermöglicht es Ihnen, alles nachzuschlagen, was Clerk für einen Besucher aufgezeichnet hat, und ist nützlich, um Suchen, Recommendations und Seitenaufrufe zu debuggen. Jeder Eintrag zeigt, was aufgerufen wurde, welche Eingaben verwendet wurden, was die API zurückgegeben hat und den Kontext, der zur Entscheidungsfindung genutzt wurde.

Wo Sie es finden #

• Gehen Sie zu Data > Visitors in my.clerk.io.
• Fügen Sie eine Visitor-ID ein und wählen Sie Search Visitor aus.

Eine Visitor-ID erhalten #

Verwenden Sie den Visitor-ID-Endpunkt, um die ID für den Browser abzurufen, den Sie inspizieren möchten:

• Öffnen Sie den Shop im selben Browser, in dem Clerk aktiv ist.
• Besuchen Sie https://api.clerk.io/v3/misc/visitor_id oder rufen Sie den Visitor ID endpoint auf. Er gibt eine 8‑stellige ID wie SBWLDWSi zurück.
• Fügen Sie diese ID unter Data > Visitors ein.

Die Visitor-ID spiegelt eine anonyme Sitzung wider, wie in Data > Cookieless beschrieben. Wenn Sie das Gerät, den Browser oder das Netzwerk wechseln, kann die Visitor-ID unterschiedlich sein.

Was das Log anzeigt #

Für jede aufgezeichnete Aktion sehen Sie eine Zeile mit diesen Spalten:

• API: Der aufgerufene Endpunkt (zum Beispiel search/omni).
• Labels: Etwaige am Aufruf angehängte Labels (zum Beispiel die UI-Oberfläche wie “Omnisearch”).
• Input: An den Endpunkt gesendete Parameter. Beispiele sind die Suchanfrage, eine Produkt-ID, auf der Recommendations basieren, oder eine Kategorie-/Seitenkennung.
• Output: Von Endpunkten, die Ergebnisse liefern, zurückgegebene IDs (zum Beispiel Recommendations wie Popular, Category oder Alternatives). Aufrufe, die keine Ergebnisliste zurückgeben, lassen dieses Feld leer.
• Metadata: Kontext, der für den Aufruf verwendet wird, wie Sprache, URL, Filter, Template-IDs, angeheftete/ausgeschlossene Elemente und Synonymeinstellungen.
• Time: Wann das Ereignis eingetreten ist, neueste zuerst.

Typische Anwendungsfälle #

• Debug Search: Prüfen Sie die letzten search/omni-Aufrufe, um Abfrage, Filter und verwendete Sprache zu sehen und ob Ergebnisse zurückgegeben wurden.
• Verify Recommendations: Bestätigen Sie, welche Eingabe (Produkt/Kategorie/Seite) welche Ergebnis-IDs geliefert hat, und prüfen Sie etwaige Filter oder Pins.
• Validate Page Views: Überprüfen Sie Seiten- oder vorlagenbezogene Metadaten, um sicherzustellen, dass der richtige Kontext gesendet wird.

Tipps #

• Wenn Output leer ist, achten Sie in Metadata auf Filter, Sprache oder andere Einstellungen, die erklären könnten, warum es keine Übereinstimmung gab.
• Verwenden Sie die exakte Visitor-ID aus dem Browser/dem Sitzungskontext, in dem Sie das Verhalten beobachtet haben; verschiedene Sitzungen zeigen unterschiedliche Logs.
• Stellen Sie sicher, dass Clerk.js auf der Seite installiert ist, die Sie testen – ohne Aufrufe erscheint nichts im Log.