Ira Bodnar··Updated ·11 min read

Meta Ads dashboard: metrics, template and AI prompts

Quick answer: A Meta Ads dashboard needs 14 metrics on 5 panels: spend and results, efficiency, campaigns, audience and placement, and creative. Ryze AI is the best tool for pulling those numbers across several Meta ad accounts with a prompt, with one caveat: it does not bring Meta data into a fixed branded report layout.

Below: metrics with Insights API fields, a 5-panel template, the native Ads Reporting option, Ryze AI prompts and a weekly routine.

Ryze AI · Paid Ads

Meta Ads numbers from a prompt

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

Meta Ads dashboard at a glance

5 panels, read top to bottom once a week.

  1. 1Spend and resultsLast 7 days vs prior 7

    Metrics: Spend, results by action, action value, purchase ROAS

    Question it answers: What did we spend and get back?

  2. 2EfficiencyLast 7 days vs prior 7

    Metrics: CTR, CPC, CPM, cost per action

    Question it answers: Are clicks and results getting dearer?

  3. 3Campaigns and ad setsLast 7 days vs prior 7

    Metrics: The same metrics per campaign and ad set

    Question it answers: Which campaign caused the change?

  4. 4Audience and placementLast 30 days

    Metrics: Age, gender, country, platform and placement breakdowns

    Question it answers: Who and where are results coming from?

  5. 5CreativeLast 30 days

    Metrics: Frequency, CTR and cost per action per ad

    Question it answers: Which ads are tiring out?

The next section maps each metric to its Insights API field.

The 14 Meta Ads dashboard metrics and their API fields

14 metrics answer 3 weekly questions: what did we spend, what came back, and which ads are wearing out.

API field names let a query or an AI agent pull the exact column. Definitions follow the Ad Account Insights reference in Meta's Marketing API docs, which use v27.0 in their example requests.

  1. Spend

    Plain definition
    Amount spent in the period
    API field
    spend
    How to read it
    Account currency, returned as a string
  2. Impressions

    Plain definition
    Times your ads were on screen
    API field
    impressions
    How to read it
    Reach and delivery
  3. Reach

    Plain definition
    Accounts that saw your ads (estimated)
    API field
    reach
    How to read it
    Unique audience; an estimate
  4. Frequency

    Plain definition
    Average times each person saw an ad
    API field
    frequency
    How to read it
    Rising frequency with falling CTR points to fatigue
  5. Clicks (all)

    Plain definition
    Clicks of every type on the ad
    API field
    clicks
    How to read it
    Includes reactions and profile clicks, so it runs above link clicks
  6. Link clicks

    Plain definition
    Clicks to a destination
    API field
    inline_link_clicks
    How to read it
    Closer to site traffic than clicks
  7. CTR

    Plain definition
    Click-through rate, as a percentage
    API field
    ctr
    How to read it
    Compare within one placement and objective
  8. CPC

    Plain definition
    Cost per click
    API field
    cpc
    How to read it
    Spend divided by clicks
  9. CPM

    Plain definition
    Cost per 1,000 impressions
    API field
    cpm
    How to read it
    Auction cost; moves with audience and season
  10. Results by action

    Plain definition
    Attributed actions, by action type
    API field
    actions
    How to read it
    A list of action_type and value pairs; pick purchase, lead or other
  11. Action value

    Plain definition
    Value of attributed actions
    API field
    action_values
    How to read it
    Revenue only if the pixel or CAPI passes values
  12. Cost per action

    Plain definition
    Spend divided by actions, by type
    API field
    cost_per_action_type
    How to read it
    The CPA for each action type
  13. Purchase ROAS

    Plain definition
    Return on ad spend from purchases
    API field
    purchase_roas
    How to read it
    Above 1 means tracked purchase value exceeds spend
  14. Outbound clicks

    Plain definition
    Clicks that leave Meta properties
    API field
    outbound_clicks
    How to read it
    Alternative traffic measure to link clicks

