Performance & reports

Account overview, per-ad performance, breakdowns, the performance cube, strategy rollups and saved report views.

meta_get_overview

READ — Account totals (spend, View Content → Add to Cart, cost per ATC, leads — form vs website — and cost per lead, conversations), the daily series, campaigns and the top ads for a period, from the last sync.

meta_get_ad_performance

READ — Per-ad metrics for a period: spend, View Content, Add to Cart, VC→ATC rate, cost per ATC, leads (form / website) and cost per lead, conversations, plus purchase ROAS/CPA/AOV when that pixel fired, CPC (link), landing page views (cost, rate per link click), click→lead rate, checkouts and registrations with their costs, hook/hold, video retention (25/50/75/95/100% view rates over 3-second plays, average watch time — null on statics and on days synced before retention was stored), and the persona / angle / concept parsed from the ad name.

meta_get_breakdowns

READ — LIVE Meta call: performance for the period (or any since/until within Meta's 37 months — this one does not need the warehouse) broken down by age, gender, country, publisher_platform or device_platform, account-wide (cached ten minutes).

meta_get_audience_breakdown

READ — LIVE Meta read (cached about an hour per workspace and window): who responds to each Value of a creative Dimension — goal cost per Value × age, gender, age × gender or placement (platform × position), the heat table behind a Value's "Who responds" (Library, /app/library?value=…) and Ads › Group by.

meta_get_cross_analysis

READ — Cross analysis inside ONE funnel: one Dimension (rows) or two against each other (rows × columns) — angle, persona, awareness, offer, pain, format, hook, talent, visual, copy, cta, language, market, landing, media.

meta_get_performance_cube

READ — Performance grouped and crossed on any of: campaign, adset, country (the ad set's targeted countries; an ad set bought for several is one bucket, e.g.

meta_get_strategy_rollup

READ — Spend, purchases, results and ROAS per Value of every creative Dimension (angle, persona, awareness, offer, pain, format, hook, talent, visual) and per persona × angle, for a period.

meta_list_report_views

READ — Saved views of the Ads report (/app/ads) — the workspace's shared ones and your own — plus the built-in templates (`templates`: Top creatives, Week over week, Top copy, Landing pages, Heavies, by-angle…), each with its URL state for THIS workspace's goal (a lead account ranks on cost per lead, never ROAS).

meta_get_report_view

READ — Open a report view and read its rows: a saved view or a template by slug, or any report URL state (`query`, with `path`).

meta_save_report_view

WRITE — Save an Ads report (/app/ads) as a named view, or update one (`view` = its slug).