Ira Bodnar··Updated ·9 min read

Reddit Ads dashboard: metrics, template and AI prompts

Quick answer: A Reddit Ads dashboard needs 14 metrics on 5 panels: spend and results, efficiency, campaigns, community and placement, and video. Ryze AI is the best tool for pulling those numbers from several Reddit ad accounts with a prompt, with one caveat: it saves no fixed layout, so each review is a set of prompts rather than a stored board.

Below: the metrics with Reddit Ads API v3 report field names, a 5-panel template, the report request shape, Ryze AI prompts and a weekly routine.

Ryze AI · Paid Ads

Reddit Ads reports 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

Reddit 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, key conversions, purchase value, ROAS

    Question it answers: What did we spend and what came back?

  2. 2EfficiencyLast 7 days vs prior 7

    Metrics: CTR, CPC, eCPM, cost per key conversion

    Question it answers: Are clicks and views getting dearer?

  3. 3CampaignsLast 7 days vs prior 7

    Metrics: The same metrics per campaign

    Question it answers: Which campaign moved the total?

  4. 4Community and placementLast 14 days

    Metrics: Spend, clicks and CTR by community and placement

    Question it answers: Where do the ads earn clicks?

  5. 5VideoLast 7 days

    Metrics: Video starts, completed views, reach, frequency

    Question it answers: Do people watch the video ads?

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

The 14 Reddit Ads dashboard metrics and their API field names

14 metrics answer 3 weekly questions: what did we spend, what did people do with the ad, and what came back.

The field names come from the report request schema in the Reddit Ads API v3 OpenAPI file, where the report endpoint lists every allowed value for fields and breakdowns. Definitions are plain-language readings of those names. The Reddit Ads API docs are the reference to check a field before you build on it.

  1. Spend

    Plain definition
    Amount spent in the period
    API field
    SPEND
    How to read it
    Returned in micro-currency: divide by 1 million
  2. Impressions

    Plain definition
    Times your ads were shown
    API field
    IMPRESSIONS
    How to read it
    Delivery volume
  3. Clicks

    Plain definition
    Clicks on your ads
    API field
    CLICKS
    How to read it
    Read with CTR, not alone
  4. CTR

    Plain definition
    Clicks divided by impressions
    API field
    CTR
    How to read it
    Compare within one objective and creative style
  5. CPC

    Plain definition
    Cost per click
    API field
    CPC
    How to read it
    Micro-currency: divide by 1 million
  6. eCPM

    Plain definition
    Effective cost per 1,000 impressions
    API field
    ECPM
    How to read it
    Auction cost; micro-currency: divide by 1 million
  7. Reach

    Plain definition
    People who saw the ads
    API field
    REACH
    How to read it
    The API says reach data starts June 2024
  8. Frequency

    Plain definition
    Average times each person saw the ads
    API field
    FREQUENCY
    How to read it
    Same June 2024 start as reach
  9. Key conversions

    Plain definition
    Count of the conversion events marked as key
    API field
    KEY_CONVERSION_TOTAL_COUNT
    How to read it
    There is no generic conversions field, so use the key or named event fields
  10. Cost per key conversion

    Plain definition
    Spend per key conversion
    API field
    KEY_CONVERSION_ECPA
    How to read it
    Micro-currency: divide by 1 million
  11. Purchase value

    Plain definition
    Total value of purchase conversions
    API field
    CONVERSION_PURCHASE_TOTAL_VALUE
    How to read it
    Divide by 100 per the API note
  12. ROAS

    Plain definition
    Return on ad spend from conversions
    API field
    CONVERSION_ROAS
    How to read it
    Needs conversion values sent to Reddit
  13. Video starts

    Plain definition
    Times a video started
    API field
    VIDEO_STARTED
    How to read it
    Top of the attention funnel
  14. Completed video views

    Plain definition
    Times a video was watched to 100 percent
    API field
    VIDEO_WATCHED_100_PERCENT
    How to read it
    Compare with starts to see drop-off