3 things that trip up a first dashboard

  • Attribution window. Per Meta's docs, action_attribution_windows defaults to 7d_click and 1d_view. A number in Ads Manager with a different window will not match an API pull with the default. Fix one window and use it everywhere.
  • Action lists. actions, action_values and cost_per_action_type return lists keyed by action type, so a dashboard must choose which type counts as a result, for example purchase or lead.
  • Breakdown limits. Meta states that only some permutations of breakdowns are available. Age with gender works; pa_creator_ig_handle cannot be combined with age, gender or publisher_platform. Metrics are also unavailable across several attribution settings at once unless you pass the windows you want.

Insights data is available at 4 levels: ad account, campaign, ad set and ad, each with its own /insights edge (Insights overview). Per Meta, a request with no date preset returns roughly the last 30 days.

The Meta Ads dashboard template: 5 panels

Put the 14 metrics on 5 panels, ordered from the money to the creative.

  1. 1. Spend and results

    Tiles or chart
    Tiles: spend, results for your chosen action, action value, purchase ROAS; daily line of spend and results
    Date range
    Last 7 days, 30-day line
    Compare with
    The 7 days before
  2. 2. Efficiency

    Tiles or chart
    Tiles: CTR, CPC, CPM, cost per action
    Date range
    Last 7 days
    Compare with
    The 7 days before
  3. 3. Campaigns and ad sets

    Tiles or chart
    Table, highest spend first, with spend, results, cost per action, purchase ROAS
    Date range
    Last 7 days
    Compare with
    The 7 days before
  4. 4. Audience and placement

    Tiles or chart
    Bars by age, gender, country and placement for spend and results
    Date range
    Last 30 days
    Compare with
    Share of spend vs share of results
  5. 5. Creative

    Tiles or chart
    Table per ad: spend, frequency, CTR, cost per action
    Date range
    Last 30 days
    Compare with
    The same ad last period

Read panel 1 first. If cost per action rose, panel 2 shows whether CPM or CTR moved, panel 3 names the campaign, and panels 4 and 5 show whether an audience or an ad is behind it.

Insights request: panel 3, campaign table
GET /act_<AD_ACCOUNT_ID>/insights ?level=campaign &fields=campaign_name,spend,impressions,reach,frequency,inline_link_clicks,ctr,cpc,cpm,actions,action_values,purchase_roas &date_preset=last_7d &action_attribution_windows=["7d_click","1d_view"]
Insights request: panel 1, 30-day daily trend
GET /act_<AD_ACCOUNT_ID>/insights ?fields=spend,actions,action_values &date_preset=last_30d &time_increment=1
Insights request: panel 4, audience breakdown
GET /act_<AD_ACCOUNT_ID>/insights ?fields=spend,impressions,actions &breakdowns=age,gender &date_preset=last_30d

These are request shapes built from field names in Meta's reference; run them in Meta's Graph API Explorer or through an agent and check the account currency and window before trusting the totals.

Option 1: Ads Reporting inside Meta Ads Manager

Meta Ads Manager has its own report builder, called Ads Reporting. It is free and covers one business at a time.

Meta's help page for Ads Reporting did not load on the build day, so this section follows third-party guides (Metricool, Madgicx); check the steps against your own Ads Manager.

  1. Open Ads Manager and choose Create custom report from the Reports menu.
  2. Start from a template or a blank report and check the ad account and date range.
  3. Add the metrics from the table above and the breakdowns for panels 4 and 5.
  4. Optionally add a custom metric, which applies a formula to existing metrics, for example purchases divided by link clicks.
  5. Save the report, then export it as .xlsx or .csv, share it by link or schedule it by email.

Strength: native, free and uses the same numbers as Ads Manager. Limit: one fixed layout you maintain by hand, and it holds Meta data only.

Option 2: the prompts that pull it through Ryze AI

Ryze AI answers questions about Meta spend, ROAS, CTR, creatives and ad sets from the Meta Ads accounts you connect, so each panel is one prompt.

