Overview
The Reddit Ads API provides programmatic access to campaign, ad group, and creative performance metrics for paid campaigns on Reddit. It supports Promoted Posts, video ads, carousel ads, and app install campaigns, enabling marketers to track performance, optimise campaigns, and integrate Reddit advertising data into dashboards.
Data handled by the integration:
Account & Campaign Data
Advertiser accounts and account IDs
Campaigns and ad groups
Campaign objectives (traffic, conversions, app installs, awareness)
Budgets, bids, and pacing configurations
Campaign and ad group status (active, paused, completed)
Creative & Ad Data
Creative metadata: ad ID, format (image, video, carousel, text)
Associated campaign and ad group
Media assets (images, videos), headlines, and descriptions
Call-to-action types
Approval status and policy compliance
Performance Metrics
Impressions, clicks, CTR
Cost, CPC, CPM, spend
Conversions and conversion value
Engagement metrics: upvotes, downvotes, comments, shares
Video metrics: views, watch time, completion rates
App install metrics (for app campaigns)
Audience & Targeting
Demographics: age, gender, location
Interests and subreddit targeting
Device type and platform (desktop, mobile, tablet)
Retargeting / lookalike audiences
Metadata & Reference Tables
Account and campaign hierarchy
Ad format and creative type definitions
Conversion action definitions
Geographic and demographic mappings
Subreddit targeting taxonomy
Granularity:
This integration retrieves data at: Account, Campaign, Ad group, Ad and Creative Levels which can be broken down by device type, location and demographic.
Purpose:
Monitor Reddit ad campaign performance
Analyse ad group and creative effectiveness
Optimise targeting, bidding, and creative strategy
Track conversions and engagement metrics
Integrate Reddit Ads data into multi-channel dashboards
Conduct historical performance audits
Refresh Cadence:
Data is refreshed daily.
Update Modes:
Append (for data table), Refresh (for metadata)
For more information on this integration, please follow the link here.
Jobs Configuration
Job Label | Feed | Update Mode | Description |
Reddit Ads - Delivery Import | append | Reddit Ads - Delivery Data | |
Reddit Ads - Meta Refresh | refresh | Reddit - Meta Refresh |
Delivery Import Job Details
Feed: reddit
Table:
reddit_data_adDate column:
bright_custom_dateCreate target: true
Priority: 1
Targets:
Type: data
Description: Reddit Ads - Delivery Data
Meta Refresh Job Details
Feed: reddit
Tables and priorities:
reddit_meta_campaigns(priority 1)reddit_meta_ad_groups(priority 2)reddit_meta_ads(priority 3)
Update mode: refresh
Create targets: true
Connection Options Table
Key | Type | Required | Size | Description | Hint |
reddit_client_id | hidden | No | 50 | Reddit client ID | Reddit client ID |
reddit_client_secret | hidden | No | 50 | Reddit client secret (UI-generated) | Reddit client secret generated in the UI |
reddit_accounts | text | Yes | 100 | Reddit Ads Account IDs (comma-separated) | Comma delimited list of account ids |
Dimensions
Dimension Name | Result Field |
Campaign [Reddit] | reddit_meta_campaigns.name |
AdGroup [Reddit] | reddit_meta_ad_groups.name |
Ad [Reddit] | reddit_meta_ads.name |
Base Metrics
Name | Formula | Prefix |
Spend [Reddit] | SUM({reddit_data_ad.spend}) / 1000000 | £ |
Clicks [Reddit] | SUM({reddit_data_ad.clicks}) | - |
Impressions [Reddit] | SUM({reddit_data_ad.impressions}) | - |
Video Viewable Impressions | SUM({reddit_data_ad.video_viewable_impressions}) | - |
Video Fully Viewable Impressions | SUM({reddit_data_ad.video_fully_viewable_impressions}) | - |
Video 3s Watched | SUM({reddit_data_ad.video_watched_3_seconds}) | - |
Video 50% Watched | SUM({reddit_data_ad.video_watched_50_percent}) | - |
Video 75% Watched | SUM({reddit_data_ad.video_watched_75_percent}) | - |
Video 95% Watched | SUM({reddit_data_ad.video_watched_95_percent}) | - |
Video 100% Watched | SUM({reddit_data_ad.video_watched_100_percent}) | - |
Datasource Joins
Join Spec # | LHS Column | RHS Table | RHS Column |
0 | ad_id | reddit_meta_ads | id |
1 | campaign_id | reddit_meta_campaigns | id |
2 | bright_custom_ad_group_id | reddit_meta_ad_groups | id |
Source table:
reddit_data_ad
Composite Metrics
Name | Round | Prefix | Suffix | Formula |
CTR [Reddit] | 2 | - | % | {Clicks [Reddit]} / {Impressions [Reddit]} * 100 |
CPC [Reddit] | 2 | £ | - | {Spend [Reddit]} / {Clicks [Reddit]} |
CPM [Reddit] | 2 | £ | - | ({Spend [Reddit]} / {Impressions [Reddit]}) * 1000 |
CPCV [Reddit] | 2 | £ | - | {Spend [Reddit]} / {Video 100% Watched [Reddit]} |