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_attribution_type |
account_attribution_type |
The attribution model used for the ad account to assign credit for conversions. |
dimension |
account_click_attribution_window |
account_click_attribution_window |
The duration, in days, after an ad click during which a conversion is attributed to that click. |
dimension |
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_time_zone_id |
account_time_zone_id |
The time zone associated with the ad account, used for reporting and scheduling. |
dimension |
account_view_attribution_window |
account_view_attribution_window |
The duration, in days, after an ad view during which a conversion is attributed to that view. |
dimension |
ad_account_id |
ad_account_id |
The unique identifier for the advertising account. |
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 advertiser. |
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_type |
ad_group_bid_type |
The bidding strategy type used for the ad group. |
dimension |
ad_group_bid_value |
ad_group_bid_value |
The bid amount set for the ad group. |
metric |
ad_group_configured_state |
ad_group_configured_state |
The status of the ad group as set by the advertiser, reflecting its intended state. |
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 scheduled end hour for an ad group’s delivery, typically used for dayparting. |
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 scheduled start hour for an ad group’s delivery, typically used for dayparting. |
dimension |
ad_group_start_time |
ad_group_start_time |
The date and time when the ad group is scheduled to begin delivering. |
dimension |
ad_group_state |
ad_group_state |
The current operational status of the ad group, which is a calculated status determining its real-time state. |
dimension |
ad_group_targeting_communities |
ad_group_targeting_communities |
The Reddit communities (subreddits) targeted by the ad group. |
dimension |
ad_group_targeting_custom_audience_ids |
ad_group_targeting_custom_audience_ids |
Identifiers for custom audiences targeted by the ad group. |
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 |
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 |
Identifiers for custom audiences explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_geolocations |
ad_group_targeting_excluded_geolocations |
Geographic locations explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_interests |
ad_group_targeting_excluded_interests |
Interests explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_keywords |
ad_group_targeting_excluded_keywords |
Keywords explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_expand_targeting |
ad_group_targeting_expand_targeting |
Indicates whether automated targeting expansion is enabled for the ad group, allowing Reddit to reach users beyond initial targeting selections. |
dimension |
ad_group_targeting_gender |
ad_group_targeting_gender |
Gender targeting 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_group_targeting_interests |
ad_group_targeting_interests |
User interests targeted by the ad group. |
dimension |
ad_group_targeting_keywords |
ad_group_targeting_keywords |
Keywords targeted by the ad group, often based on user engagement with conversation threads. |
dimension |
ad_group_targeting_locations |
ad_group_targeting_locations |
Geographic locations (e.g., countries, states, or cities) targeted by the ad group. |
dimension |
ad_group_targeting_view_modes |
ad_group_targeting_view_modes |
dimension |
|
ad_group_type |
ad_group_type |
The type or category of the ad group, often related to its objective or targeting strategy. |
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 current operational status of the individual ad. |
dimension |
ad_status |
ad_status |
The current status of the individual ad. |
dimension |
adset_name |
adset_name |
The name of the ad set. In Reddit Ads, this typically corresponds to the Ad Group name. |
dimension |
adset_status |
adset_status |
The status of the ad set. In Reddit Ads, this typically corresponds to the Ad Group status. |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser or business account. |
dimension |
app_id |
app_id |
The unique identifier for the mobile application being advertised. |
dimension |
app_install_add_payment_info_count |
app_install_add_payment_info_count |
The number of times users added payment information within the app after an install. |
metric |
app_install_add_to_cart_count |
app_install_add_to_cart_count |
The number of times users added items to their cart within the app after an install. |
metric |
app_install_app_launch_count |
app_install_app_launch_count |
The number of times the app was launched after an install. |
metric |
app_install_completed_tutorial_count |
app_install_completed_tutorial_count |
The number of times users completed an in-app tutorial after an install. |
metric |
app_install_install_count |
app_install_install_count |
The number of app installs attributed to the ad campaign. |
metric |
app_install_level_achieved_count |
app_install_level_achieved_count |
The number of times users achieved a new level within the app after an install. |
metric |
app_install_purchase_count |
app_install_purchase_count |
The number of purchases made within the app following an ad install. |
metric |
app_install_search_count |
app_install_search_count |
The number of in-app searches performed by users after an install. |
metric |
app_install_sign_up_count |
app_install_sign_up_count |
The number of user sign-ups within the app after an install. |
metric |
app_install_skan_ad_click_count |
app_install_skan_ad_click_count |
The number of ad clicks attributed to app installs via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_ad_view_count |
app_install_skan_ad_view_count |
The number of ad views attributed to app installs via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_ad_view_cvr |
app_install_skan_ad_view_cvr |
The conversion rate from ad views to app installs, as reported by SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_ad_view_ecpa |
app_install_skan_ad_view_ecpa |
The effective cost per action for app installs attributed to ad views, as reported by SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_add_payment_info_count |
app_install_skan_add_payment_info_count |
The number of times users added payment information, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_add_to_cart_count |
app_install_skan_add_to_cart_count |
The number of times users added items to their cart, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_add_to_wishlist_count |
app_install_skan_add_to_wishlist_count |
The number of times users added items to a wishlist, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_app_launch_count |
app_install_skan_app_launch_count |
The number of times the app was launched, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_checkout_count |
app_install_skan_checkout_count |
The number of times users completed a checkout, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_completed_tutorial_count |
app_install_skan_completed_tutorial_count |
The number of times users completed an in-app tutorial, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_first_time_purchase_count |
app_install_skan_first_time_purchase_count |
The number of first-time purchases made by users, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_install_count |
app_install_skan_install_count |
The number of app installs attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_level_achieved_count |
app_install_skan_level_achieved_count |
The number of times users achieved a new level within the app, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_login_count |
app_install_skan_login_count |
The number of times users logged into the app, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_onboard_completed_count |
app_install_skan_onboard_completed_count |
The number of times users completed the onboarding process, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_onboard_started_count |
app_install_skan_onboard_started_count |
The number of times users started the onboarding process, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_purchase_count |
app_install_skan_purchase_count |
The number of purchases made by users, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_rate_count |
app_install_skan_rate_count |
The number of times users rated the app, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_reinstall_count |
app_install_skan_reinstall_count |
The number of app reinstalls, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_search_count |
app_install_skan_search_count |
The number of in-app searches performed by users, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_sign_up_count |
app_install_skan_sign_up_count |
The number of user sign-ups, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_spend_credits_count |
app_install_skan_spend_credits_count |
The number of times users spent in-app credits, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_start_trial_count |
app_install_skan_start_trial_count |
The number of times users started a trial, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_subscribe_count |
app_install_skan_subscribe_count |
The number of user subscriptions, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_total_install_count |
app_install_skan_total_install_count |
The total number of app installs, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_unknown_count |
app_install_skan_unknown_count |
The number of unknown app-install related events, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_unlock_achievement_count |
app_install_skan_unlock_achievement_count |
The number of times users unlocked an in-app achievement, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_view_content_count |
app_install_skan_view_content_count |
The number of times users viewed content within the app, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_view_content_cvr |
app_install_skan_view_content_cvr |
The conversion rate from viewing content within the app to app installs, as reported by SKAdNetwork for iOS app install campaigns. |
metric |
app_install_skan_view_content_ecpa |
app_install_skan_view_content_ecpa |
The effective cost per action for viewing content within the app, attributed via SKAdNetwork for iOS app install campaigns. |
metric |
app_install_spend_credits_count |
app_install_spend_credits_count |
The number of times users spent in-app credits after an install. |
metric |
app_install_total_conversions |
app_install_total_conversions |
The total number of conversions related to app installs. |
metric |
app_install_view_content_count |
app_install_view_content_count |
The number of times users viewed content within the app after an install. |
metric |
app_install_view_content_cvr |
app_install_view_content_cvr |
The conversion rate from app installs to viewing content within the app. |
metric |
app_install_view_content_ecpa |
app_install_view_content_ecpa |
The effective cost per action for viewing content within the app after an install. |
metric |
attribution_window |
attribution_window |
The time frame during which a conversion is counted after a user interacts with an ad. |
dimension |
bid_strategy |
bid_strategy |
The bidding strategy employed for the ad campaign or ad group, e.g., target cost, lowest cost. |
dimension |
bid_type |
bid_type |
The type of bid, such as CPM (cost per mille/thousand impressions) or CPC (cost per click). |
dimension |
bid_value |
bid_value |
The monetary value of the bid placed for the ad or ad group. |
metric |
campaign_configured_state |
campaign_configured_state |
The status of the campaign as configured by the advertiser. |
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 primary goal or objective of the campaign, e.g., brand awareness, traffic, conversions. |
dimension |
campaign_state |
campaign_state |
The current operational status of the advertising campaign. |
dimension |
campaign_status |
campaign_status |
The current status of the advertising campaign. |
dimension |
clicks |
clicks |
The total number of clicks on your ad. |
metric |
comments |
comments |
The number of comments received on an ad. |
dimension |
community |
community |
The Reddit community (subreddit) targeted by the ad. |
dimension |
configured_status |
configured_status |
The status of an entity (ad, ad group, or campaign) as manually set by the advertiser. |
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_ecpa |
conversion_add_to_cart_ecpa |
The effective cost per action for ‘add to cart’ conversions. |
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_clicks |
conversion_add_to_wishlist_clicks |
The number of clicks on ‘add to wishlist’ actions that led to a conversion. |
metric |
conversion_add_to_wishlist_ecpa |
conversion_add_to_wishlist_ecpa |
The effective cost per action for ‘add to wishlist’ conversions. |
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_add_to_wishlist_views |
conversion_add_to_wishlist_views |
The number of views of ‘add to wishlist’ opportunities that led to a conversion. |
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 for lead generation 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_ecpa |
conversion_page_visit_ecpa |
The effective cost per action for page visit conversions. |
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 Reddit Pixel used to track conversions. |
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 for 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_ecpa |
conversion_search_ecpa |
The effective cost per action for search conversions. |
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_items |
conversion_signup_total_items |
The total number of items associated with signup conversions. |
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_ecpa |
conversion_view_content_ecpa |
The effective cost per action for viewing content conversions. |
metric |
conversion_view_content_views |
conversion_view_content_views |
The number of views that led to a view content conversion event. |
metric |
conversions |
conversions |
The total number of conversion events recorded for the campaign. |
metric |
cost_per_completed_view |
cost_per_completed_view |
The cost incurred for each video view that was watched to 100% completion. |
metric |
cost_per_{NUM}_second_view |
cost_per_{NUM}_second_view |
The cost incurred for each video view that reaches a specific duration (e.g., 3 seconds, 10 seconds). |
metric |
costs |
costs |
The total cost incurred for the ad campaign or ad activity. |
metric |
country |
country |
The country where the ad was displayed or targeted. |
dimension |
cpc |
cpc |
The average cost per click for your ads. |
metric |
cpv |
cpv |
Cost per video view, which is the average cost incurred for each video view. |
metric |
created_at |
created_at |
The timestamp when the entity (e.g., ad, ad group, campaign) 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 date for which the data is reported, typically for daily breakdowns. |
dimension |
dma |
dma |
Designated Market Area (DMA) related to ad performance, often used for geographical reporting or targeting. |
dimension |
ecpm |
ecpm |
The effective cost per thousand impressions. |
metric |
effective_status |
effective_status |
The calculated, real-time status of an entity (ad, ad group, or campaign), taking into account various factors like configured status, budget, and targeting. |
dimension |
endDate |
endDate |
The end date for the campaign or ad group delivery. |
dimension |
endTime |
endTime |
The end time for the campaign or ad group delivery within a day. |
dimension |
end_time |
end_time |
The date and time when the entity (e.g., campaign, ad group) is scheduled to stop delivering. |
dimension |
event_name |
event_name |
The name of a specific conversion event being tracked. |
dimension |
gender |
gender |
The gender of the user, used as a demographic breakdown in reports or for targeting. |
dimension |
goal_type |
goal_type |
The specific type of goal set for the campaign’s optimization, e.g., conversions, clicks, impressions. |
dimension |
goal_value |
goal_value |
The target value associated with the campaign’s optimization goal. |
metric |
id |
id |
The unique identifier for an entity (e.g., ad, ad group, campaign, 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 3 continuous seconds with 100% of the video in view. |
metric |
impressions_viewable |
impressions_viewable |
The number of times at least 50% of an ad was in view for at least one second (for static images) or two seconds (for video). |
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. |
metric |
interest |
interest |
A specific interest used for targeting. |
dimension |
is_campaign_budget_optimization |
is_campaign_budget_optimization |
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign. |
dimension |
media_cost |
media_cost |
The cost associated with purchasing ad placements or media. |
metric |
media_cost_usd |
media_cost_usd |
The cost associated with purchasing ad placements or media, expressed in US Dollars. |
metric |
modified_at |
modified_at |
The timestamp when the entity (e.g., ad, ad group, campaign) was last modified. |
dimension |
name |
name |
The name of the entity (e.g., ad, ad group, campaign, account). |
dimension |
objective |
objective |
The high-level marketing objective of the campaign. |
dimension |
optimization_goal |
optimization_goal |
The specific action or metric the campaign is optimized to achieve. |
dimension |
placement |
placement |
The location where the ad was displayed (e.g., feed, sidebar). |
dimension |
placement_id |
placement_id |
The unique identifier for the ad placement. |
dimension |
platform |
platform |
The advertising platform where the ad campaign is run, which is Reddit. |
dimension |
platform_name |
platform_name |
The name of the advertising platform, which is Reddit Ads. |
dimension |
region |
region |
A geographical region targeted by the ad campaign. |
dimension |
run_date |
run_date |
The date when the report or data extraction was run. |
dimension |
run_time |
run_time |
The time when the report or data extraction was run. |
dimension |
shopping_targeting.ad_group_id |
shopping_targeting.ad_group_id |
The ID of the ad group to which the shopping targeting applies. |
dimension |
shopping_targeting.excluded_conversion_event_types |
shopping_targeting.excluded_conversion_event_types |
Conversion event types explicitly excluded from shopping targeting, meaning users who complete these actions will not be targeted. |
dimension |
shopping_targeting.lookback_window_days |
shopping_targeting.lookback_window_days |
The number of days in the lookback window for evaluating user behavior relevant to shopping targeting, typically for retargeting. |
metric |
shopping_targeting.targeting_type |
shopping_targeting.targeting_type |
The specific type of shopping targeting being used, e.g., prospecting or retargeting. |
dimension |
skadnetwork_metadata |
skadnetwork_metadata |
Metadata related to SKAdNetwork settings and attribution for the ad, used for iOS app install campaigns. |
dimension |
spend |
spend |
The total amount of money spent on advertising campaigns. |
metric |
spend_USD |
spend_USD |
The total amount spent on the ad campaign, expressed in US Dollars. |
metric |
startDate |
startDate |
The start date for the campaign or ad group delivery. |
dimension |
startTime |
startTime |
The start time for the campaign or ad group delivery within a day. |
dimension |
start_time |
start_time |
The date and time when the entity (e.g., campaign, ad group) is scheduled to begin delivering. |
dimension |
targeting.carriers |
targeting.carriers |
Mobile carriers targeted for ad delivery. |
dimension |
targeting.communities |
targeting.communities |
Reddit communities (subreddits) targeted for ad delivery. |
dimension |
targeting.custom_audience_ids |
targeting.custom_audience_ids |
Identifiers for custom audiences to be targeted. |
dimension |
targeting.devices |
targeting.devices |
Device types (e.g., mobile, desktop) targeted for ad delivery. |
dimension |
targeting.excluded_communities |
targeting.excluded_communities |
Reddit communities (subreddits) explicitly excluded from targeting. |
dimension |
targeting.excluded_custom_audience_ids |
targeting.excluded_custom_audience_ids |
Identifiers for custom audiences explicitly excluded from targeting. |
dimension |
targeting.excluded_geolocations |
targeting.excluded_geolocations |
Geographic locations explicitly excluded from targeting. |
dimension |
targeting.excluded_keywords |
targeting.excluded_keywords |
Keywords explicitly excluded from targeting. |
dimension |
targeting.expand_targeting |
targeting.expand_targeting |
Indicates whether automated targeting expansion is enabled, allowing Reddit to reach users beyond initial targeting selections. |
dimension |
targeting.gender |
targeting.gender |
Gender targeting preference for ad delivery. |
dimension |
targeting.geolocations |
targeting.geolocations |
Geographic locations targeted for ad delivery. |
dimension |
targeting.interests |
targeting.interests |
User interests targeted for ad delivery. |
dimension |
targeting.keywords |
targeting.keywords |
Keywords targeted for ad delivery, often based on user engagement with conversation threads. |
dimension |
targeting.languages |
targeting.languages |
Languages of the users to be targeted for ad delivery. |
dimension |
targeting.locations |
targeting.locations |
Geographic locations (e.g., countries, states, or cities) targeted for ad delivery. |
dimension |
targeting.platforms |
targeting.platforms |
The platforms (e.g., iOS, Android, Desktop) where ads are displayed. |
dimension |
targeting.suppression_event_types |
targeting.suppression_event_types |
Event types used to suppress ad delivery to users who have completed these actions, preventing retargeting. |
dimension |
targeting.view_modes |
targeting.view_modes |
dimension |
|
video_10s_views |
video_10s_views |
The number of times a video ad was viewed for at least 10 seconds. |
metric |
video_3s_views |
video_3s_views |
The number of times a video ad was viewed for at least 3 seconds. |
metric |
video_5s_views |
video_5s_views |
The number of times a video ad was viewed for at least 5 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 video ad was 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_quartile_{NUM}_views |
video_quartile_{NUM}_views |
The number of times a video ad was watched to a specific quartile (e.g., 25%, 50%, 75%, 100%) 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_view_rate_{NUM}_seconds |
video_view_rate_{NUM}_seconds |
The percentage of impressions that result in a video view of a specific duration (e.g., 3 seconds, 10 seconds). |
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_views |
video_views |
The total number of times a video ad was played (typically for a minimum duration, e.g., 2 or 3 seconds). |
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, indicating conversions that occurred after an impression but without a direct click. |
dimension |