Connect Meta Ads under Integrations with your Meta sign-in. Per the Ryze AI Meta Ads guide, Ryze AI then sees every ad account that login can reach, and you need at least Advertiser access on the account. Then open a new chat and paste a prompt.

Prompt: panels 1 to 3 in the Ryze AI chat
For the Meta ad account [account name], read only: change nothing. 1. Spend, results for [purchases], action value and purchase ROAS for the last 7 days vs the 7 before. 2. CTR, CPC, CPM and cost per [purchase] for the same two periods. 3. A campaign table, highest spend first, with spend, results, cost per result and ROAS. Use the account currency and the 7-day click, 1-day view window. Flag any metric that moved more than [20]% week over week.
Prompt: panels 4 and 5, breakdowns and creative
For [account name], run an Insights query for the last 30 days broken down by age and gender, then by placement, showing spend and results. Then list the ads with frequency, CTR and cost per result, and name the 5 ads with the highest frequency and falling CTR. Read only.

Behind these prompts sit two read tools: meta_ads__getAccountSummary returns aggregate metrics on Meta's default attribution window, and meta_ads__runRawInsights runs an Insights query at account, campaign, ad set or ad level with breakdowns, filters and custom attribution windows. Ad creatives come from meta_ads__listCreatives.

For a quick look with no prompt, the Analytics page, then Ads Performance, shows the last 30 days of Meta results, including creatives.

The same pulls in Claude or ChatGPT

The same tools load in Claude and ChatGPT through the Ryze AI connector (Claude setup, ChatGPT setup); the full tool list is on the Meta Ads MCP page. For one Claude view across Google and Meta ads, see the live ads dashboard guide.

Check approvals first. In Ryze AI, the Tool approvals setting starts on Skip all approvals; switch it in the chat composer to Approve write & delete. In Claude, set write and delete tools to Needs approval under Customize > Connectors > Ryze AI. Scheduled tasks run without an approval step, which is why every prompt here tells the agent to change nothing.

A weekly review routine for the dashboard

Spend 20 minutes on the same day each week and read the panels in order.

  1. 1

    Panel
    Spend and results
    What to check
    Spend vs plan; results and ROAS vs prior 7 days
    Action if off
    Open panel 2 and 3 to find the cause
  2. 2

    Panel
    Efficiency
    What to check
    CPM, CTR and cost per action direction
    Action if off
    High CPM: audience or season. Low CTR: creative
  3. 3

    Panel
    Campaigns and ad sets
    What to check
    The campaign with the largest change
    Action if off
    Review budget and audience of that ad set
  4. 4

    Panel
    Audience and placement
    What to check
    Spend share vs results share
    Action if off
    Ask whether a segment spends more than it returns
  5. 5

    Panel
    Creative
    What to check
    Highest-frequency ads with falling CTR
    Action if off
    Plan a replacement creative

Re-read last week too: Meta can update attributed results after the fact, so recent days may change.

Scheduled version

The Ryze AI help center describes scheduled tasks; they run without an approval step, so keep the prompt read only.

Prompt: weekly review
For Meta ad account [account name], summarize last week, Monday to Sunday, vs the week before: spend, results, cost per result and ROAS for the account and the top [5] campaigns, and the [5] ads with the highest frequency. Read only.

Ads Reporting vs Ryze AI for a Meta Ads dashboard

Ads Reporting gives a saved layout in Meta. Ryze AI gives answers to new questions across accounts.

  1. Price

    Meta Ads Reporting
    Free with an ad account
    Ryze AI
    Paid Ads $89/mo, 7-day free trial
  2. Accounts

    Meta Ads Reporting
    One business at a time
    Ryze AI
    Every Meta ad account the connected login reaches
  3. Custom attribution window

    Meta Ads Reporting
    Set in the report
    Ryze AI
    Request it through runRawInsights
  4. Breakdowns

    Meta Ads Reporting
    Report builder choices
    Ryze AI
    Age, gender, country, device and placement via runRawInsights
  5. Saved fixed layout

    Meta Ads Reporting
    Yes, with export and email schedule
    Ryze AI
    No fixed layout; ask again or use Ads Performance
  6. Acting on findings

    Meta Ads Reporting
    Reporting only
    Ryze AI
    Can pause, change budgets or swap creatives through the write tool

