google_ads_get_audience_report

Get Google Ads Audience Report

Google

Description

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_audience_report",
    "arguments": {}
  }
}

Parameters

NameTypeRequiredDescription
customer_id string Required The Google Ads Customer ID (10 digits, with or without dashes)maxLength: 20, pattern: ^[\d-]+$
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (15)
NameTypeRequiredDescription
login_customer_id string Optional MCC (Manager) Customer ID; required for managed accountsmaxLength: 20, pattern: ^[\d-]+$
level string Optional AD_GROUP (default): one row per ad group × criterion. CAMPAIGN: audiences attached at campaign level, and demographic buckets summed per campaign.
AD_GROUP CAMPAIGN
dimensions array Optional What to report on (default ["AUDIENCE"]): AUDIENCE (user lists incl. lookalikes, interests and detailed demographics, custom segments, combined audiences, life events, Demand Gen audiences), AGE_RANGE, GENDER, PARENTAL_STATUS, INCOME_RANGE. Pass several to get them in one call; each row carries its `dimension`.
date_preset string Optional Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH. LAST_7_DAYS / LAST_30_DAYS are the 7 / 30 complete days ending yesterday (account time zone), as in Google Ads; THIS_MONTH runs through today. Defaults to LAST_30_DAYS when neither date_preset nor date_range is given.
TODAY YESTERDAY LAST_7_DAYS LAST_30_DAYS THIS_MONTH LAST_MONTH
date_range object Optional Custom date range {start_date, end_date} in YYYY-MM-DD
segments array Optional Split each row by date and/or device. Omit for window totals.
campaign_ids array Optional Only these campaigns (up to 100 IDs)
ad_group_ids array Optional Only these ad groups (up to 100 IDs). AD_GROUP level only; refused at CAMPAIGN level.
criterion_types array Optional AUDIENCE dimension only: keep these criterion types, e.g. ["USER_LIST","CUSTOM_AUDIENCE"].
include_zero_activity boolean Optional Also list attached, non-removed criteria with no impressions in the window, to check whether an audience is serving at all.
include_all_conversions boolean Optional Add all_conversions, all_conversions_value and view_through_conversions per row, plus an all-conversions breakdown by conversion action.
include_video_metrics boolean Optional Add video metrics per row: video_trueview_views, video_trueview_view_rate, trueview_average_cpv and the 25/50/75/100% quartile rates (YouTube / Video / Demand Gen video).
limit integer Optional Rows per page (1-500, default 25, or 15 with include_all_conversions or include_video_metrics). The defaults keep a page within MCP client response limits: follow nextCursor for more rather than raising limit.min: 1, max: 500
cursor string Optional Opaque cursor from the previous response's nextCursor. Pass it with the same other parameters to fetch the next page; do not construct it.minLength: 1, maxLength: 4096
connection_id string Optional Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.