reporting
Extract delivery, custom, and forecast reports from Google Ad Manager and Google Analytics 4. Access traffic data, billing summaries, and reusable report templates.
Instructions
Full GAM and GA4 reporting — delivery reports, custom reports, forecasting, traffic data, and billing.
MODE: read-only (reports are read operations; report templates are saved configuration) AUTH: OAuth 2.0 required CREDITS: 0 (free) OUTPUT: Delivery/custom reports return rows of dimension+metric values. Forecasts return estimated_impressions, estimated_clicks, and confidence intervals. Report templates return template objects for reuse. WHEN TO USE: Use reporting for all data extraction and analysis. Use reporting_skill for high-level multi-step reporting workflows described in natural language. • For delivery analysis: check_delivery_status or fetch_delivery_report. • For custom ad-hoc reports: run_custom_report. • For forecasting: get_standalone_forecast or get_delivery_forecast_by_line_item. • For GA4 data: run_ga_report. • For reusable reports: save/run report templates. LIMITATIONS: Some SOAP-era metrics (TOTAL_*, AD_SERVER_ALL_REVENUE) and dimensions (MONTH_AND_YEAR, CREATIVE_SIZE) are rejected by the REST API. Use get_report_dimensions/get_report_metrics to discover valid options.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Sub-operation to perform: • check_delivery_status: Check delivery status (actual vs booked) for an order or line item. Returns pacing indicator. • fetch_delivery_report: Fetch a delivery report for a date range. Returns impressions, clicks, CTR by line item. • run_custom_report: Run an ad-hoc report with specified dimensions and metrics. Returns result rows. • fetch_inventory_report: Fetch an inventory forecast report for ad units. Returns available impressions. • get_report_result: Retrieve the result of a previously run report by report_id. • export_report_csv: Export a report result as a CSV download URL. • get_report_dimensions: List valid dimension names for custom reports. Use to discover available breakdown options. • get_report_metrics: List valid metric names for custom reports. Use to discover available measurements. • get_report_date_ranges: List valid relative date range strings (LAST_7_DAYS, LAST_MONTH, etc.). • get_standalone_forecast: Get a forecasted impression estimate for a targeting specification without an existing line item. • get_delivery_forecast_by_line_item: Get a delivery forecast for one or more existing line items. • get_prospective_delivery_forecast: Get a prospective forecast for a hypothetical line item configuration. • get_traffic_data: Get historical traffic data (impressions available) for targeting criteria. • list_report_templates: List saved report templates. Read-only. • save_report_template: Save a report configuration as a reusable template. Write. • delete_report_template: Delete a report template. Destructive write. • duplicate_report_template: Duplicate a report template. Write. • update_report_template: Update a saved report template. Write. • run_report_from_template: Run a report using a saved template. Returns report_id for async result retrieval. • list_gam_reports: List reports saved in the GAM UI. Read-only. • get_gam_report: Get a specific GAM report by ID. Read-only. • create_gam_report: Create a new report in GAM. Write. • update_gam_report: Update a GAM report configuration. Write. • delete_gam_report: Delete a GAM report. Destructive write — uses soft-delete (PATCH visibility=HIDDEN). • run_gam_report: Run a GAM report and return result rows. • run_ga_report: Run a GA4 report for connected Google Analytics data. • get_ga_dimensions: List valid GA4 dimension names. • get_ga_metrics: List valid GA4 metric names. • check_underdelivery_alerts: Check for active underdelivery alerts across all line items. Returns affected line items with severity. • check_budget_alerts: Check for budget pacing alerts. Returns line items at risk of overspending. • generate_billing_report: Generate a billing summary report for a date range. Returns revenue by advertiser and line item. | |
| network_code | No | GAM network code (e.g. 12345678). Required for all network-scoped operations. Obtain via select_gam_network or list_accessible_networks. |