Reddit Ads: Most-used fields

The table below gives information about most-used fields that you can import from Reddit Ads. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
account_created_at	account_created_at	The timestamp indicating when the ad account was created.	dimension
account_currency	account_currency	The currency code used for the ad account.	dimension
account_id	account_id	A unique identifier for the ad account.	dimension
account_name	account_name	The name of the ad account.	dimension
account_status	account_status	The current operational status of the ad account.	dimension
ad_click_url	ad_click_url	The destination URL configured for the ad clicks.	dimension
ad_configured_status	ad_configured_status	The status that the user has manually configured for the ad. This can differ from the effective status based on other factors.	dimension
ad_effective_status	ad_effective_status	The calculated current operational status of the ad, considering all relevant factors.	dimension
ad_group_configured_status	ad_group_configured_status	The status that the user has manually configured for the ad group. This can differ from the effective status based on other factors.	dimension
ad_group_effective_status	ad_group_effective_status	The calculated current operational status of the ad group, considering all relevant factors.	dimension
ad_group_end_time	ad_group_end_time	The date and time when the ad group is scheduled to end.	dimension
ad_group_goal_type	ad_group_goal_type	The type of goal set for the ad group (e.g., clicks, conversions).	dimension
ad_group_goal_value	ad_group_goal_value	The value associated with the goal set for the ad group.	metric
ad_group_id	ad_group_id	A unique identifier for the ad group.	dimension
ad_group_name	ad_group_name	The name of the ad group.	dimension
ad_group_schedule_end_day	ad_group_schedule_end_day	The day of the week when an ad group’s scheduled delivery ends.	dimension
ad_group_schedule_end_hour	ad_group_schedule_end_hour	The hour of the day when an ad group’s scheduled delivery ends.	dimension
ad_group_schedule_start_day	ad_group_schedule_start_day	The day of the week when an ad group’s scheduled delivery starts.	dimension
ad_group_targeting_devices	ad_group_targeting_devices	A summary or list of device targeting criteria applied to the ad group.	dimension
ad_group_targeting_geolocations	ad_group_targeting_geolocations	A summary or list of geographic locations targeted for the ad group.	dimension
ad_id	ad_id	A unique identifier for the ad.	dimension
ad_name	ad_name	The name of the ad.	dimension
ad_post_id	ad_post_id	The unique identifier of the Reddit post that is being promoted as an ad.	dimension
campaign_configured_status	campaign_configured_status	The status that the user has manually configured for the campaign. This can differ from the effective status based on other factors.	dimension
campaign_effective_status	campaign_effective_status	The calculated current operational status of the campaign, considering all relevant factors.	dimension
campaign_id	campaign_id	A unique identifier for the campaign.	dimension
campaign_name	campaign_name	The name of the campaign.	dimension
campaign_objective	campaign_objective	The marketing objective set for the campaign (e.g., reach, traffic, conversions).	dimension
clicks	clicks	The total number of clicks on your ad.	metric
community	community	The Reddit community (subreddit) targeted by the ad.	dimension
conversion_add_to_cart_avg_value	conversion_add_to_cart_avg_value	The average monetary value of items added to a shopping cart as a result of an ad conversion event.	metric
conversion_add_to_cart_clicks	conversion_add_to_cart_clicks	The number of clicks that led to an add-to-cart conversion event.	metric
conversion_add_to_cart_total_items	conversion_add_to_cart_total_items	The total number of items added to a shopping cart as a result of an ad conversion event.	metric
conversion_add_to_cart_total_value	conversion_add_to_cart_total_value	The total monetary value generated from add-to-cart conversion events.	metric
conversion_add_to_cart_views	conversion_add_to_cart_views	The number of views that led to an add-to-cart conversion event.	metric
conversion_add_to_wishlist_avg_value	conversion_add_to_wishlist_avg_value	The average monetary value of items added to a wishlist as a result of an ad conversion event.	metric
conversion_add_to_wishlist_total_items	conversion_add_to_wishlist_total_items	The total number of items added to a wishlist as a result of an ad conversion event.	metric
conversion_add_to_wishlist_total_value	conversion_add_to_wishlist_total_value	The total monetary value generated from add-to-wishlist conversion events.	metric
conversion_lead_avg_value	conversion_lead_avg_value	The average monetary value generated from lead conversion events.	metric
conversion_lead_clicks	conversion_lead_clicks	The number of clicks that led to a lead conversion event.	metric
conversion_lead_total_value	conversion_lead_total_value	The total monetary value generated from lead conversion events.	metric
conversion_lead_views	conversion_lead_views	The number of views that led to a lead conversion event.	metric
conversion_page_visit_clicks	conversion_page_visit_clicks	The number of clicks that led to a page visit conversion event.	metric
conversion_page_visit_views	conversion_page_visit_views	The number of views that led to a page visit conversion event.	metric
conversion_purchase_avg_value	conversion_purchase_avg_value	The average monetary value of purchases made as a result of an ad conversion event.	metric
conversion_purchase_clicks	conversion_purchase_clicks	The number of clicks that led to a purchase conversion event.	metric
conversion_purchase_total_items	conversion_purchase_total_items	The total number of items purchased as a result of conversion events.	metric
conversion_purchase_total_value	conversion_purchase_total_value	The total monetary value generated from purchase conversion events.	metric
conversion_purchase_views	conversion_purchase_views	The number of views that led to a purchase conversion event.	metric
conversion_roas	conversion_roas	The Return On Ad Spend (ROAS), which measures the revenue generated for each unit of currency spent on advertising.	metric
conversion_search_clicks	conversion_search_clicks	The number of clicks that led to a search conversion event.	metric
conversion_search_views	conversion_search_views	The number of views that led to a search conversion event.	metric
conversion_sign_up_clicks	conversion_sign_up_clicks	The total number of clicks attributed to a sign-up conversion event.	metric
conversion_sign_up_ecpa	conversion_sign_up_ecpa	The effective cost-per-acquisition (eCPA) for a sign-up conversion event.	metric
conversion_sign_up_views	conversion_sign_up_views	The number of views recorded for a sign-up conversion event.	metric
conversion_signup_avg_value	conversion_signup_avg_value	The average monetary value generated from sign-up conversion events.	metric
conversion_signup_total_value	conversion_signup_total_value	The total monetary value generated from sign-up conversion events.	metric
conversion_view_content_clicks	conversion_view_content_clicks	The number of clicks that led to a view content conversion event.	metric
conversion_view_content_views	conversion_view_content_views	The number of views that led to a view content conversion event.	metric
country	country	The country where the ad was displayed or targeted.	dimension
cpc	cpc	The average cost per click for your ads.	metric
ctr	ctr	The click-through rate, calculated as clicks divided by impressions.	metric
currency	currency	The currency in which the financial data is reported.	dimension
date	date	The specific date for which the data is reported.	dimension
dma	dma	Designated Market Area (DMA) related to ad performance, often used for geographical reporting or targeting.	metric
ecpm	ecpm	The effective cost per thousand impressions.	metric
impressions	impressions	The total number of times your ad was shown to users.	metric
placement	placement	The location where the ad was displayed (e.g., feed, sidebar).	dimension
spend	spend	The total amount of money spent on advertising campaigns.	metric
video_completion_rate	video_completion_rate	The percentage of video ads that were watched to 100% completion.	metric
video_fully_viewable_impressions	video_fully_viewable_impressions	The number of impressions where the video ad was 100% in view for at least two consecutive seconds.	metric
video_plays_expanded	video_plays_expanded	The number of times a video ad was played in an expanded view.	metric
video_plays_with_sound	video_plays_with_sound	The number of times a video ad was played with sound enabled.	metric
video_started	video_started	The number of times the video ad started playing.	metric
video_view_rate	video_view_rate	The rate at which video ads were viewed, calculated as video plays divided by impressions.	metric
video_viewable_impressions	video_viewable_impressions	The number of times your video ad was considered viewable by industry standards.	metric
video_viewable_watched_{NUM}_seconds	video_viewable_watched_{NUM}_seconds	This metric measures the number of times a video ad was viewed for at least the specified duration (e.g., 3, 6, or 10 seconds) and considered viewable.	metric
video_watched_{NUM}_percent	video_watched_{NUM}_percent	The number of times a video ad was watched up to a specific percentage completion (e.g., 25%, 50%, 75%).	metric
video_watched_{NUM}_seconds	video_watched_{NUM}_seconds	The number of times a video ad was watched for at least a specific duration in seconds.	metric