PlugsightDocs

How your AI analyses marketing data

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

When you connect Google Ads, Microsoft Advertising, Google Search Console or Google Analytics 4, your AI gets one shared set of marketing tools. The same tools work for all four, so one question can cover every site, property and ad account you have connected.

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.

Marketing and analytics connectors are on the Pro and Agency plans. On the Free plan, your AI is told the connection isn't available on your plan and points you to Billing.

Which connectors these tools cover

Connector What the tools read
Google Ads Campaigns, ad groups, keywords, search terms, ads, products, locations, conversions and impression share
Microsoft Advertising The same kinds of data for Bing Ads, plus age, gender, audiences and Performance Max asset groups
Google Search Console Organic clicks, impressions, CTR and position by query, page, country, device and search appearance
Google Analytics 4 Sessions, users, engagement, key events, revenue, ecommerce and any GA4 dimension or metric

Google Tag Manager, YouTube and Google Merchant Center have their own tools, described on their pages. PageSpeed Insights 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) and Microsoft Advertising 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.
  • The list is kept for 15 minutes. Your AI can ask for a fresh list if you have just added an account at Google or Microsoft.
  • 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.

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

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?"

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.