Aggregate and per-customer analytics over your site's customer activity events.
Customer Activity analytics summarize the behavioral events your visitors and customers generate as they browse your site — page views, paywall displays, logins, registrations, subscriptions, and more. These endpoints let you (and the Pelcro AI Agent) ask aggregate questions over that activity for a site, or drill into a single customer's timeline.
Every endpoint is read-only, scoped to one site via site_id, and accepts a from/to (or days) window that is capped at 90 days (the customer activity retention window). Pass an optional user_id to scope an aggregation to a single customer belonging to the site.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /analytics/customers/activity/event-counts | Count Events |
GET | /analytics/customers/activity/top-pages | Top Pages |
GET | /analytics/customers/activity/top-referrers | Top Referrers |
GET | /analytics/customers/activity/conversion-by-dimension | Conversion Rate by Dimension |
GET | /analytics/customers/activity/journey | Customer Journey |
Breakdown dimensions
The group_by and dimension parameters accept a fixed set of values, each mapping to a single indexed field: page, referrer, country, platform, utm_source, utm_medium, utm_campaign.