Get Google Ads insights (adsap_google_get_insights)
Platform: Google Ads · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Reports Google Ads performance at campaign, ad group or keyword level for a date range. You get an account summary with a previous-period comparison, a sortable table per entity, and an optional daily series. Metrics cover cost, clicks, conversions, value, video views, engagement and Search impression share.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
level | one of campaign, ad_group, keyword | No | Aggregation level of the table rows (default campaign). ad_group and keyword ride the same cached sync: no extra API budget. |
ad_account_id | string | Yes | Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). |
date_preset | one of today, yesterday, last_7d, last_14d, last_30d, this_month, last_month | No | Date range preset (default last_7d). Ignored when date_from/date_to are set. |
date_from | string | No | Custom range start, YYYY-MM-DD. Use with date_to. |
date_to | string | No | Custom range end, YYYY-MM-DD. Use with date_from. |
sort_column | one of entity_name, cost, impressions, clicks, conversions, conversions_value, roas, ctr and 29 more | No | Entity-table sort column. |
sort_dir | one of asc, desc | No | |
limit | number | No | Entity-table page size. |
cursor | string | No | |
include_timeseries | boolean | No | Also return a per-day timeseries for the current range (for trend questions / charts). |
refresh | boolean | No | Force a refresh from the Google Ads API even if the cache is fresh. Spends Google API budget. |
Example prompts
- “How did my Google Ads perform last week compared with the week before?”
- “Show me my top 10 keywords by conversions this month, with quality score.”
- “Give me a daily cost and conversion trend for my Search campaigns since September 1.”
- “Which Google campaigns are losing impression share to budget?”
Notes
Impression share figures are Search-only and read 0 for Display, Performance Max and video delivery. Lost share to budget exists at campaign level only. Only entities with impressions in the range appear.
Related tools
adsap_google_get_account_activities: Change history for a Google Ads account: who changed what, and when.
Guide
Read Insights and reporting for the workflow around this tool, and the Tool reference for every tool.