4 things that trip up a first Reddit Ads dashboard

  • Money fields are scaled. The API says SPEND, CPC, ECPM and the conversion ECPA fields come back multiplied by 1 million, and conversion total values by 100. Divide before you show a number.
  • Conversions depend on set-up. Conversion fields only fill when Reddit receives conversion events. A zero can mean not tracked, so check tracking before you judge a campaign. Reddit's API note on ad groups and CBO campaigns requiring a conversion pixel id from July 13, 2026 is a Reddit rule, not a Ryze AI one.
  • Recent numbers move. The API says metrics can take up to 6 hours to stabilize and that late conversion data changes earlier totals, so re-read last week.
  • Time ranges are hourly. starts_at and ends_at must follow the YYYY-MM-DDTHH:00:00Z format, in UTC unless you set time_zone_id.

A report takes up to 3 breakdowns, or 4 when COUNTRY and REGION are among them. The breakdown values include AD_ACCOUNT_ID, CAMPAIGN_ID, AD_GROUP_ID, AD_ID, DATE, HOUR, COUNTRY, REGION, DMA, GENDER, INTEREST, KEYWORD, PLACEMENT, OS_TYPE, COMMUNITY and LANGUAGE. The docs recommend including AD_ID.

The Reddit Ads dashboard template: 5 panels

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

  1. 1. Spend and results

    Tiles or chart
    Tiles: spend, key conversions, purchase value, ROAS; daily line of spend
    Date range
    Last 7 days, 30-day line
    Compare with
    The 7 days before
  2. 2. Efficiency

    Tiles or chart
    Tiles: CTR, CPC, eCPM, cost per key conversion
    Date range
    Last 7 days
    Compare with
    The 7 days before
  3. 3. Campaigns

    Tiles or chart
    Table, highest spend first, with spend, CTR, CPC, cost per key conversion
    Date range
    Last 7 days
    Compare with
    The 7 days before
  4. 4. Community and placement

    Tiles or chart
    Two tables: by community, by placement, with spend, clicks, CTR
    Date range
    Last 14 days
    Compare with
    The other rows in the same table
  5. 5. Video

    Tiles or chart
    Tiles: video starts, completed views, reach, frequency
    Date range
    Last 7 days
    Compare with
    The 7 days before

Read panel 1 first. If cost per key conversion rose, panel 2 shows whether eCPM or CTR moved, panel 3 names the campaign, panel 4 shows which communities or placements carry the spend, and panel 5 shows whether video is being watched.

Report request shape: panels 1 to 3
POST https://ads-api.reddit.com/api/v3/ad_accounts/<AD_ACCOUNT_ID>/reports { "data": { "starts_at": "<YYYY-MM-DDTHH:00:00Z>", "ends_at": "<YYYY-MM-DDTHH:00:00Z>", "breakdowns": ["CAMPAIGN_ID", "DATE"], "fields": ["SPEND", "IMPRESSIONS", "CLICKS", "CTR", "CPC", "ECPM", "KEY_CONVERSION_TOTAL_COUNT", "KEY_CONVERSION_ECPA"] } } Authorization: Bearer <ACCESS_TOKEN>
Report request shape: panel 4
POST https://ads-api.reddit.com/api/v3/ad_accounts/<AD_ACCOUNT_ID>/reports { "data": { "starts_at": "<YYYY-MM-DDTHH:00:00Z>", "ends_at": "<YYYY-MM-DDTHH:00:00Z>", "breakdowns": ["COMMUNITY"], "fields": ["SPEND", "CLICKS", "CTR"] } }

These shapes use the path and the request properties in the OpenAPI file: starts_at, ends_at, breakdowns, fields, filter, time_zone_id, custom_column_ids, conversion_metrics and conversion_custom_events. The access token placement is shown as a bearer header for illustration; check Reddit's quick start for the OAuth steps. The API says delivery data goes back 24 months.

Upcoming change: the Reddit Ads API changelog notes that from December 8, 2026 a request with the HOUR breakdown over a range longer than 7 days, or with more than 1 of KEYWORD, COMMUNITY, INTEREST or LANGUAGE, returns 400 Bad Request. Panel 4 uses 1 community breakdown, so it stays inside that rule.

Option 1: Reddit Ads Manager and the Ads API

