Explain a traffic change
explain_traffic_changeCompare traffic against prior, year-over-year, or custom periods and rank shifts by page, referrer, country, device, channel, and event. Results show association, not causation.
Instructions
Compare traffic with a previous, year-over-year, or custom period and rank observed changes across pages, referrers, countries, devices, channels, and events. Results describe association, not causation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"websiteId": "<websiteId>",
"start": "<start>",
"end": "<end>"
},
"name": "explain_traffic_change"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Unix milliseconds, ISO 8601 with timezone, or YYYY-MM-DD (UTC) | |
| limit | No | ||
| start | Yes | Unix milliseconds, ISO 8601 with timezone, or YYYY-MM-DD (UTC) | |
| filters | No | ||
| timezone | No | UTC | |
| websiteId | Yes | Umami UUID | |
| dimensions | No | ||
| comparisonEnd | No | Unix milliseconds, ISO 8601 with timezone, or YYYY-MM-DD (UTC) | |
| comparisonMode | No | previous | |
| trafficSegment | No | all | |
| comparisonStart | No | Unix milliseconds, ISO 8601 with timezone, or YYYY-MM-DD (UTC) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | JSON analytics data returned by Umami Compass | |
| meta | Yes |