Marketing team playbook

You own paid media and analytics. This playbook covers auditing live (and past) ad campaigns across Google Ads and Meta, pulling GA4 + Search Console, and reading behaviour data — everything read-only, so you can report without touching a campaign.

What you can do

• Run Google Ads reports with any GAQL query (campaigns, ad groups, keywords, search terms, cost, conversions).
• Pull Meta (Facebook / Instagram) Ads insights (spend, CTR, CPC, actions) at account / campaign / ad-set / ad level, with breakdowns.
• Read GA4 traffic and Search Console query/page performance.
• Read Microsoft Clarity engagement + heatmap metrics.
• Audit funnels, opt-in rates and A2P messaging compliance on GoHighLevel.

Prerequisites

1. A token scoped to the client’s sites.
2. Google Ads: the site’s bound Google user has connected Google with the adwords scope, the Worker has a GOOGLE_ADS_DEVELOPER_TOKEN, and the site carries google_ads_customer_id (a leaf ad account, not a manager/MCC — plus google_ads_login_customer_id when reached via an MCC).
3. Meta Ads: the Worker has META_APP_ID + META_APP_SECRET, the site’s bound user has connected Meta at /admin/users, and the site carries meta_ad_account_id.
4. GA4 / Search Console: Google connected with Analytics + Search Console scopes; site carries ga4_property_id / gsc_site_url.
5. Clarity: site carries clarity_project_id + Data Export token.

Core tools

Feature	Tools
Google Ads	get_google_ads_report (GAQL, cost in micros)
Meta Ads insights	get_meta_ads_insights
Meta account structure	list_meta_ad_accounts, get_meta_ad_account, list_meta_campaigns, list_meta_adsets, list_meta_ads
GA4	get_ga4_report
Search Console	get_gsc_search_analytics
Clarity	clarity_get_metrics, clarity_get_heatmap_metrics, clarity_get_historical_metrics
Funnel / opt-in / A2P	ghl_get_funnel_stats, ghl_compute_opt_in_rate, ghl_get_campaign_a2p_stats
Blended SEO report	generate_seo_report

Example prompts

Google Ads audit

For "kleentech", run a Google Ads report for the last 30 days: campaigns by
cost with clicks, conversions, CPC and CTR. Then a second query for keywords
that spent money but got 0 conversions. Flag what I should pause.

Two get_google_ads_report calls. Useful GAQL to hand it:

SELECT campaign.name, metrics.cost_micros, metrics.clicks,
       metrics.conversions, metrics.average_cpc, metrics.ctr
FROM campaign WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC

Meta Ads breakdown

Pull Meta Ads insights for "acme" for the last 14 days at campaign level, then
break the top spender down by publisher_platform and by age/gender. Where is
the money going and what's converting?

get_meta_ads_insights with level=campaign, then breakdowns.

Organic vs paid

For "acme-blog": GA4 sessions by channel last month, plus Search Console
clicks. Compare organic search against the paid numbers from Google Ads so I
can show blended CAC.

get_ga4_report + get_gsc_search_analytics + get_google_ads_report.

Landing-page friction

The paid landing page for "acme" is converting badly. Pull Clarity rage-click
and scroll-depth metrics for that URL over the last 3 days and tell me where
users drop off.

clarity_get_heatmap_metrics + clarity_get_metrics.

Gotchas

Caution

• Everything here is read-only. There are no tools to change budgets, pause campaigns, or edit ads. You report; you change it in the ad platform.
• Google Ads cost is in micros — divide cost_micros by 1,000,000 for the currency amount.
• Don’t query a manager (MCC) account for metrics. google_ads_customer_id must be a leaf ad account, else REQUESTED_METRICS_FOR_MANAGER. Put the MCC in google_ads_login_customer_id.
• Meta tokens expire (~60 days). E_META_TOKEN_EXPIRED means the bound user must reconnect Meta at /admin/users.
• Clarity’s public API caps at 3 days per call — use clarity_get_historical_metrics for longer trends.

Next

• Reference: all tools — every argument for the report tools.
• SEO playbook — organic side of the same funnel.
• CRM playbook — connect ad spend to booked revenue.