Reddit gives you 2 first-party routes: the Ads Manager dashboard in the browser and the Ads API v3 for code.

The API docs link to Reddit's Ads Manager dashboard help page for audience insights and to a custom columns article, which tells us Ads Manager has a dashboard and custom columns you can add to reports. The API says top combinations are not supported in the report endpoint and points to Ads Manager for them. Reddit's help center pages did not load as text on the build day, so this page does not describe other Ads Manager reporting features; check them before you decide.

  1. Create a Reddit ads API app and an OAuth token, following the quick start in the API docs.
  2. Call the report endpoint for each ad account, with the fields and breakdowns above.
  3. Convert micro-currency values, then write the rows to a sheet or a BI tool.
  4. Chart them with the template above and re-pull recent days.

Strength: the numbers come straight from Reddit and you control storage and layout. Limits: you build and host the layout, handle the token and run one request per ad account. Reporting calls fall under the ads-reporting rate-limit policy, listed in the API as 60 requests per 60 seconds.

Option 2: the prompts that pull it through Ryze AI

Ryze AI runs Reddit Ads performance reports with impressions, clicks, spend, CTR, CPC and conversions, broken down by date, campaign, ad group, ad, country, placement or community, so each panel is one prompt.

Connect Reddit Ads under Integrations with the Reddit login that has access to your ad accounts and approve every permission. Per the Ryze AI Reddit Ads guide, Ryze AI then sees every ad account that login can reach; there is no ad account to pick. Then open a new chat and paste a prompt.

Prompt: panels 1 to 3 in the Ryze AI chat
For the Reddit ad account [account name], read only: change nothing. 1. Spend, clicks and conversions for the last 7 days vs the 7 before. 2. CTR and CPC for the same two periods. 3. A campaign table, highest spend first, with the same metrics. Convert Reddit's micro-currency values into the account currency. Flag any metric that moved more than [20]% week over week.
Prompt: panel 4, communities and placements
For [account name], run a report for the last 14 days broken down by community, then another broken down by placement. Show spend, clicks and CTR, highest spend first, and name the [5] communities with the lowest CTR. Read only.

Behind these prompts sit 3 read tools: reddit_ads__listAccounts lists the ad accounts the login can reach, reddit_ads__report runs the performance report, and reddit_ads__read reads any Reddit Ads API v3 resource such as ad accounts, campaigns, ad groups and ads. The same connection also has reddit_ads__write and reddit_ads__delete, 5 tools in all. The report tool takes hourly-aligned UTC start and end times only.

The same pulls in Claude or ChatGPT

The same tools load in Claude and ChatGPT through the Ryze AI connector at https://connector.get-ryze.ai/mcp. If the Reddit tools do not appear in a new chat, refresh the connector; in Claude, remove it under Customize > Connectors, add it again and start a new chat.

Check approvals first. In the Ryze AI chat, 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. The write tool can pause and archive campaigns and the delete tool is irreversible, so 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; ROAS vs prior 7 days
    Action if off
    Open panels 2 and 3 to find the cause
  2. 2

    Panel
    Efficiency
    What to check
    eCPM, CTR and cost per key conversion direction
    Action if off
    High eCPM: audience or competition. Low CTR: the headline and image
  3. 3

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

    Panel
    Community and placement
    What to check
    Communities with high spend and low CTR
    Action if off
    Exclude or rework the targeting for those communities
  5. 5

    Panel
    Video
    What to check
    Completed views vs starts
    Action if off
    Rework video ads that start often and finish rarely

Re-read last week too: Reddit says recent metrics can take up to 6 hours to stabilize and late conversion data changes earlier totals.

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 Reddit ad account [account name], summarize last week, Monday to Sunday, vs the week before: spend, CTR, CPC and conversions for the account and the top [5] campaigns, then the top [5] communities by spend. Read only.

Reddit Ads API vs Ryze AI for a Reddit Ads dashboard

