Read traffic breakdown
get_google_analytics_traffic_breakdownThe Traffic Insights tabs from Google Analytics, with the same numbers as the page: channels (channel, source and medium, or campaign), ai_assistants (visits from AI assistants by source, landing page or key event), key_events, countries_devices (country, device, region or city) and pages. Every row comes with the period before it and the totals, and the text says when Google sampled, hid or folded numbers. Read only and free. Defaults to the last 28 complete property days.
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": {
"projectId": "<projectId>",
"tab": "<tab>"
},
"name": "get_google_analytics_traffic_breakdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab | Yes | The Traffic Insights tab: channels, ai_assistants (visits from AI assistants), key_events, countries_devices or pages. | |
| group | No | How the tab groups its rows. channels: channel_group, source_medium, campaign; ai_assistants: source, landing_page, key_event; key_events: event, event_and_landing_page; countries_devices: country, device, region, city; pages: page. The first one of the tab is the default. | |
| device | No | Only this device: desktop, mobile or tablet. | |
| medium | No | Only sessions whose medium contains this text, in any case. | |
| source | No | Only sessions whose source contains this text, in any case. | |
| country | No | Only this country, as its two-letter ISO code, for example DE. | |
| endDate | No | Inclusive date as YYYY-MM-DD. Give both startDate and endDate, or neither for the last 28 complete property days. | |
| campaign | No | Only sessions whose campaign contains this text, in any case. | |
| keyEvent | No | Count only this key event (for example purchase) in the key event columns, instead of all key events. Not for the key events report, which lists them by name. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | Inclusive date as YYYY-MM-DD. Give both startDate and endDate, or neither for the last 28 complete property days. | |
| channelGroup | No | Only this Google default channel group by its exact name, for example Paid Search, Organic Social or AI Assistant. Pass channel=all where the tool has it, or Organic Search is all that is read. | |
| pageContains | No | Only pages whose address contains this text, in any case. Not for site search or ecommerce by item. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | ||
| error | No | ||
| group | No | ||
| state | No | ||
| folded | No | ||
| period | No | ||
| status | Yes | ||
| totals | No | ||
| metrics | No | ||
| sampled | No | ||
| truncated | No | ||
| thresholded | No |