> ## Documentation Index
> Fetch the complete documentation index at: https://openrush.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Query your Google Ads

> All the ways OpenRush can read your connected Google Ads data.

OpenRush can read your own Google Ads data once you connect a Google account and activate an ad account.

This is measured data from Google, not an estimate. It reports the real spend, impressions, clicks, conversions, and conversion value your campaigns earned, read straight from Google Ads through Google's official API. OpenRush reads aggregate reporting data only. It never changes a campaign, budget, bid, or setting.

One tool, many angles on your paid performance.

## The tool

Everything below runs through a single tool: `get_ad_performance`.

You do not need to memorize it. Just ask your agent a normal question about your ads, and it picks the right settings for you.

<Note>
  This tool needs a connected Google Ads account with at least one activated ad account. Connect and activate in [Connections](https://www.openrush.com/dashboard/connections). If you have several activated ad accounts, name the one you mean.
</Note>

## What it measures

Every view returns the same core metrics for the whole account or for each row you break down by:

| Metric              | Meaning                                      |
| ------------------- | -------------------------------------------- |
| Spend               | What you paid, in the account's own currency |
| Impressions         | How often your ads were shown                |
| Clicks              | Paid clicks on your ads                      |
| CTR                 | Clicks divided by impressions                |
| Average CPC         | Spend divided by clicks                      |
| CPM                 | Spend per thousand impressions               |
| Conversions         | Conversions Google attributed to your ads    |
| Conversion value    | The value of those conversions               |
| Conversion rate     | Conversions divided by clicks                |
| Cost per conversion | Spend divided by conversions                 |
| ROAS                | Conversion value divided by spend            |

Every ratio is recomputed from the base counts, never averaged across rows, and every amount carries its currency.

## The dials

Every question is a mix of a few choices. Change them and you get a different view of the same account.

### 1. Report

What to break the performance down by. Leave it off for the rich overview, which is account totals plus your top campaigns, a daily trend, and a Google network split in one call.

| Value         | Answers                                                                 |
| ------------- | ----------------------------------------------------------------------- |
| `overview`    | Account totals, top campaigns, daily trend, and network split (default) |
| `campaign`    | Which campaigns drive spend and return, with each one's campaign type   |
| `ad_group`    | Which ad groups perform inside those campaigns                          |
| `asset_group` | Which asset groups perform, for Performance Max campaigns               |
| `ad`          | Which individual ads perform                                            |
| `keyword`     | Which keywords you bid on drive results (Search campaigns)              |
| `search_term` | Which actual searches triggered your ads (Search campaigns)             |
| `device`      | Desktop vs mobile vs tablet                                             |
| `network`     | Google Search vs search partners vs Display vs YouTube                  |
| `date`        | How performance trends over time                                        |

### 2. Time range

How far back to look.

| Value            | Meaning                  |
| ---------------- | ------------------------ |
| `last_7_days`    | The last week            |
| `last_28_days`   | The last month (default) |
| `last_3_months`  | The last quarter         |
| `last_6_months`  | Half a year              |
| `last_12_months` | A full year              |

### 3. Compare to

Whether to show the change against a past window.

| Value             | Meaning                                 |
| ----------------- | --------------------------------------- |
| `previous_period` | Versus the window just before (default) |
| `previous_year`   | Versus the same dates last year         |
| `none`            | No comparison                           |

### 4. Filter

Narrow to a slice before breaking it down. You can filter by campaign name (exact or contains), by device, or by network. You can also set how many rows come back.

## How many ways is that?

You can leave the overview as is or break down by any of nine dimensions, which is ten shapes. Multiply that by five time ranges and three comparison modes, and you get a hundred and fifty distinct views, before you add filters.

In short: if a question about your Google Ads can be answered from spend, clicks, conversions, or return, across campaigns, ad groups, keywords, devices, networks, or time, this tool can shape the query for it.

## Things you can just ask

* How is my ad spend performing this month compared to last?
* Which campaigns have the best and worst ROAS?
* Which search terms are spending money without converting?
* Is my cost per conversion better on mobile or desktop?
* How much of my spend goes to search partners and Display?
* How has daily spend and conversions trended over the last three months?
* Which asset groups in my Performance Max campaign drive conversions?

## Good to know

* Google Ads is account-based, not website-based. You activate the ad accounts your agents may read, and each call reads one account. If several are activated, name the one you mean.
* Every amount is in the account's own currency and is never converted. OpenRush never sums two currencies.
* Conversions use each conversion action's attribution model as configured in your Google Ads account, and can include modeled and view-through conversions. Every response says so, and cross-platform conversion totals should be read as directional.
* Every window is computed in the account's own reporting time zone, so your days line up with what you see in Google Ads.
* The most recent day or two is marked preliminary. Spend and conversions settle over a couple of days.
* Ad clicks are paid clicks. They are not Google Analytics sessions and not Search Console clicks. Use [website analytics](/docs/guides/website-analytics) and [search performance](/docs/guides/search-console) for those.
* Performance Max campaigns have no ad groups or ads. Their creative unit is the asset group, so use the `asset_group` report for them. Every campaign row says which type it is, and the tool's suggested next steps route you to the right breakdown.
* Keyword and search term reports cover Search campaigns only.
* Manager (MCC) accounts are supported. Connect the Google account that manages them, and every client account underneath appears for activation.
* This tool is read-only. It reports performance and never changes a campaign, budget, or bid.