Besucher

Übersicht #

Das Besucherprotokoll ermöglicht es Ihnen, alles nachzuschlagen, was Clerk für einen Besucher aufgezeichnet hat, und ist nützlich zum Debuggen von Suchen, Empfehlungen und Seitenaufrufen. 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 Besucher-ID ein und wählen Sie Search Visitor.

Besucher-ID erhalten #

Verwenden Sie den Visitor ID Endpoint, um die ID für den Browser zu erhalten, den Sie untersuchen möchten:

• Öffnen Sie den Shop im gleichen 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 in 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 Protokoll anzeigt #

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

• API: Der aufgerufene Endpoint (zum Beispiel search/omni).
• Labels: Alle Labels, die dem Aufruf zugeordnet sind (zum Beispiel die UI-Oberfläche wie “Omnisearch”).
• Input: An den Endpoint gesendete Parameter. Beispiele sind die Suchanfrage, eine Produkt-ID, auf der die Empfehlungen basieren, oder eine Kategorie-/Seitenkennung.
• Output: Von Endpoints zurückgegebene IDs, die Ergebnisse liefern (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 wurde, wie Sprache, URL, Filter, Template-IDs, angeheftete/ausgeschlossene Artikel und Synonymeinstellungen.
• Time: Wann das Ereignis stattgefunden hat, neueste zuerst.

Typische Anwendungsfälle #

• Debug Search: Untersuchen Sie aktuelle search/omni-Aufrufe, um die verwendete Abfrage, Filter und Sprache sowie zurückgegebene Ergebnisse zu sehen.
• Verify Recommendations: Bestätigen Sie, welcher Input (Produkt/Kategorie/Seite) welche Ergebnis-IDs erzeugt hat, und überprüfen Sie Filter oder Pins.
• Validate Page Views: Prüfen Sie seiten- oder templatebezogene Metadaten, um sicherzustellen, dass der richtige Kontext gesendet wird.

Tipps #

• Wenn Output leer ist, werfen Sie einen Blick in Metadata auf Filter, Sprache oder andere Einstellungen, die erklären können, warum nichts gefunden wurde.
• Verwenden Sie die exakte Visitor ID aus dem Browser/der Sitzung, in der Sie das Verhalten beobachtet haben; verschiedene Sitzungen zeigen unterschiedliche Protokolle.
• Stellen Sie sicher, dass Clerk.js auf der von Ihnen getesteten Seite installiert ist – ohne Aufrufe erscheint nichts im Protokoll.