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
Reddit Ads dashboard at a glance
5 panels, read top to bottom once a week.
- 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?
- 2EfficiencyLast 7 days vs prior 7
Metrics: CTR, CPC, eCPM, cost per key conversion
Question it answers: Are clicks and views getting dearer?
- 3CampaignsLast 7 days vs prior 7
Metrics: The same metrics per campaign
Question it answers: Which campaign moved the total?
- 4Community and placementLast 14 days
Metrics: Spend, clicks and CTR by community and placement
Question it answers: Where do the ads earn clicks?
- 5VideoLast 7 days
Metrics: Video starts, completed views, reach, frequency
Question it answers: Do people watch the video ads?
| # | Panel | Range | Metrics | Question it answers |
|---|---|---|---|---|
| 1 | Spend and results | Last 7 days vs prior 7 | Spend, key conversions, purchase value, ROAS | What did we spend and what came back? |
| 2 | Efficiency | Last 7 days vs prior 7 | CTR, CPC, eCPM, cost per key conversion | Are clicks and views getting dearer? |
| 3 | Campaigns | Last 7 days vs prior 7 | The same metrics per campaign | Which campaign moved the total? |
| 4 | Community and placement | Last 14 days | Spend, clicks and CTR by community and placement | Where do the ads earn clicks? |
| 5 | Video | Last 7 days | Video starts, completed views, reach, frequency | 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.
Spend
- Plain definition
- Amount spent in the period
- API field
- SPEND
- How to read it
- Returned in micro-currency: divide by 1 million
Impressions
- Plain definition
- Times your ads were shown
- API field
- IMPRESSIONS
- How to read it
- Delivery volume
Clicks
- Plain definition
- Clicks on your ads
- API field
- CLICKS
- How to read it
- Read with CTR, not alone
CTR
- Plain definition
- Clicks divided by impressions
- API field
- CTR
- How to read it
- Compare within one objective and creative style
CPC
- Plain definition
- Cost per click
- API field
- CPC
- How to read it
- Micro-currency: divide by 1 million
eCPM
- Plain definition
- Effective cost per 1,000 impressions
- API field
- ECPM
- How to read it
- Auction cost; micro-currency: divide by 1 million
Reach
- Plain definition
- People who saw the ads
- API field
- REACH
- How to read it
- The API says reach data starts June 2024
Frequency
- Plain definition
- Average times each person saw the ads
- API field
- FREQUENCY
- How to read it
- Same June 2024 start as reach
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
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
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
ROAS
- Plain definition
- Return on ad spend from conversions
- API field
- CONVERSION_ROAS
- How to read it
- Needs conversion values sent to Reddit
Video starts
- Plain definition
- Times a video started
- API field
- VIDEO_STARTED
- How to read it
- Top of the attention funnel
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
| Metric | Plain definition | API field | How to read it |
|---|---|---|---|
| Spend | Amount spent in the period | SPEND | Returned in micro-currency: divide by 1 million |
| Impressions | Times your ads were shown | IMPRESSIONS | Delivery volume |
| Clicks | Clicks on your ads | CLICKS | Read with CTR, not alone |
| CTR | Clicks divided by impressions | CTR | Compare within one objective and creative style |
| CPC | Cost per click | CPC | Micro-currency: divide by 1 million |
| eCPM | Effective cost per 1,000 impressions | ECPM | Auction cost; micro-currency: divide by 1 million |
| Reach | People who saw the ads | REACH | The API says reach data starts June 2024 |
| Frequency | Average times each person saw the ads | FREQUENCY | Same June 2024 start as reach |
| Key conversions | Count of the conversion events marked as key | KEY_CONVERSION_TOTAL_COUNT | There is no generic conversions field, so use the key or named event fields |
| Cost per key conversion | Spend per key conversion | KEY_CONVERSION_ECPA | Micro-currency: divide by 1 million |
| Purchase value | Total value of purchase conversions | CONVERSION_PURCHASE_TOTAL_VALUE | Divide by 100 per the API note |
| ROAS | Return on ad spend from conversions | CONVERSION_ROAS | Needs conversion values sent to Reddit |
| Video starts | Times a video started | VIDEO_STARTED | Top of the attention funnel |
| Completed video views | Times a video was watched to 100 percent | VIDEO_WATCHED_100_PERCENT | 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. 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. Efficiency
- Tiles or chart
- Tiles: CTR, CPC, eCPM, cost per key conversion
- Date range
- Last 7 days
- Compare with
- The 7 days before
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. 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. Video
- Tiles or chart
- Tiles: video starts, completed views, reach, frequency
- Date range
- Last 7 days
- Compare with
- The 7 days before
| Panel | Tiles or chart | Date range | Compare with |
|---|---|---|---|
| 1. Spend and results | Tiles: spend, key conversions, purchase value, ROAS; daily line of spend | Last 7 days, 30-day line | The 7 days before |
| 2. Efficiency | Tiles: CTR, CPC, eCPM, cost per key conversion | Last 7 days | The 7 days before |
| 3. Campaigns | Table, highest spend first, with spend, CTR, CPC, cost per key conversion | Last 7 days | The 7 days before |
| 4. Community and placement | Two tables: by community, by placement, with spend, clicks, CTR | Last 14 days | The other rows in the same table |
| 5. Video | Tiles: video starts, completed views, reach, frequency | Last 7 days | 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.
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.
- Create a Reddit ads API app and an OAuth token, following the quick start in the API docs.
- Call the report endpoint for each ad account, with the fields and breakdowns above.
- Convert micro-currency values, then write the rows to a sheet or a BI tool.
- 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.
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
- 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
- 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
- Panel
- Campaigns
- What to check
- The campaign with the largest change
- Action if off
- Review budget and targeting of that campaign
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
- Panel
- Video
- What to check
- Completed views vs starts
- Action if off
- Rework video ads that start often and finish rarely
| Step | Panel | What to check | Action if off |
|---|---|---|---|
| 1 | Spend and results | Spend vs plan; ROAS vs prior 7 days | Open panels 2 and 3 to find the cause |
| 2 | Efficiency | eCPM, CTR and cost per key conversion direction | High eCPM: audience or competition. Low CTR: the headline and image |
| 3 | Campaigns | The campaign with the largest change | Review budget and targeting of that campaign |
| 4 | Community and placement | Communities with high spend and low CTR | Exclude or rework the targeting for those communities |
| 5 | Video | Completed views vs starts | 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.
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.
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
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
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
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
Saved fixed layout
- Reddit Ads API v3
- Whatever you build
- Ryze AI
- Prompts in chat; no layout is saved by this method
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
| Question | Reddit Ads API v3 | Ryze AI |
|---|---|---|
| Price | No API fee is stated in the docs opened for this page | Paid Ads $89/mo, 7-day free trial |
| Set-up | API app, OAuth token and code for each request | Sign in with your Reddit login; no keys to copy |
| Accounts | One ad account id per report request | Every ad account the login reaches, with Agent default accounts to pick the first ones |
| Breakdowns | Up to 3, or 4 with COUNTRY and REGION | Date, campaign, ad group, ad, country, placement or community |
| Saved fixed layout | Whatever you build | Prompts in chat; no layout is saved by this method |
| Acting on findings | Campaign, ad group and ad endpoints in the same API | 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.
Own database or a custom chart
- Use
- The Ads API, with the field names above
A quick look at one account
- Use
- Reddit Ads Manager
Several ad accounts or changing questions
- Use
- Ryze AI prompts
Acting on what the numbers show
- Use
- Ryze AI write tool, with approvals switched on
| Situation | Use |
|---|---|
| Own database or a custom chart | The Ads API, with the field names above |
| A quick look at one account | Reddit Ads Manager |
| Several ad accounts or changing questions | Ryze AI prompts |
| Acting on what the numbers show | 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
- Reddit Ads API v3 OpenAPI fileReport endpoint, request properties, field and breakdown values, scaling notes, rate-limit policy, December 8, 2026 change. Opened Nov 20, 2026.
- Reddit Ads API docsReference and changelog; checked for a Reddit-run MCP server. Opened Nov 20, 2026.
- Reddit Ads help centerAds Manager dashboard and custom columns are linked from the API docs; the pages did not load as text on Nov 20, 2026.
- Ryze AI Reddit Ads guideConnection, access and tools.
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?
Which API endpoint returns Reddit Ads report data?
How many breakdowns can a Reddit Ads report have?
Why do my Reddit Ads spend numbers look huge?
Show 7 more questionsShow fewer questions
Why are conversions zero in my Reddit report?
Can Ryze AI build a Reddit Ads dashboard?
Which Ryze AI tools read Reddit Ads data?
Can I use several Reddit ad accounts in one chat?
Can the agent change my account while I build a dashboard?
Does Reddit have its own MCP server?
How much does Ryze AI cost for this?
Related guides
TikTok Ads dashboard
14 TikTok Ads metrics with Marketing API names and a 5-panel template.
Pinterest Ads dashboard
14 Pinterest Ads metrics with API v5 column names and a 5-panel template.
LinkedIn Ads dashboard
LinkedIn Ads metrics with API names and a panel template.
Google Ads dashboard
14 Google Ads metrics with API field names and a 5-panel template.





