> ## Documentation Index
> Fetch the complete documentation index at: https://agents.concierca.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Events

> Raw website behaviour events — page views and actions with session, source, and device context. Agent-maintained.

## What it is

The stream of what happens on your website. One row per event — a page view or a tracked action — with the URL, the session it belongs to, where the visitor came from, the device they used, and a reference to the visitor. It is the raw behavioural layer you use to understand traffic and on-site behaviour.

## How it gets data

Populated by marketing agents and connectors (e.g. your analytics/tracking integration); not part of the standard onboarding catalog. Each row carries an `external_id` dedup key, so re-syncing the same event updates the row instead of duplicating it. Available to query once your workspace runs the relevant agents.

## Fields

| Field           | Type     | Description                                        |
| --------------- | -------- | -------------------------------------------------- |
| `external_id`   | text     | Source event id — the dedup/upsert key             |
| `event_name`    | text     | The event (e.g. page\_view, add\_to\_cart)         |
| `url`           | text     | Page URL the event happened on                     |
| `session_id`    | text     | Session the event belongs to                       |
| `source`        | text     | Traffic source / referrer                          |
| `device`        | text     | Device type (e.g. desktop, mobile)                 |
| `user_ref`      | text     | Reference to the visitor, when known               |
| `timestamp_ext` | datetime | When the event happened, as reported by the source |

<Note>
  Also carries the system columns `id`, `tenant_id`, `workspace_id` (tenant isolation), `created_at`, and `updated_at`. They are managed automatically.
</Note>

## Query it

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "data_query",
    "arguments": {
      "view_slug": "web_events",
      "filters": { "event_name": "page_view" },
      "select_fields": ["event_name", "url", "session_id", "source", "device", "timestamp_ext"],
      "sort_by": "timestamp_ext",
      "limit": 50
    }
  }
}
```