Integrations
Reddit Ads datasets and fields
The 11 datasets Maven lands from Reddit Ads, every field in them, and how the connection syncs.
Maven lands 11 datasets from Reddit Ads in each client workspace. This page lists every one with all of its fields. For the metrics, reports and setup steps, see the Reddit Ads integration page.
Connection and sync#
You connect Reddit Ads by signing in to it and approving access, so nobody shares a password.
The first Reddit Ads sync pulls the most recent 30 days so the workspace fills quickly. A follow-up backfill then adds older history, up to 2 years in total. After that, each scheduled sync re-reads the last 7 days, so late changes are picked up.
Datasets#
Accounts#
Reddit ad-account and owning-business reporting context.
| Field | Type |
|---|---|
| account ID | Text |
| account name | Text |
| business ID | Text |
| business name | Text |
| business country | Text |
| business industry | Text |
| currency | Text |
| time zone ID | Text |
| account type | Text |
| admin approval | Text |
| suspension reason | Text |
| spend cap type | Text |
| attribution type | Text |
| click attribution window | Text |
| view attribution window | Text |
| app attribution type | Text |
| app click attribution window | Text |
| app view attribution window | Text |
| created at | Timestamp |
| updated at | Timestamp |
Campaigns#
Reddit ad campaigns — snapshot of current campaign state.
| Field | Type |
|---|---|
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| configured status | Text |
| effective status | Text |
| delivery status | Text |
| objective | Text |
| optimization goal | Text |
| bid strategy | Text |
| bid type | Text |
| bid value | Number |
| goal type | Text |
| goal value | Number |
| spend cap | Number |
| is campaign budget optimization | True/false |
| is max | True/false |
| funding instrument ID | Text |
| conversion pixel ID | Text |
| app ID | Text |
| invoice label | Text |
| special ad categories | Text |
| view through conversion type | Text |
| start date | Date |
| end date | Date |
| created at | Timestamp |
| updated at | Timestamp |
Ad groups#
Reddit ad groups — snapshot of current ad group state.
| Field | Type |
|---|---|
| account ID | Text |
| account name | Text |
| ad group ID | Text |
| campaign ID | Text |
| ad group name | Text |
| configured status | Text |
| effective status | Text |
| delivery status | Text |
| campaign objective type | Text |
| optimization goal | Text |
| bid strategy | Text |
| bid type | Text |
| bid value | Number |
| goal type | Text |
| goal value | Number |
| is campaign budget optimization | True/false |
| conversion pixel ID | Text |
| app ID | Text |
| product set ID | Text |
| saved audience ID | Text |
| shopping type | Text |
| targeting json | Text |
| schedule json | Text |
| view through conversion type | Text |
| start date | Date |
| end date | Date |
| created at | Timestamp |
| updated at | Timestamp |
Configured target coverage#
| Field | Type |
|---|---|
| coverage key | Text |
| account ID | Text |
| scope level | Text |
| collection status | Text |
| source entity count | Integer |
| configured target count | Integer |
| capability reason | Text |
| collected at | Timestamp |
Ads#
Reddit ads — snapshot of current ad state.
| Field | Type |
|---|---|
| account ID | Text |
| account name | Text |
| ad ID | Text |
| campaign ID | Text |
| ad group ID | Text |
| ad name | Text |
| configured status | Text |
| effective status | Text |
| delivery status | Text |
| rejection reason | Text |
| ad type | Text |
| campaign objective type | Text |
| click URL | Text |
| post ID | Text |
| post URL | Text |
| profile ID | Text |
| profile username | Text |
| preview URL | Text |
| products json | Text |
| event trackers json | Text |
| created at | Timestamp |
| updated at | Timestamp |
Ad performance#
Daily Reddit Ads delivery, conversion, lead, and video facts at ad grain.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad group ID | Text |
| ad group name | Text |
| ad ID | Text |
| ad name | Text |
| impressions | Integer |
| clicks | Integer |
| spend | Number |
| conversions | Integer |
| conversion value | Number |
| reach | Integer |
| frequency | Number |
| engaged clicks | Integer |
| reddit leads | Integer |
| key conversion clicks | Integer |
| key conversion views | Integer |
| page visit clicks | Integer |
| page visit views | Integer |
| add to cart clicks | Integer |
| add to cart views | Integer |
| add to cart items | Integer |
| add to cart value | Number |
| purchase clicks | Integer |
| purchase views | Integer |
| purchase items | Integer |
| purchase value | Number |
| lead clicks | Integer |
| lead views | Integer |
| lead value | Number |
| signup clicks | Integer |
| signup views | Integer |
| signup value | Number |
| view content clicks | Integer |
| view content views | Integer |
| video starts | Integer |
| video 25 pct | Integer |
| video 50 pct | Integer |
| video 75 pct | Integer |
| video 95 pct | Integer |
| video 100 pct | Integer |
| video 3 second views | Integer |
| video 5 second views | Integer |
| video 10 second views | Integer |
| video viewable 6 second views | Integer |
| video viewable 15 second views | Integer |
| video plays with sound | Integer |
| video plays expanded | Integer |
| video viewable impressions | Integer |
| video fully viewable impressions | Integer |
| metrics updated at | Timestamp |
| reporting timezone | Text |
Conversion actions#
Provider-attributed Reddit standard and custom conversion actions at ad/day grain.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad group ID | Text |
| ad group name | Text |
| ad ID | Text |
| ad name | Text |
| conversion action ID | Text |
| conversion action name | Text |
| conversion action type | Text |
| click conversions | Integer |
| view conversions | Integer |
| conversions | Integer |
| conversion value | Number |
| attribution window | Text |
| metrics updated at | Timestamp |
Custom conversion events#
Per-pixel Reddit custom-event names and provider slot ordering from Last Fired At.
| Field | Type |
|---|---|
| event key | Text |
| account ID | Text |
| pixel ID | Text |
| event index | Integer |
| event name | Text |
| last fired at | Timestamp |
Conversion report coverage daily#
Successful Reddit native conversion-report coverage, including empty dates.
| Field | Type |
|---|---|
| coverage key | Text |
| date | Date |
| account ID | Text |
| report name | Text |
| requested grain | Text |
| reported grain | Text |
| report status | Text |
| row count | Integer |
| is partial | True/false |
Targeting performance daily#
Daily ad-level Reddit country, region, and DMA delivery and conversions from DATE-breakdown reports.
| Field | Type |
|---|---|
| date | Date |
| breakdown type | Text |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad group ID | Text |
| ad group name | Text |
| ad ID | Text |
| ad name | Text |
| country | Text |
| region | Text |
| dma | Text |
| impressions | Integer |
| clicks | Integer |
| spend | Number |
| reach | Integer |
| frequency | Number |
| conversions reported | True/false |
| conversions | Integer |
| key conversion clicks | Integer |
| key conversion views | Integer |
| purchase clicks | Integer |
| purchase views | Integer |
| purchase value | Number |
| lead clicks | Integer |
| lead views | Integer |
| signup clicks | Integer |
| signup views | Integer |
| metrics updated at | Timestamp |
| reporting timezone | Text |
Carousel card daily#
Daily Reddit delivery at ad x carousel card. Reddit does not document whether card rows partition the ad's delivery, so values are stored exactly as reported and must not be summed across cards.
| Field | Type |
|---|---|
| date | Date |
| account ID | Text |
| account name | Text |
| campaign ID | Text |
| campaign name | Text |
| ad group ID | Text |
| ad group name | Text |
| ad ID | Text |
| ad name | Text |
| post ID | Text |
| gallery item ID | Text |
| impressions | Integer |
| clicks | Integer |
| spend | Number |
| conversions reported | True/false |
| conversions | Integer |
| key conversion clicks | Integer |
| key conversion views | Integer |
| purchase clicks | Integer |
| purchase views | Integer |
| purchase value | Number |
| lead clicks | Integer |
| lead views | Integer |
| signup clicks | Integer |
| signup views | Integer |
| video starts | Integer |
| metrics updated at | Timestamp |
| reporting timezone | Text |