Skip to main content

​
Introduction

Reddit Ads is Reddit’s advertising platform, delivering promoted posts, video ads, and conversation placements across Reddit’s interest-based communities. It is used by performance and brand marketers to reach audiences segmented by subreddit, interest, and demographic targeting, with CPC, CPM, and CPV payment models across awareness, traffic, and conversion objectives. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. The connector covers paid campaigns only; for organic subreddit and post analytics, use the separate Reddit Public connector. To connect this data source, see How to connect Reddit to Adriel.

​
Data refresh strategy

​
Architecture data

Architecture covers ad accounts, campaigns, ad groups (ad sets), and ads. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC. On data source creation, the cache fills with 362 days of historical data for the ad account, campaign, ad set, and ad levels.

​
Reports data

Reports include daily performance metrics for ad accounts, campaigns, ad groups, and ads. Cache-only. Report data comes from cached daily performance snapshots. Dashboard queries always read from the last snapshot, never live from Reddit, so very recent changes in Reddit Ads Manager appear only after the next scheduled sync. Refresh schedule. Reports refresh every 3 hours at minute 0 UTC, syncing the last 90 days for:
  • Ad account, campaign, ad set, and ad
  • Country, OS, platform placement, gender, and region (each per ad account)
Data is reliable within the 90-day cache sync window. Data outside this range may be incomplete or inaccurate due to legacy caching behavior.

​
Architecture levels

Ad account → Campaign → Ad group (ad set) → Ad

​
Date range limits

Reddit Ads reports are available at daily granularity only; weekly and monthly report breakdowns are not offered. The maximum lookback is approximately 363 days, in line with Reddit’s 12-month API restriction. Requests for data older than this window return a from-date-too-old error. Data within the last 90 days is kept current by the scheduled cache refresh and is the most reliable; values outside that window may be incomplete.

​
Metrics

How to read the columnsData type uses Adriel’s vocabulary — Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like impressions is the literal Reddit Ads API field; italic marks a value Adriel computes or derives on its side rather than a single API field. Rate and average metrics are computed on demand because Reddit’s reporting API can’t aggregate them. Currency values are reported in each ad account’s configured Reddit Ads currency.

​
Campaign Attributes

​
Campaign Structure

​
Click Performance

Rate and average metrics such as CTR, CPC, CPM, and eCPM cannot be aggregated by Reddit’s reporting API, so Adriel computes them on demand from the underlying spend, click, and impression totals.

​
Computed Metrics

​
Conversion Performance

​
Creative Attributes

​
Engagement

​
Video Performance

​
Reddit-specific

These metrics exist only for Reddit and aren’t shared with other connectors.

​
Breakdowns

​
Campaign Structure

​
Creatives

Adriel post-processes ad creatives to generate these breakdowns.

​
Date

Reddit Ads returns daily records; Adriel groups them into these views, so all time breakdowns are Adriel-side aggregations of the same underlying daily data.

​
Others

​
Target

Country, Gender, Operating System, Region, and Placement breakdowns are reported at the ad account level only and can’t be combined with campaign, ad set, or ad granularity in the same query.

​
Reddit-specific

These breakdowns exist only for Reddit and aren’t shared with other connectors.

​
Limitations

  • Cache-only reads. Dashboards never query Reddit live for reports. All metric values come from the most recent cache snapshot, so recent changes inside Reddit Ads Manager appear only after the next scheduled sync.
  • Uniqueness over longer ranges. Metrics based on uniqueness (such as reach) can be overvalued when viewed for a date period longer than one day, because uniqueness is computed per snapshot rather than across the full range.
  • Breakdowns scoped to ad account. Demographic, geographic, device, and placement breakdowns (country, region, gender, OS, platform placement) are available at the ad account level only and cannot be combined with campaign, ad set, or ad granularity.
  • Daily reporting only. Reports support day-level granularity only; weekly and monthly report breakdowns are not available.
  • Maximum lookback. Reports cannot be queried beyond approximately 363 days, in line with Reddit’s 12-month API restriction; older requests return a from-date-too-old error.
  • Reliable window. Data older than the 90-day cache sync window may be incomplete, missing, or inaccurate due to legacy caching behavior.
  • Deleted elements. Deleted campaigns, ad sets, and ads are not provided by the connector.
  • Non-aggregatable metrics. Rate, average, and effective-cost metrics (such as CTR, CPC, CPV, eCPM, eCPC, and eCPA) cannot be requested directly from Reddit’s reporting API; Adriel computes them on demand from raw totals.

​
API references

  • Reddit Ads API v3 — base URL ads-api.reddit.com/api/v3/. Reports are fetched by POST to ad_accounts/{id}/reports.
  • Authentication — OAuth 2.0 authorization code flow. After authorization, the refresh token is stored and access tokens are renewed automatically. Requested scopes: adsread, history, identity, adsconversions, adsedit.
  • Currency — inherited from the connected Reddit ad account.
  • Rate limit — Reddit enforces a maximum of one request per 12 seconds per ad account; global per-owner limits may also apply.

​
See also