# How your AI analyses marketing data

> How the AI's marketing tools pull data from Google Ads, Microsoft Advertising, Meta Ads, LinkedIn Ads, TikTok Ads, Search Console and GA4, with example questions to ask.

When you connect Google Ads, Microsoft Advertising, Meta Ads, LinkedIn Ads, TikTok Ads, Google Search Console or Google Analytics 4, your AI gets one shared set of marketing tools. The same tools work for all seven, so one question can cover every site, property and ad account you have connected. TikTok Ads is coming soon, once TikTok approves Plugsight's access.

You don't need to know the tool names. Ask in plain English and your AI picks the right tool. The names are shown here because your AI app may display them when it uses one.

> [!NOTE]
> Marketing and analytics connectors are on the **Pro** and **Agency** plans. The Free plan includes 1 marketing connection and 25 marketing tool calls a month to try them; every tool on this page counts as a marketing tool call, and calls that fail don't count.

## Which connectors these tools cover

| Connector | What the tools read |
| --- | --- |
| [Google Ads](https://docs.plugsight.app/connectors/google-ads.md) | Campaigns, ad groups, keywords, search terms, ads, products, locations, conversions and impression share |
| [Microsoft Advertising](https://docs.plugsight.app/connectors/microsoft-advertising.md) | The same kinds of data for Bing Ads, plus age, gender, audiences and Performance Max asset groups |
| [Meta Ads](https://docs.plugsight.app/connectors/meta-ads.md) | Facebook and Instagram campaigns, ad sets and ads: spend, reach, frequency, clicks, purchases, leads and ROAS, by age, gender, country, platform, placement and device |
| [LinkedIn Ads](https://docs.plugsight.app/connectors/linkedin-ads.md) | Campaign groups, campaigns and ads: spend, clicks, landing page clicks, website conversions, Lead Gen Form leads, engagement and ROAS |
| [TikTok Ads](https://docs.plugsight.app/connectors/tiktok-ads.md) (coming soon) | TikTok campaigns, ad groups and ads: spend, reach, clicks, conversions, purchases, ROAS and video views, by age, gender, country and device platform |
| [Google Search Console](https://docs.plugsight.app/connectors/google-search-console.md) | Organic clicks, impressions, CTR and position by query, page, country, device and search appearance |
| [Google Analytics 4](https://docs.plugsight.app/connectors/google-analytics-4.md) | Sessions, users, engagement, key events, revenue, ecommerce and any GA4 dimension or metric |

[Google Tag Manager](https://docs.plugsight.app/connectors/google-tag-manager.md), [YouTube](https://docs.plugsight.app/connectors/youtube.md) and [Google Merchant Center](https://docs.plugsight.app/connectors/google-merchant-center.md) have their own tools, described on their pages. [PageSpeed Insights](https://docs.plugsight.app/connectors/pagespeed-insights.md) works on every MCP server without a connection.

## The tools

### List marketing accounts (`list_marketing_accounts`)

Lists your marketing connections and everything they reach: Search Console sites, GA4 properties, Google Ads accounts (including client accounts under a manager), Microsoft Advertising accounts, Meta ad accounts, LinkedIn ad accounts and TikTok ad accounts. Your AI calls this first, to learn the names and ids of your accounts.

- Hidden sites and accounts are left out. See [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md).
- The list is kept for 15 minutes. Your AI can ask for a fresh list if you have just added an account at Google, Microsoft, Meta, LinkedIn or TikTok.
- If a service didn't answer, the list includes the error, so your AI can tell you.

### List data fields (`list_marketing_fields`)

Shows every field your AI can ask for, for one connector, split into **dimensions** (what you group by, such as campaign, keyword, query or landing page) and **metrics** (the numbers, such as cost, clicks or sessions). Your AI uses it to pick the right fields before pulling data.

Some metrics are worked out from others: CTR, CPC, CPM, CPA, ROAS and conversion rate. These are recalculated after rows are combined, so they stay correct when you add several accounts together.

For GA4, any GA4 field name also works, including your custom dimensions and metrics.

### Get marketing data (`get_marketing_data`)

The main tool. It pulls any mix of dimensions and metrics from one connector, for one account, several, or all of them at once, and returns a table with totals. Plugsight picks the right report automatically: asking for search terms uses the search-term report, asking for keywords uses the keyword report.

What your AI can set:

| Setting | What it does | Default |
| --- | --- | --- |
| Accounts | Which accounts, properties or sites to include | All visible ones |
| Date range | A preset (today, yesterday, last 7, 14, 28, 30, 90, 180 or 365 days, this month, last month, this year, last year) or exact dates | Last 30 days |
| Filters | Conditions such as "conversions equal 0" or "cost greater than 20". Text matching ignores capital letters. All filters must match | None |
| Order | Which column to sort by | The first metric, highest first |
| Row limit | How many rows come back, after sorting | 500 (up to 50,000) |
| Rows per account | How many rows are fetched from each account before combining | 100,000 (100 to 500,000) |
| Totals | Whether to add a totals row | On |

Extra options:

- **Search Console**: the search type (web, image, video, news, Discover or Google News), and whether to include fresh, not-yet-final data (included by default).
- **Google Ads**: whether to include removed campaigns.

"Last 30 days" means the 30 full days before today. Dates use UTC.

Meta Ads and TikTok Ads read at most 10,000 rows per ad account for each question. Raising **Rows per account** can't lift that. When an answer says it's partial, ask again for a shorter date range, fewer breakdowns or fewer ad accounts.

LinkedIn Ads returns at most 15,000 rows per ad account for each question. When an answer says it's partial, ask again for a shorter date range, monthly instead of daily rows, or campaigns instead of ads.

#### Rows from several accounts

When you ask about several accounts, rows with the same values are added together. For example, the same search term in two accounts becomes one row. To see each account separately, ask your AI to split by account ("show it per account").

If your accounts use different currencies, money is added as-is and your AI is told so. Ask it to split by account or currency to keep them apart.

#### Data notes

Google and Microsoft sometimes hold data back. When that affects an answer, Plugsight adds a note your AI can pass on, for example:

- Google Ads hides low-volume search terms for privacy. Their cost is in campaign totals but not in the search-term rows.
- Search Console hides rare queries. The note says what share of clicks and impressions that is.
- Search Console data becomes final about 2–3 days after the date, so the latest days may still grow.
- GA4 can apply data thresholds (for example with age and gender), sample results, or group rare values into "(other)".
- GA4's daily API quota is running low.
- A report stopped at the per-account row limit.

### Deep dives (`marketing_deep_dive`)

Ready-made analyses that run several queries and return findings plus tables.

| Deep dive | What it finds | Works with |
| --- | --- | --- |
| Account overview | Every connected platform and account, this period against the previous one: spend, conversions, CPA, ROAS, organic clicks, sessions and revenue | All four |
| Wasted spend | Search terms and keywords that cost money without converting, the share of budget wasted, and negative-keyword candidates | Google Ads, Microsoft Advertising |
| Scale opportunities | Campaigns and keywords at or below your average CPA that lose impression share to budget or rank | Google Ads, Microsoft Advertising |
| Search term winners | Converting search terms that aren't keywords yet | Google Ads, Microsoft Advertising |
| Quality score audit | Spend by quality score, and which part (expected CTR, ad relevance or landing page) drags low scores down | Google Ads, Microsoft Advertising |
| Paid vs organic | Where you pay for clicks on queries you already rank top 3 for, paid winners with weak SEO, and organic queries worth a paid test | Google Ads or Microsoft Advertising, with Search Console |
| SEO opportunities | Queries just off page one, page-one results with low CTR, and pages losing clicks | Search Console |
| Period comparison | Any metrics, this period against the previous period or the same period last year, with the biggest gains and drops | Any of the four |

Defaults your AI can change: the last 30 days, compared with the previous period; at least 10 in spend for wasted-spend lists; at least 1 conversion for winners and scale reports; at least 100 impressions for SEO reports; 25 rows per table (up to 1,000). Ad reports use Google Ads unless you ask for Microsoft Advertising.

### Tools for questions reports can't answer

| Tool | What it does |
| --- | --- |
| `search_console_inspect_url` | How Google sees one URL: whether it's indexed, last crawl, canonical, mobile usability and rich results |
| `search_console_sitemaps` | Sitemaps submitted for a site, with submitted and indexed counts, errors and warnings |
| `analytics_realtime` | GA4 activity in the last 30 minutes, for example active users by country or page |
| `analytics_key_events` | The events a GA4 property counts as key events (conversions), and how many happened in a period |
| `analytics_funnel` | A funnel of 2 to 10 steps (events or page visits), showing how many users reach each step and where they drop off. Can be split by device or channel |
| `analytics_metadata` | Every dimension and metric a GA4 property offers, including its custom ones |
| `google_ads_query` | Runs a read-only Google Ads Query Language (GAQL) query against one account, for anything else. Only SELECT queries are allowed |
| `microsoft_ads_campaigns` | Campaign settings in a Microsoft Advertising account: status, type, budget and bidding strategy |
| `meta_ads_campaigns` | Campaign settings in a Meta ad account: status, objective, budget and bid strategy |
| `linkedin_ads_campaigns` | Campaign settings in a LinkedIn ad account: status, type, objective, campaign group, budget, bid and schedule |
| `tiktok_ads_campaigns` | Campaign settings in a TikTok ad account: status, objective and budget |

## Example questions

**Across everything**

- "Give me an overview of all my marketing accounts this month against last month."
- "Compare spend, conversions and CPA by platform for the last 90 days."

**Paid search**

- "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?"
- "Which keywords have a quality score of 5 or less, and is expected CTR or the landing page the problem?"
- "Which converting search terms aren't keywords yet?"
- "Across all client accounts, which ones spent more than 20% over last month?"

**SEO**

- "Which queries rank in positions 4–20 with the most impressions?"
- "Which page-one results get much lower CTR than expected for their position?"
- "Is https://example.com/pricing indexed, and if not, why?"
- "Where are we paying for Google Ads clicks on queries we already rank top 3 for?"

**Analytics**

- "Which channels drove the most revenue this month vs last month?"
- "Build a funnel from product page to purchase and show where mobile users drop off."
- "How many people are on the site right now, and from which countries?"
- "What counts as a conversion in this GA4 property, and how many happened last week?"

> [!TIP]
> With several accounts, name the one you mean: "for Bright Dental's Google Ads" or "on the shop's GA4 property". Clear connection names on **Connections** make this easier.

## Common messages

### Unknown field "…" for Google Ads. Call list_marketing_fields.

**What it means:** Your AI asked for a field that connector doesn't have. The message may suggest similar names.

**How to fix it:** Usually your AI corrects itself. If not, ask it to "list the available fields first".

### These fields come from different Google Ads reports and can't be combined in one query

**What it means:** Some fields live in separate reports at Google or Microsoft (for example search terms and quality score) and can't be pulled together.

**How to fix it:** Ask for them in two separate questions. The same applies to the Microsoft Advertising version of this message.

### No Google Ads accounts are connected and visible.

**What it means:** None of the MCP server's connections reach an account of that type, or every one is hidden.

**How to fix it:** Check the connection is in this MCP server, and show the account again under **Show sites & accounts** on **Connections**.

### No connection in this MCP reaches Google Analytics 4 "…" (or it is hidden).

**What it means:** The site, property or account named isn't reachable by this MCP server, or you have hidden it.

**How to fix it:** Check the id is right, that the account is visible, and that its connection is part of this MCP server. If you added it at Google minutes ago, use **Refresh list** on **Connections**.

### This report needs connector google_ads or bing_ads.

**What it means:** Wasted spend, scale opportunities, search term winners and quality score audit only work for ad platforms.

**How to fix it:** Ask for the report on Google Ads or Microsoft Advertising.

### period_comparison needs fields, e.g. [campaign, cost, conversions, cpa].

**What it means:** A period comparison needs to know what to compare.

**How to fix it:** Say what you want compared, for example "compare cost and conversions by campaign with last month".

### Report … still pending after 2 minutes; try a shorter date range.

**What it means:** Microsoft builds reports on request, and a long range took too long.

**How to fix it:** Ask for a shorter date range.

## Related articles

- [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md)
- [Google Ads](https://docs.plugsight.app/connectors/google-ads.md)
- [Microsoft Advertising](https://docs.plugsight.app/connectors/microsoft-advertising.md)
- [Meta Ads](https://docs.plugsight.app/connectors/meta-ads.md)
- [LinkedIn Ads](https://docs.plugsight.app/connectors/linkedin-ads.md)
- [TikTok Ads](https://docs.plugsight.app/connectors/tiktok-ads.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)

---

Web version: https://docs.plugsight.app/connectors/marketing-data
