Only when the GAM link is active
Linked Analytics fields in GAM REST
Use Google Analytics fields that Google Ad Manager exposes inside HISTORICAL reports after the Analytics link is active.
"In GAM REST, if linked Analytics fields are available, show the last 30 days by DATE, PAGE_PATH and PAGE_TITLE_AND_SCREEN_NAME. Include SESSIONS, ACTIVE_USERS, GOOGLE_ANALYTICS_VIEWS and GOOGLE_ANALYTICS_REVENUE. If one field is unavailable, name it and continue with the remaining GAM fields."
A GAM REST report that explains page and session context using fields returned by Google Ad Manager, not a GA4 Data API call.
Agent workflow
- 01
Check get_report_dimensions and get_report_metrics for REST fields compatible with HISTORICAL.
- 02
Run run_custom_report with api='rest' and report_type='HISTORICAL'.
- 03
Explain missing or empty linked fields as a GAM link/data availability issue, not an OrbiAds GA4 connector issue.
MCP functions
Parent MCP call shown with the reporting action.
| Function | Cost | Purpose |
|---|---|---|
reporting(action="get_report_dimensions") | 0 cr | Checks GAM REST dimensions. |
reporting(action="get_report_metrics") | 0 cr | Checks linked Analytics metrics exposed by GAM. |
reporting(action="run_custom_report") | 0.5 cr | Runs the GAM REST HISTORICAL report. |
JSON payload
{
"tool": "reporting",
"arguments": {
"action": "run_custom_report",
"params": {
"api": "rest",
"report_type": "HISTORICAL",
"date_range_type": "LAST_30_DAYS",
"dimensions": [
"DATE",
"PAGE_PATH",
"PAGE_TITLE_AND_SCREEN_NAME"
],
"metrics": [
"SESSIONS",
"ACTIVE_USERS",
"GOOGLE_ANALYTICS_VIEWS",
"GOOGLE_ANALYTICS_REVENUE"
]
}
}
}Representative output
- DATE=2026-06-08 | PAGE_PATH=/sports/live | SESSIONS=18,420 | GOOGLE_ANALYTICS_REVENUE=EUR 642.80.
- PAGE_TITLE_AND_SCREEN_NAME=Live scores | ACTIVE_USERS=12,940 | GOOGLE_ANALYTICS_VIEWS=31,220.
- Note: PAGE_PATH is a linked Analytics field exposed by GAM REST; no GA4 report was queried.
Dimensions and metrics
| Name | Source | Description |
|---|---|---|
| DATE | GAM | Report day |
| PAGE_PATH | GAM | Linked Analytics page path exposed by GAM |
| PAGE_TITLE_AND_SCREEN_NAME | GAM | Linked Analytics page title / screen name exposed by GAM |
| Name | Source | Description |
|---|---|---|
| SESSIONS | GAM | Sessions exposed in GAM reporting |
| ACTIVE_USERS | GAM | Active users exposed in GAM reporting |
| GOOGLE_ANALYTICS_VIEWS | GAM | Views joined into GAM reporting |
| GOOGLE_ANALYTICS_REVENUE | GAM | Analytics revenue joined into GAM reporting |
Limits
- The Analytics link must already be active and visible in Google Ad Manager reporting.
- OrbiAds does not call the GA4 Data API here and does not need a GA4 property ID.
- Google Ads campaign cost, bids, keywords and native clicks are not available from this workflow.
- Use get_report_result for the full cached result when the inline response is truncated.
Use the editorial guide for the audience framing, then come back here for exact MCP actions, fields and payloads.