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 access) |
| Permissions needed | Account Admin, Campaign Manager, or Viewer role on each Reddit ad account; ability to authorize the adsread scope |
| Account discovery | Automatic when you sign in, through the Reddit Businesses your user belongs to |
| Data freshness | Daily (one scheduled refresh per day) |
| Lookback window | Each daily refresh re-pulls the last 30 days plus today |
| 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 | No. Reddit is available to all workspaces. |
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
Steps to Connect
Step 1: Sign in with Reddit from Clarisights
In Clarisights, open Integrations (the database-stack icon in the left sidebar). Under Set up new connection, search for Reddit and click + Connect on the Reddit card. A Reddit sign-in window opens. Sign in with the Reddit account that has access to the ad accounts you want to connect.
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 looks up every Reddit Business your user belongs to and discovers every ad account under each Business. Select the accounts you want to connect and click Connect 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
Open Integrations and, under Manage connected channels, open Reddit. Each account you connected is listed under Connected Account with its Status switch turned on. After the first sync, the Last refreshed column shows when data was last pulled.
First data appears after the next scheduled sync (typically within 24 hours).
Quick start: create a new report, add Reddit 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 Percent | Video quartile completion counts |
Reddit conversion metrics appear in Clarisights with the Conversions - prefix, for example Conversions - Purchase Clicks and Conversions - Purchase Total Value. Clicks and Views are the click-attributed and view-attributed conversions for each event.
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
Longer backfills take time: Reddit reports are requested in small date windows, so refreshing a long date range takes longer than a regular daily refresh.
Rate limits: Reddit limits how many requests an app can make. When Reddit is busy or rate limits a request, Clarisights retries automatically, so no action is needed.
Currency normalization: Reddit returns spend in micro-units and conversion values in the currency's minor unit (for example cents for USD). Clarisights converts both to whole-currency units.
~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 once a day.
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 discovered when you sign in. New ad accounts are not added automatically: open Reddit from Manage connected channels, click + Account, sign in again, then select the new accounts and click Connect Accounts.
Currency conversion: account-native amounts are pulled and normalized; Clarisights then converts them to your reporting currency.
Reconnecting: Clarisights requests permanent access, so it renews Reddit's short-lived access automatically during every refresh. You only need to reconnect if you change your Reddit password, are removed from the relevant ad accounts or Business, or revoke Clarisights' access. To reconnect, open Reddit from Manage connected channels, click Refresh Token next to the connected user and sign in to Reddit again.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and account ID (Integrations → Reddit)
The exact error message or screenshot
The step where the issue occurred
When the issue started