Meta also launched its own Meta Ads MCP server and CLI in open beta on April 29, 2026 (Meta announcement). Third-party guides give its URL as https://mcp.facebook.com/ads; Meta's page did not show it on the build day, so confirm it in Meta's help center. The Ryze AI connector at https://connector.get-ryze.ai/mcp is a separate server that also covers the other platforms Ryze AI connects.

Which Meta Ads dashboard to use

Pick by how many accounts you read and how often the questions change.

  1. One ad account, a fixed weekly report

    Use
    Ads Reporting with a scheduled email
  2. Several ad accounts or changing questions

    Use
    Ryze AI prompts
  3. Quick 30-day look with creatives

    Use
    Ads Performance in Ryze AI
  4. Asking Meta's own AI tools

    Use
    Meta's own MCP server

You can use both: keep an Ads Reporting report for the fixed numbers and ask Ryze AI for the why.

Sources

The verdict

A Meta Ads dashboard is 14 metrics on 5 panels read in the same order each week. Build the fixed version in Ads Reporting if one account is enough.

Use Ryze AI when you read several accounts or want to ask new questions of the same data. Connect Meta Ads, paste the prompts above and keep them read only.

Frequently asked questions

What should a Meta Ads dashboard include?
14 metrics on 5 panels: spend and results, efficiency, campaigns and ad sets, audience and placement, and creative. The core fields are spend, impressions, reach, frequency, ctr, cpc, cpm, actions, action_values and purchase_roas. Compare the last 7 days with the 7 before.
Does Meta have a built-in dashboard?
Yes, Ads Reporting in Ads Manager, where you build, export, share and schedule custom reports. It is free and shows Meta data only. This summary follows third-party guides, so check it in your account.
Which attribution window does the Insights API use?
Per Meta's docs, action_attribution_windows defaults to 7d_click and 1d_view. Pass other windows explicitly to match another report.
Why do my API numbers differ from Ads Manager?
The usual causes are a different attribution window, a different action type counted as a result, and recent days still being updated. Fix those 3 before comparing.
Show 7 more questions
How do I calculate ROAS for a Meta Ads dashboard?
Use purchase_roas, or divide the purchase value in action_values by spend. Values only exist if your pixel or Conversions API passes order values.
Can I break results down by age, gender or placement?
Yes. Meta supports age, gender, country, device_platform, publisher_platform and platform_position, with limits on which can be combined.
Can Ryze AI build a Meta Ads dashboard?
Yes, as prompts rather than a saved layout. Ryze AI reads spend, ROAS, CTR, creatives and breakdowns, and the Ads Performance page shows the last 30 days.
Which Ryze AI tools read Meta data?
This page uses 3 of the 10 Meta Ads tools, all read tools: meta_ads__getAccountSummary, meta_ads__runRawInsights and meta_ads__listCreatives.
Can the agent change my account while I build a dashboard?
Only if you ask it to and the approval setting allows it. The Ryze AI chat starts on Skip all approvals, so say read only in the prompt, or switch Tool approvals to Approve write & delete. For a hard read-only guarantee, connect a Meta login with read access only.
Does Meta have its own MCP server?
Meta announced Meta Ads AI connectors, an MCP server and a CLI, in open beta on April 29, 2026. See Meta's announcement for current details.
How much does Ryze AI cost for this?
Paid Ads is $89 a month with a 7-day free trial. Connecting the connector is free; the tools need an active plan or trial.

Related guides

Ryze AI: Meta Ads dashboard

7-day free trial, $89 a month flat

Start free trial