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_state	account_state	The current operational status of the ad account.	dimension
account_status	account_status	The current operational status of the ad account.	dimension
account_view_attribution_window	account_view_attribution_window	The duration after a view during which conversions are attributed to the ad account.	dimension
ad_account_id	ad_account_id	A unique identifier for the ad account to which the ad or campaign belongs.	dimension
ad_click_url	ad_click_url	The destination URL configured for the ad clicks.	dimension
ad_configured_state	ad_configured_state	The status of the ad as configured by the user, which can differ from its effective operational status.	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_bid_value	ad_group_bid_value	The value of the bid set for the ad group.	metric
ad_group_configured_state	ad_group_configured_state	The status of the ad group as configured by the account owner, which can differ from its effective operational status.	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_hour_scheduled	ad_group_end_hour_scheduled	The hour of the day when an ad group’s scheduled delivery is set to end.	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_schedule_start_hour	ad_group_schedule_start_hour	The hour of the day when an ad group’s scheduled delivery is set to begin.	dimension
ad_group_start_time	ad_group_start_time	The date and time when the ad group is scheduled to start.	dimension
ad_group_state	ad_group_state	The calculated operational status determining the real-time activity state of the ad group.	dimension
ad_group_targeting_communities	ad_group_targeting_communities	The list of Reddit communities (subreddits) targeted by the ad group.	dimension
ad_group_targeting_custom_audience_ids	ad_group_targeting_custom_audience_ids	Unique identifiers for custom audience segments included in the ad group’s targeting.	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_excluded_communities	ad_group_targeting_excluded_communities	The list of Reddit communities (subreddits) explicitly excluded from the ad group’s targeting.	dimension
ad_group_targeting_excluded_custom_audience_ids	ad_group_targeting_excluded_custom_audience_ids	Unique identifiers for custom audience segments explicitly excluded from the ad group’s targeting.	dimension
ad_group_targeting_excluded_geolocations	ad_group_targeting_excluded_geolocations	A summary or list of geographic locations explicitly excluded from the ad group’s targeting.	dimension
ad_group_targeting_excluded_interests	ad_group_targeting_excluded_interests	A list of user interests explicitly excluded from the ad group’s targeting.	dimension
ad_group_targeting_excluded_keywords	ad_group_targeting_excluded_keywords		dimension
ad_group_targeting_geolocations	ad_group_targeting_geolocations	A summary or list of geographic locations targeted for the ad group.	dimension
ad_group_targeting_interests	ad_group_targeting_interests	A list of user interests targeted by the ad group.	dimension
ad_group_type	ad_group_type	The classification or strategic goal of the ad group, influencing its bidding strategy and optimization.	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
ad_state	ad_state	The effective operational status for the ad.	dimension
app_id	app_id	The unique identifier of the application associated with app install campaigns.	dimension
app_install_purchase_count	app_install_purchase_count	The number of app install ‘purchase’ conversion events.	metric
app_install_revenue	app_install_revenue	The total revenue generated from app install campaigns.	metric
app_install_total_conversions	app_install_total_conversions	The total number of app install conversion events recorded.	metric
bid_strategy	bid_strategy	The overall bidding strategy employed for a campaign or ad group.	dimension
bid_type	bid_type	The specific type of bid used (e.g., CPC, CPM).	dimension
bid_value	bid_value	The monetary value of the bid set.	metric
campaign_configured_state	campaign_configured_state	This field specifies the current configured status or operational state of an advertising campaign, reflecting its setup and active status.	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
campaign_objective_type	campaign_objective_type	The specific type of marketing objective defined for the campaign.	dimension
campaign_state	campaign_state	The calculated operational status determining the real-time activity state of the campaign.	dimension
clicks	clicks	The total number of clicks on your ad.	metric
comments	comments	The total number of comments received on a promoted Reddit post or ad. This indicates user engagement.	dimension
community	community	The Reddit community (subreddit) targeted by the ad.	dimension
configured_status	configured_status	The status configured by the user for an entity (e.g., ad, ad group, campaign).	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_ecpa	conversion_lead_ecpa	The effective cost per action (ECPA) for lead conversions, calculated as total spend divided by the number of lead conversions.	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_pixel_id	conversion_pixel_id	The unique identifier for the conversion pixel used to track and report conversion events.	dimension
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_ecpa	conversion_purchase_ecpa	The effective cost per action (ECPA) for purchase conversions, calculated as total spend divided by the number of purchase conversions.	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_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
costs	costs	The total amount of money spent on the advertising campaign or specific ad elements.	metric
country	country	The country where the ad was displayed or targeted.	dimension
cpc	cpc	The average cost per click for your ads.	metric
created_at	created_at	The timestamp indicating when the entity was created.	dimension
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
day	day	The specific calendar day for which the advertising 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
effective_status	effective_status	The actual, current operational status of an entity (e.g., ad, ad group, campaign).	dimension
endDate	endDate	The date when the entity (e.g., campaign, ad group) is scheduled to end.	dimension
endTime	endTime	The time when the entity (e.g., campaign, ad group) is scheduled to end.	dimension
end_time	end_time	The timestamp indicating when the entity (e.g., campaign, ad group) is scheduled to end.	dimension
goal_type	goal_type	The type of optimization goal set for the entity.	dimension
goal_value	goal_value	The target value associated with the optimization goal.	metric
id	id	A unique identifier for the specific entity (e.g., ad group, campaign, ad, or account).	dimension
impressions	impressions	The total number of times your ad was shown to users.	metric
impressions_fully_viewable_video	impressions_fully_viewable_video	The number of times a video ad was played for at least three continuous seconds with 100% of its pixels visible on the screen.	metric
impressions_viewable	impressions_viewable	The number of times an ad appeared on screen and was considered viewable according to industry standards.	dimension
impressions_viewable_video	impressions_viewable_video	The number of times a video ad was played for at least two continuous seconds with at least 50% of the video in view on the page.	metric
is_campaign_budget_optimization	is_campaign_budget_optimization	Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign.	dimension
modified_at	modified_at	The timestamp indicating when the entity was last modified.	dimension
name	name	The human-readable name of the entity, such as an ad group, campaign, ad, or account.	dimension
objective	objective	The primary goal or objective set for an advertising campaign, such as brand awareness, traffic, or conversions.	dimension
optimization_goal	optimization_goal	The primary objective for optimizing ad delivery (e.g., clicks, conversions).	dimension
placement	placement	The location where the ad was displayed (e.g., feed, sidebar).	dimension
platform	platform	The advertising platform or device type targeted by the ad.	dimension
region	region	The geographic region targeted by the ad.	dimension
shopping_targeting.ad_group_id	shopping_targeting.ad_group_id	The unique identifier for the ad group specific to shopping campaigns.	dimension
shopping_targeting.excluded_conversion_event_types	shopping_targeting.excluded_conversion_event_types	A list of conversion event types (e.g., ‘VIEW_CONTENT’) that are excluded from targeting for shopping campaigns.	dimension
shopping_targeting.lookback_window_days	shopping_targeting.lookback_window_days	The number of days in the lookback window used for attributing conversions to shopping ad interactions.	metric
shopping_targeting.targeting_type	shopping_targeting.targeting_type	The specific type of targeting employed for shopping campaigns, such as ‘PROSPECTING’ or ‘RETARGETING’.	dimension
skadnetwork_metadata	skadnetwork_metadata	Metadata related to Apple’s SKAdNetwork for app install attribution.	dimension
spend	spend	The total amount of money spent on advertising campaigns.	metric
startDate	startDate	The date when the entity (e.g., campaign, ad group) is scheduled to start.	dimension
startTime	startTime	The time when the entity (e.g., campaign, ad group) is scheduled to start.	dimension
start_time	start_time	The timestamp indicating when the entity (e.g., campaign, ad group) is scheduled to start.	dimension
targeting.carriers	targeting.carriers	A list of mobile carriers targeted by the ad.	dimension
targeting.communities	targeting.communities	A list of Reddit communities (subreddits) targeted by the ad.	dimension
targeting.custom_audience_ids	targeting.custom_audience_ids	A list of custom audience identifiers targeted by the ad.	dimension
targeting.devices	targeting.devices	A list of device types targeted by the ad.	dimension
targeting.excluded_communities	targeting.excluded_communities	A list of Reddit communities (subreddits) explicitly excluded from targeting by the ad.	dimension
targeting.excluded_custom_audience_ids	targeting.excluded_custom_audience_ids	A list of custom audience identifiers explicitly excluded from targeting by the ad.	dimension
targeting.excluded_geolocations	targeting.excluded_geolocations	A list of geographic locations explicitly excluded from targeting by the ad.	dimension
targeting.excluded_keywords	targeting.excluded_keywords	A list of keywords explicitly excluded from targeting by the ad.	dimension
targeting.expand_targeting	targeting.expand_targeting	Indicates whether targeting expansion is enabled for the ad, allowing the system to reach a broader audience.	dimension
targeting.gender	targeting.gender	The gender demographic targeted by the ad.	dimension
targeting.geolocations	targeting.geolocations	A list of geographic locations targeted by the ad.	dimension
targeting.interests	targeting.interests	A list of interest categories targeted by the ad.	dimension
targeting.keywords	targeting.keywords	A list of keywords targeted by the ad.	dimension
targeting.languages	targeting.languages	The languages specified for targeting within the ad group.	dimension
targeting.locations	targeting.locations	A list of specific locations targeted by the ad.	dimension
targeting.platforms	targeting.platforms	A list of platforms (e.g., desktop, mobile app) where the ad is targeted.	dimension
targeting.suppression_event_types	targeting.suppression_event_types	Specifies the types of events that, when triggered, will suppress or prevent an ad from being shown to a particular audience segment. This is used to refine audience targeting.	dimension
targeting.view_modes	targeting.view_modes	Defines the specific modes or contexts in which an ad is intended to be displayed to the target audience. This helps in tailoring ad delivery.	dimension
video_10s_views	video_10s_views	The number of times a video ad was viewed for at least ten seconds.	metric
video_3s_views	video_3s_views	The number of times a video ad was viewed for at least three seconds.	metric
video_5s_views	video_5s_views	The number of times a video ad was viewed for at least five seconds.	metric
video_completion_rate	video_completion_rate	The percentage of video ads that were watched to 100% completion.	metric
video_completions	video_completions	The number of times a user watched the entire video ad from start to finish.	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_quartile_{NUM}_views	video_quartile_{NUM}_views	The number of times a video ad was watched up to a specific percentage point (e.g., 25%, 50%, 75%, 95%) of its total duration.	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_views	video_views	The total number of times a video ad was viewed.	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
view_through_conversion_type	view_through_conversion_type	The type of view-through conversion attributed to the ad.	dimension