Connecting Reddit Ads on Clarisights
Connect your Reddit Ads accounts to monitor campaign performance, video engagement, lead generation, and conversion outcomes alongside the rest of your marketing stack.
At a glance
| Authentication | OAuth 2.0 (Reddit Ads API v3, permanent grant) |
| Permissions needed | Account Admin, Campaign Manager, or Viewer role on each Reddit ad account; ability to authorize the adsread scope |
| Account discovery | Automatic on credential validation — discovered via the Reddit Business hierarchy your user belongs to |
| Data freshness | Daily (Reddit reports are accurate up to ~3 hours behind real time) |
| Lookback window | 30 days |
| Backfill on connect | Last 30 days |
| Timezone | Account native timezone (read from Reddit on first sync; report dates converted to UTC for the API call and stored in the account's timezone) |
| Currency | Account native currency. Reddit returns spend in micro-units and conversion values in the currency's minor unit; both are normalized to whole-currency units in Clarisights. |
| Levels supported | Account · Campaign · Ad Group · Ad |
| Limited rollout | Yes — Reddit Ads is currently a hidden integration. Contact your Clarisights CSM to have it enabled for your workspace. |
Prerequisites
An active Reddit Ads account managed in Reddit Ads Manager
A user role on each ad account: Account Admin, Campaign Manager, or Viewer
Membership in the Reddit Business that owns the ad accounts (Reddit's API discovers ad accounts through the Business hierarchy, not directly from a user)
Permission to authorize third-party apps on your Reddit account
The Reddit Ads integration enabled on your Clarisights workspace (ask your CSM)
Steps to Connect
Step 1 — Sign in with Reddit from Clarisights
In Clarisights, go to Integrations → Reddit Ads and click Connect. You'll be redirected to Reddit to authenticate. Sign in with the Reddit account that has access to the ad accounts you want to connect.
[TODO: Screenshot needed — Clarisights Integrations page Reddit Ads tile and Connect button]
Step 2 — Authorize Clarisights
Reddit displays a permission screen requesting the adsread scope and a permanent duration (so the integration can keep refreshing without re-prompts). Click Allow.
[TODO: Screenshot needed — Reddit OAuth consent screen showing adsread scope and permanent duration]
⚠ Common error: "You don't have permission to authorize this app." → The Reddit user you signed in with does not have the required role on any ad account, or your Reddit Business admin has restricted external apps. Ask the Reddit Business admin to grant access, or sign in with a different user that has the required role.
Step 3 — Select ad accounts
After authorization, Clarisights walks the Reddit Business hierarchy your user belongs to and auto-discovers every ad account under each Business. Select the accounts you want to connect, optionally rename them, and click Create Accounts.
⚠ Common error: "No ad accounts found." → Either your Reddit user is not a member of any Business, or the Business has no ad accounts the user can read. In Reddit Ads Manager, confirm the user is added to the right Business and has at least Viewer role on the desired ad accounts, then re-run the connection flow.
Verify the connection
Go to Integrations → Reddit Ads. Each connected account should show a "Connected" status.
First data appears after the next scheduled sync (typically within 24 hours).
Quick start: create a new report, add Reddit Ads as the data source, and pull Account · Campaign · Impressions · Clicks · Spend.
Data available
Hierarchy
How Reddit's native levels map to the standard Clarisights levels:
Native level (Reddit) | Clarisights level |
Ad Account | Account |
Campaign | Campaign |
Ad Group | Ad Group |
Ad | Ad |
Dimensions
Dimension | Level | Description |
Account Type | Account | Type of Reddit ad account |
Account Business ID | Account | Reddit Business that owns the account |
Account Click Attribution Window | Account | Click-attribution window configured at account level |
Account View Attribution Window | Account | View-attribution window configured at account level |
Account Attribution Type | Account | Attribution model used by the account |
Account Created At | Account | When the ad account was created |
Campaign Objective | Campaign | Campaign objective (Awareness, Traffic, Conversions, Video Views, Lead Gen, App Installs, Catalog Sales) |
Campaign Effective Status | Campaign | Live serving status determined by Reddit |
Campaign Configured Status | Campaign | Status set by the user |
Campaign Goal Type / Goal Value | Campaign | Goal configuration on the campaign |
Campaign Spend Cap | Campaign | Total spend cap for the campaign |
Campaign Created At / Modified At | Campaign | Creation and last-modified timestamps |
AdGroup Bid Strategy / Bid Type / Bid Value | Ad Group | Bidding configuration on the ad group |
AdGroup Configured / Effective Status | Ad Group | Configured vs. live serving status |
AdGroup Goal Type / Goal Value | Ad Group | Optimization goal at ad-group level |
AdGroup Optimization Goal | Ad Group | What the ad group is optimizing for |
AdGroup Schedule / Start Time | Ad Group | Run schedule and start time |
AdGroup Created At / Modified At | Ad Group | Creation and last-modified timestamps |
Ad Post ID | Ad | Reddit post backing the ad |
Ad Post URL | Ad | Permalink to the underlying post |
Ad Preview URL | Ad | Preview link for the ad creative |
Ad Effective / Configured Status | Ad | Live serving status vs. configured status |
Ad Created At / Modified At | Ad | Creation and last-modified timestamps |
Metrics
Core delivery
Metric | Description |
Impressions | Total ad displays |
Clicks | Total clicks |
Spend | Total spend in account currency (Reddit returns this in micro-units; Clarisights converts to whole units) |
Engagement & video
Metric | Description |
Base — Key Conversion Clicks | Click conversions on the account's primary key event |
Base — Conversion Views | View conversions on the account's primary key event |
Base — Reddit Leads | Lead-form completions natively on Reddit |
Base — Fully Viewable Impressions | Video impressions counted as fully viewable |
Base — Video Started | Video playback starts |
Base — Video Watched 25% / 50% / 75% / 100% | Video quartile completion counts |
Conversions — Add to Cart
Metric | Description |
Add to Cart Clicks / Views | Click- and view-attributed add-to-cart conversions |
Add to Cart Total Items | Total items added to cart |
Add to Cart Total Value | Total cart value (account currency) |
Conversions — Add to Wishlist
Metric | Description |
Add to Wishlist Clicks / Views | Click- and view-attributed add-to-wishlist events |
Add to Wishlist Total Items / Total Value | Aggregate quantity and value of wishlisted items |
Conversions — Lead
Metric | Description |
Lead Clicks / Views | Lead conversions by attribution path |
Lead Total Value | Total value of lead conversions |
Conversions — Page Visit
Metric | Description |
Page Visit Clicks / Views | Page-visit conversions by attribution path |
Conversions — Purchase
Metric | Description |
Purchase Clicks / Views | Purchase conversions by attribution path |
Purchase Total Value | Total purchase value (account currency) |
Conversions — Search, Sign Up, View Content
Metric | Description |
Search Clicks / Views | Search conversions by attribution path |
Sign Up Clicks / Views | Sign-up conversions by attribution path |
Signup Total Value | Total value of sign-up conversions |
View Content Clicks / Views | View-content conversions by attribution path |
Custom metrics
Additional Reddit reporting fields can be added as custom metrics — ask your Clarisights contact to extend the schema with the specific Reddit field you need.
Limitations & known constraints
Date range chunking: Reddit recommends keeping report queries to small windows. Clarisights automatically splits requests into 7-day chunks per ad account and stitches them back together; this is invisible to you, but it is why a 30-day backfill takes longer than a single API call.
Rate limits: Reddit Ads API limits requests per second per app. With many ad accounts in parallel, expect occasional HTTP 429s — Clarisights retries with exponential backoff (up to 5 attempts) on rate limits, server errors, gateway timeouts, and service unavailable.
Currency normalization: Reddit returns
Spendin micro-units (10-6) and conversion values in the currency's minor unit (e.g. cents for USD). Clarisights normalizes both to whole-currency units before storage.~3-hour reporting delay: Reddit's reporting data is accurate up to roughly 3 hours behind real time. Same-day numbers may continue to settle for a few hours after the day ends.
Business hierarchy required: Ad accounts are discovered via the Reddit Business endpoint. A Reddit user that has direct ad-account access without belonging to a Business may not surface accounts through this integration.
Token revocation: If you revoke Clarisights' access in your Reddit settings, the integration stops syncing until you re-authenticate.
Operating notes
Refresh schedule: data is pulled daily.
Lookback: the daily pull refreshes the last 30 days, so late-arriving conversions and adjustments are picked up.
Multi-account behavior: every ad account reachable through the authorized user's Reddit Businesses is auto-discovered. New ad accounts are surfaced when you re-open the integration.
Currency conversion: account-native amounts are pulled and normalized; Clarisights then converts them to your reporting currency.
Credential rotation: OAuth refresh tokens issued with
duration=permanentrotate automatically. You only need to re-authenticate if you change your Reddit password, are removed from the relevant ad accounts/Business, or revoke Clarisights' access.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → Reddit Ads)
The exact error message or screenshot
The step where the issue occurred
When the issue started