# Get Google Ads insights (adsap_google_get_insights)

Reports Google Ads performance at campaign, ad group or keyword level for a date range.

Canonical: https://adsap.ai/docs/tools/adsap_google_get_insights
Updated: 2026-09-13

**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](/guides/insights) for the workflow around this tool, and the [Tool reference](/tools) for every tool.