# Google Ads

> Connect Google Ads so your AI can analyse campaigns, keywords, search terms and conversions across every account, including MCC clients.

Connect Google Ads and your AI can answer questions about campaigns, keywords, search terms, ads and conversions in every Google Ads account your Google login can open, including client accounts under a manager (MCC) account. Plugsight only reads: it never changes campaigns, bids, budgets or keywords.

## What your AI can do

- Report on campaigns, ad groups, keywords, search terms, ads, products and locations, for any date range.
- Show cost, clicks, impressions, conversions, conversion value, CPA, ROAS and CTR.
- Show quality score and its three parts: expected CTR, ad relevance and landing page experience.
- Show impression share and the share lost to budget or rank.
- Break results down by device, network, location, landing page, hour, day of the week, week, month, quarter or year.
- Add up several accounts in one answer, or compare them side by side.
- Run ready-made deep dives: wasted spend, scale opportunities, search term winners, quality score audit, paid vs organic, and period comparison.
- Run any read-only Google Ads Query Language (GAQL) query for anything else.

See [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md) for how these tools work.

### Example questions

- "Which search terms cost us money last month without converting? Suggest negative keywords."
- "Which keywords convert below our average CPA but lose impression share to budget?"
- "Compare CPA and ROAS by campaign this month vs last month."
- "Which keywords have a quality score of 5 or less, and is expected CTR or the landing page the problem?"
- "Across all client accounts, which ones spent more than 20% over last month?"

## What you need

- A **Pro** or **Agency** plan, or the Free plan to try it: Free includes 1 marketing connection and 25 marketing tool calls a month. See [Plans](https://docs.plugsight.app/get-started/plans.md).
- A Google account that can open your Google Ads accounts. If you manage clients, sign in with the account that has access to your manager (MCC) account: Plugsight finds every client under it.

## Connect Google Ads

1. Open **Connections** and click **Add connection**.
2. Choose **Google Ads**.
3. Read **What happens next** and click **Continue to Google**.
4. Choose the Google account that can see your ad accounts.
5. If Google says **"Google hasn't verified this app"**, click **Advanced**, then **Go to Plugsight (unsafe)**. Google shows this while it reviews new apps; it doesn't mean anything is wrong.
6. Google asks: "See, edit, create and delete your Google Ads accounts and data". Tick the box and continue. Without the tick, the connection can't work.
7. You're back on **Connections**, with a message such as "Connected you@example.com: 12 Google Ads accounts."

> [!NOTE]
> Google offers no read-only permission for Google Ads, so it asks for full access. Plugsight only ever reads from it.

Then add the connection to an MCP server (or use a server set to **All accounts**). If this is your first marketing connection, [refresh the tools list](https://docs.plugsight.app/ai-apps/refresh-tools.md) in your AI app and start a new chat.

To choose which accounts your AI can see, click **Show sites & accounts** next to the connection. See [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md).

## What it can and can't change

Google Ads is **read-only** in Plugsight. Your AI can't pause campaigns, change bids or budgets, add keywords or edit ads. The **Write access** column shows **Read-only** and there is no switch to turn changes on.

## Limits

- **Manager accounts** can't report their own metrics. Your AI reports on the client accounts under them instead.
- **Search terms**: Google hides low-volume search terms for privacy. Their cost is still in campaign totals, but not in search-term rows. Your AI is told when this affects an answer.
- **Currencies**: accounts in different currencies are added as-is, and your AI is told so. Ask it to split results by account.
- **Removed campaigns** are left out unless you ask for them.
- **Rows**: up to 100,000 rows are fetched per account by default (up to 500,000), and up to 50,000 rows are returned. GAQL queries return up to 50,000 rows.
- Some fields come from separate Google Ads reports and can't be pulled together in one question.

## Troubleshooting

### Marketing and analytics connectors (Google Ads, Microsoft Ads, Search Console, GA4 and others) are on the Pro plan. Upgrade under Billing to connect them.

**What it means:** Your plan doesn't include marketing connectors. In the catalog, the tile says **On Pro: upgrade to connect**.

**How to fix it:** Upgrade to Pro or Agency on **Billing**, then connect again.

### The Google Ads tile says Unavailable

**What it means:** Google Ads isn't set up on this Plugsight server.

**How to fix it:** Contact info@plugsight.app.

### "…the Google Ads developer token only has test access, so real ad accounts are blocked."

**What it means:** Google is only allowing test accounts for now.

**How to fix it:** Contact info@plugsight.app. Your connection is saved and starts working once the access is approved; then click **Refresh list**.

### Google Ads access wasn't granted. Tick the permission and try again.

**What it means:** The permission box on Google's screen wasn't ticked.

**How to fix it:** Connect again and tick the box at step 6.

### You didn't allow access in Google. Click Connect again and allow it, ticking every permission box.

**What it means:** You clicked **Cancel** or didn't allow access on Google's screen.

**How to fix it:** Connect again and allow access.

### Google returned no refresh token. Remove the app's access in your Google account and try again.

**What it means:** Google didn't give Plugsight lasting access, usually because access was granted before.

**How to fix it:** In your Google account's security settings, remove Plugsight's access, then connect again.

### The Google sign-in expired before it finished. Click Connect and sign in again.

**What it means:** The sign-in page was left open too long.

**How to fix it:** Start again from **Add connection**.

### "customer 123…: …" when listing accounts

**What it means:** One of the accounts your login can open didn't answer. Cancelled or suspended accounts often show up this way.

**How to fix it:** You can ignore it for cancelled accounts. Otherwise click **Refresh list**, or check the account in Google Ads.

### Reconnect needed: "Google sign-in was revoked or has expired."

**What it means:** Google stopped accepting the login, for example after a password change or after access was removed in your Google account.

**How to fix it:** Click **Reconnect** next to the connection. Your settings and MCP servers stay as they are.

### My AI doesn't see Google Ads

**What it means:** The connection isn't in the MCP server you're using, the account is hidden, or your AI app hasn't loaded the marketing tools yet.

**How to fix it:** Check the MCP server reaches this connection, check the account shows **Visible**, then [refresh the tools list](https://docs.plugsight.app/ai-apps/refresh-tools.md) in your AI app and start a new chat.

## Related articles

- [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md)
- [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md)
- [Microsoft Advertising](https://docs.plugsight.app/connectors/microsoft-advertising.md)
- [Google Search Console](https://docs.plugsight.app/connectors/google-search-console.md)
- [Google Analytics 4](https://docs.plugsight.app/connectors/google-analytics-4.md)
- [Bing Webmaster Tools](https://docs.plugsight.app/connectors/bing-webmaster.md)

---

Web version: https://docs.plugsight.app/connectors/google-ads
