ads-checkup
A question typed in chat about the merchant's OWN PAID ADS, in ANY phrasing — "how are my ads doing", "check my ads", "check my Google Ads", "is my ad spend worth it", "which campaign is wasting money", "should I pause this campaign". Read this before calling the ads report. Only Google Ads can be checked, and only where GET_GOOGLE_ADS_REPORT is in your tool list; a question about Meta (Facebook / Instagram) ads — or about any ads where that tool is not listed — is answered with one sentence saying those cannot be checked yet, naming no ad platform you have no tool for. It is NOT store traffic or what to promote (marketing-advice), NOT how a published post performed (SHOW_CONTENT_PERFORMANCE), and NOT writing ad copy (ad-copy). It is a single answer, not a task: it opens no run and reports no node. It only reads — it cannot create, pause, edit or re-budget an ad.
name: ads-checkup description: >- A question typed in chat about the merchant's OWN PAID ADS, in ANY phrasing — "how are my ads doing", "check my ads", "check my Google Ads", "is my ad spend worth it", "which campaign is wasting money", "should I pause this campaign". Read this before calling the ads report. Only Google Ads can be checked, and only where GET_GOOGLE_ADS_REPORT is in your tool list; a question about Meta (Facebook / Instagram) ads — or about any ads where that tool is not listed — is answered with one sentence saying those cannot be checked yet, naming no ad platform you have no tool for. It is NOT store traffic or what to promote (marketing-advice), NOT how a published post performed (SHOW_CONTENT_PERFORMANCE), and NOT writing ad copy (ad-copy). It is a single answer, not a task: it opens no run and reports no node. It only reads — it cannot create, pause, edit or re-budget an ad. tags: [internal, marketing] license: MIT-0
Checking the merchant's Google Ads
The merchant wants to know whether the money going into Google Ads is coming back. When the report has figures, the answer is a card the merchant is already looking at and your reply is printed under it as its Key takeaway; when it has none, there is no card (see "When the report has no figures").
One call
GET_GOOGLE_ADS_REPORT with days: 28 and show_card: true — or the window the
merchant named, with show_card: true still — only when it is in your tool list (not
listed: see the end of this section). That one call is the whole input: it
returns the account's totals, every campaign with an attention flag, and
store_sales (the store's own Shopify orders for the same 28 days). Call no other
report — the one call besides it is the options card when the report has no figures
(below); in particular GET_META_ADS_REPORT is never called here and Meta is never mentioned,
unless the merchant asked about Meta — then one sentence: Meta ads cannot be checked
here yet. With GET_GOOGLE_ADS_REPORT not in your tool list, Google Ads does not exist
for you (AGENTS.md, its row in the tool inventory): no call and no ads card — the reply is one
sentence naming no ad platform ("Checking ad accounts isn't available here yet."), then
the options card exactly as "When the report has no figures" says.
When the report has no figures
Any status other than "ok" (data_state.has_data false) has NO figures and draws no
card, so there is no takeaway to write: the reply is one or two sentences on what blocks
it, then ASK_USER_QUESTION in this same turn with 2–3 things you can finish with your
own tools instead — the result's next_move says the same, and AGENTS.md's "never stop
at I can't" says how both halves are written. The sentences alone leave the merchant
with nothing on screen to pick. Never say the spend was zero.
The takeaway: one paragraph, two or three sentences. Count them.
The card already shows every figure, every campaign and the store's orders. The takeaway is the judgement on top of them:
- Whether the ads are paying back — read from the totals and from which campaigns
carry an
attentionflag. Name a flagged campaign exactly as the card does, in quotes; name only flagged ones, never a healthy one. When spend is 0, say there was no spend in the window, using the campaigns' statuses as the report gives them (a paused campaign is never called active). - The one thing to do next — tied to what you just said: pause or fix a named flagged campaign, leave it alone when nothing is losing money, or, with no spend, restart one campaign to have something to judge. You cannot change an ad from here; the step is something the merchant does in Google Ads.
- Only when Google's total conversions are above 0 and
store_salesis present: one sentence setting Google's conversions beside the store's orders — never added together, never one as a share of the other. With 0 conversions there is nothing to set beside the orders, so there is no third sentence at all; the card already shows the store's orders.
The ban is on the FORM: no list, no heading, no table, no figure the card already shows except the one or two your judgement stands on, and, while the card is on screen, no question at the end — the card has its own button for writing ad copy, so do not offer it in words.
Figures
Quote a figure exactly as the report returns it, with its currency. Never work out cost
per conversion, click-through rate, a percentage change, a daily average or any other
number the report did not return. ROAS is conversion value divided by spend and is never
profit; conversion value can be a value per sign-up rather than revenue (metric_notes).
Plain words — "spend", "sales from the ads", "return" — not CTR or CPA unless the merchant
used them.
A narrow question ("should I pause 'LTBS - Search'?") still calls the report with
show_card: true; the takeaway then answers that campaign only.
Download
ZIP package — ready to use
Skill Info
- Creator
- Yepai
- License
- MIT-0
- Downloads
- 3
- Published
- Nov 12, 2026
- Updated
- Nov 20, 2026