Track User Activity
The User Activity Feed turns raw traces into a per-user activity log: every event a visitor produced — session starts, queries, answers, reactions, and any custom events you send — in one time-ordered list you can filter by user. Open Analytics (global) or an assistant's or search center's Analytics and scroll to the User Activity Feed panel below Conversations.
Identify Your Users
Activity is grouped and filtered by the userId you pass to the assistant embed. This is the single field that identifies a visitor — pass your own system's stable id so the same person is one identity across sessions and devices:
window.skdwn.startAssistant({
assistantId: "as-xxxx",
accessToken: "…",
serviceURL: "https://…",
userId: "user-12345", // ← the identity the Activity feed groups by
userInformation: { // ← optional, only to show a friendlier label
email: "ada@example.com",
name: "Ada Lovelace"
}
});
- The identity is the key. It is what every event is grouped and filtered by.
Provide it in one of two ways: the explicit userId option, or an id field inside userInformation — an explicit userId wins when both are present. If you provide neither, Seekdown falls back to a random per-browser id stored in localStorage, so the same person on two browsers looks like two users. Set your own id to track people reliably.
- The rest of
userInformationis only the label. When you passemail(or
name), the feed shows that instead of the raw id — the id stays available on hover. It never changes what the feed groups by; that is always the identity id.
Read the Feed
Each row is one event:
| Column | What it shows |
|---|---|
| Time | When the event happened (newest first). |
| Event | The event name — a built-in one (e.g. Query.Launched) or your own custom event. |
| User | The visitor's email/name when provided, otherwise their userId (shown on hover). |
| Source | Which assistant produced the event (global view only). |
| Details | The event's custom properties, shown inline on the row. |
Filter to a single visitor with the searchable Filter by user dropdown, or click the filter icon next to any user to jump straight to their activity. Use Export CSV to download the full feed.