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.

FieldType
account IDText
account nameText
business IDText
business nameText
business countryText
business industryText
currencyText
time zone IDText
account typeText
admin approvalText
suspension reasonText
spend cap typeText
attribution typeText
click attribution windowText
view attribution windowText
app attribution typeText
app click attribution windowText
app view attribution windowText
created atTimestamp
updated atTimestamp

Campaigns#

Reddit ad campaigns — snapshot of current campaign state.

FieldType
account IDText
account nameText
campaign IDText
campaign nameText
configured statusText
effective statusText
delivery statusText
objectiveText
optimization goalText
bid strategyText
bid typeText
bid valueNumber
goal typeText
goal valueNumber
spend capNumber
is campaign budget optimizationTrue/false
is maxTrue/false
funding instrument IDText
conversion pixel IDText
app IDText
invoice labelText
special ad categoriesText
view through conversion typeText
start dateDate
end dateDate
created atTimestamp
updated atTimestamp

Ad groups#

Reddit ad groups — snapshot of current ad group state.

FieldType
account IDText
account nameText
ad group IDText
campaign IDText
ad group nameText
configured statusText
effective statusText
delivery statusText
campaign objective typeText
optimization goalText
bid strategyText
bid typeText
bid valueNumber
goal typeText
goal valueNumber
is campaign budget optimizationTrue/false
conversion pixel IDText
app IDText
product set IDText
saved audience IDText
shopping typeText
targeting jsonText
schedule jsonText
view through conversion typeText
start dateDate
end dateDate
created atTimestamp
updated atTimestamp

Configured target coverage#

FieldType
coverage keyText
account IDText
scope levelText
collection statusText
source entity countInteger
configured target countInteger
capability reasonText
collected atTimestamp

Ads#

Reddit ads — snapshot of current ad state.

FieldType
account IDText
account nameText
ad IDText
campaign IDText
ad group IDText
ad nameText
configured statusText
effective statusText
delivery statusText
rejection reasonText
ad typeText
campaign objective typeText
click URLText
post IDText
post URLText
profile IDText
profile usernameText
preview URLText
products jsonText
event trackers jsonText
created atTimestamp
updated atTimestamp

Ad performance#

Daily Reddit Ads delivery, conversion, lead, and video facts at ad grain.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
impressionsInteger
clicksInteger
spendNumber
conversionsInteger
conversion valueNumber
reachInteger
frequencyNumber
engaged clicksInteger
reddit leadsInteger
key conversion clicksInteger
key conversion viewsInteger
page visit clicksInteger
page visit viewsInteger
add to cart clicksInteger
add to cart viewsInteger
add to cart itemsInteger
add to cart valueNumber
purchase clicksInteger
purchase viewsInteger
purchase itemsInteger
purchase valueNumber
lead clicksInteger
lead viewsInteger
lead valueNumber
signup clicksInteger
signup viewsInteger
signup valueNumber
view content clicksInteger
view content viewsInteger
video startsInteger
video 25 pctInteger
video 50 pctInteger
video 75 pctInteger
video 95 pctInteger
video 100 pctInteger
video 3 second viewsInteger
video 5 second viewsInteger
video 10 second viewsInteger
video viewable 6 second viewsInteger
video viewable 15 second viewsInteger
video plays with soundInteger
video plays expandedInteger
video viewable impressionsInteger
video fully viewable impressionsInteger
metrics updated atTimestamp
reporting timezoneText

Conversion actions#

Provider-attributed Reddit standard and custom conversion actions at ad/day grain.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
conversion action IDText
conversion action nameText
conversion action typeText
click conversionsInteger
view conversionsInteger
conversionsInteger
conversion valueNumber
attribution windowText
metrics updated atTimestamp

Custom conversion events#

Per-pixel Reddit custom-event names and provider slot ordering from Last Fired At.

FieldType
event keyText
account IDText
pixel IDText
event indexInteger
event nameText
last fired atTimestamp

Conversion report coverage daily#

Successful Reddit native conversion-report coverage, including empty dates.

FieldType
coverage keyText
dateDate
account IDText
report nameText
requested grainText
reported grainText
report statusText
row countInteger
is partialTrue/false

Targeting performance daily#

Daily ad-level Reddit country, region, and DMA delivery and conversions from DATE-breakdown reports.

FieldType
dateDate
breakdown typeText
account IDText
account nameText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
countryText
regionText
dmaText
impressionsInteger
clicksInteger
spendNumber
reachInteger
frequencyNumber
conversions reportedTrue/false
conversionsInteger
key conversion clicksInteger
key conversion viewsInteger
purchase clicksInteger
purchase viewsInteger
purchase valueNumber
lead clicksInteger
lead viewsInteger
signup clicksInteger
signup viewsInteger
metrics updated atTimestamp
reporting timezoneText

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.

FieldType
dateDate
account IDText
account nameText
campaign IDText
campaign nameText
ad group IDText
ad group nameText
ad IDText
ad nameText
post IDText
gallery item IDText
impressionsInteger
clicksInteger
spendNumber
conversions reportedTrue/false
conversionsInteger
key conversion clicksInteger
key conversion viewsInteger
purchase clicksInteger
purchase viewsInteger
purchase valueNumber
lead clicksInteger
lead viewsInteger
signup clicksInteger
signup viewsInteger
video startsInteger
metrics updated atTimestamp
reporting timezoneText