The Ads API gives you the data and a build job. Ryze AI gives you answers to new questions across ad accounts.

  1. Price

    Reddit Ads API v3
    No API fee is stated in the docs opened for this page
    Ryze AI
    Paid Ads $89/mo, 7-day free trial
  2. Set-up

    Reddit Ads API v3
    API app, OAuth token and code for each request
    Ryze AI
    Sign in with your Reddit login; no keys to copy
  3. Accounts

    Reddit Ads API v3
    One ad account id per report request
    Ryze AI
    Every ad account the login reaches, with Agent default accounts to pick the first ones
  4. Breakdowns

    Reddit Ads API v3
    Up to 3, or 4 with COUNTRY and REGION
    Ryze AI
    Date, campaign, ad group, ad, country, placement or community
  5. Saved fixed layout

    Reddit Ads API v3
    Whatever you build
    Ryze AI
    Prompts in chat; no layout is saved by this method
  6. Acting on findings

    Reddit Ads API v3
    Campaign, ad group and ad endpoints in the same API
    Ryze AI
    Write and delete tools, under your Tool approvals setting

The Reddit Ads API docs opened on the build day list no Reddit-run MCP server, so none is offered here as a way to pull reports. The Ryze AI connector at https://connector.get-ryze.ai/mcp also covers the other platforms Ryze AI connects.

Which Reddit Ads dashboard to use

Pick by whether you want a stored dataset or fast answers, and by how many ad accounts you read.

  1. Own database or a custom chart

    Use
    The Ads API, with the field names above
  2. A quick look at one account

    Use
    Reddit Ads Manager
  3. Several ad accounts or changing questions

    Use
    Ryze AI prompts
  4. Acting on what the numbers show

    Use
    Ryze AI write tool, with approvals switched on

You can use both: keep a pipeline for fixed numbers and ask Ryze AI for the why. The same template exists for TikTok Ads, Pinterest Ads and LinkedIn Ads.

Sources

The verdict

A Reddit Ads dashboard is 14 metrics on 5 panels read in the same order each week, with money fields converted from micro-currency. Build the stored version on the Ads API if you need your own dataset.

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

Frequently asked questions

What should a Reddit Ads dashboard include?
14 metrics on 5 panels: spend and results, efficiency, campaigns, community and placement, and video. Core API fields are SPEND, IMPRESSIONS, CLICKS, CTR, CPC, ECPM, KEY_CONVERSION_TOTAL_COUNT and CONVERSION_ROAS. Compare the last 7 days with the 7 before.
Which API endpoint returns Reddit Ads report data?
POST /ad_accounts/{ad_account_id}/reports in the Reddit Ads API v3. The body takes starts_at, ends_at, fields and optional breakdowns, filter and time_zone_id.
How many breakdowns can a Reddit Ads report have?
Up to 3, or 4 when COUNTRY and REGION are among them, per the API docs. From December 8, 2026 the HOUR breakdown is limited to ranges of 7 days or less.
Why do my Reddit Ads spend numbers look huge?
The API returns SPEND, CPC and ECPM in micro-currency, so divide by 1 million. Conversion total values come back multiplied by 100.
Show 7 more questions
Why are conversions zero in my Reddit report?
Conversion fields only fill when Reddit receives conversion events. A zero can mean not tracked, and the API has no generic conversions field, so request key or named conversion fields.
Can Ryze AI build a Reddit Ads dashboard?
Yes, as prompts rather than a saved layout. Ryze AI runs Reddit Ads reports with impressions, clicks, spend, CTR, CPC and conversions by date, campaign, ad group, ad, country, placement or community.
Which Ryze AI tools read Reddit Ads data?
This page uses 3 of the 5 Reddit Ads tools, all read tools: reddit_ads__listAccounts, reddit_ads__report and reddit_ads__read. The other 2 are reddit_ads__write and reddit_ads__delete.
Can I use several Reddit ad accounts in one chat?
Yes. Ryze AI sees every ad account the connected login can reach, and several Reddit logins can be connected to one workspace under View > Add one more account. Agent default accounts sets which accounts the agent works with first.
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.
Does Reddit have its own MCP server?
The Reddit Ads API docs opened on November 20, 2026 list none. Check Reddit's docs 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: Reddit Ads dashboard

7-day free trial, $89 a month flat

Start free trial