Reddit Ads Field Reference

Sample

 

https://connectors.windsor.ai/reddit?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv


Fields

IDTypeNameDescription
account_attribution_typeTEXTAccount Attribution TypeThe Account Attribution Type
account_click_attribution_windowTEXTAccount Click Attribution WindowThe Account Click Attribution Window
account_currencyTEXTAccount currencyThe currency this account uses (ISO-4217)
account_idTEXTAccount IDThe Account ID
account_nameTEXTAccount NameThe Account Name
account_view_attribution_windowTEXTAccount View Attribution WindowThe Account View Attribution Window
ad_click_urlTEXTAd Click URLThe Ad's click URL
ad_configured_statusTEXTAd Configured StatusThe status that the user has configured this ad to have. Can differ from the effective; status depending on the context such as pending billing information.;
ad_effective_statusTEXTAd Effective StatusThe calculated status determining the real status of this ad.
ad_group_configured_statusTEXTAd Group Configured StatusThe status of the ad group configured by the account owner.
ad_group_effective_statusTEXTAd Group Effective StatusThe calculated status determining the real status of this ad group.
ad_group_idTEXTAd Group IDAd Group ID
ad_group_nameTEXTAd Group NameAd group name
ad_idTEXTAd IDThe id of the Ad
ad_nameTEXTAd NameThe name of the Ad
ad_rejection_reasonTEXTAd Rejection ReasonThe reason why the ad was rejected
ad_search_termTEXTAd Search TermThe 'Search Term' that is displayed on a promoted trend
campaignTEXTCampaignThe Campaign Name
campaign_configured_statusTEXTCampaign Configured StatusThe status that the user has configured this campaign to have. Can differ from the effective; status depending on the context such as pending billing information.;
campaign_effective_statusTEXTCampaign Effective StatusThe calculated status determining the real status of this campaign.
campaign_idTEXTCampaign IDThe ID of the Campaign
campaign_nameTEXTCampaign NameThe Campaign Name
campaign_objectiveTEXTCampaign ObjectiveThe calculated status determining the real status of this campaign.
clicksNUMERICClicksThe Number of Clicks
cpcNUMERICCPCThe Cost-per-click
cpmNUMERICCPMThe Cost per thousand impressions
ctrPERCENTCTRThe Click-through rate
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateThe Date
day_of_monthTEXTDay of monthDay of the month
impressionsNUMERICimpressionsThe Number of Impressions Served
lead_total_valueNUMERICTotal Value (Lead)Total Value (Lead)
monthTEXTMonthNumber of the month
purchase_averageNUMERICAverage Value of purchasesAverage Value of purchases
purchase_total_itemsNUMERICTotal size of the purchaseTotal size of the purchase
purchase_total_valueNUMERICTotal Value (Purchase)Total Value (Purchase)
roasPERCENTROASPurchase ROAS (Return On Ad Spend)
signup_total_valueNUMERICTotal Value (Signup)Total Value (Signup)
sourceTEXTSourceThe name of the Windsor connector returning the row
spendNUMERICSpendThe Media Spend in USD
todayDATETodayToday's date
totalcostNUMERICTotal CostThe Media Spend in USD
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20