top_change
Identify accounts or groups with the largest visit increases or decreases between consecutive time periods to monitor usage trends and subscription impacts.
Instructions
Find top N accounts or groups with highest visit/usage increase or decrease between two consecutive time periods. Returns items ranked by change with current period count, previous period count, absolute change, and percentage change. The previous period is automatically calculated to match the duration of the current period, ending where the current period starts. Supports filtering by subscription tier.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| groupBy | Yes | Group by: "account" to find top accounts by visit change, "group" to find top groups by visit change | |
| direction | Yes | Direction: "increase" for highest growth, "decrease" for highest decline | |
| topN | No | Number of top items to return (default: 5, max: 50) | |
| startDate | No | Start date for current period in ISO format (YYYY-MM-DD) or date math (e.g., "now-30d", "now-1y"). Defaults to "now-30d" | |
| endDate | No | End date for current period in ISO format (YYYY-MM-DD) or date math (e.g., "now"). Defaults to "now" | |
| subscription | No | Optional subscription tier to filter by |