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 |
|---|---|---|---|
Ad name |
Ad name |
The user-defined name of the individual ad. |
dimension |
Year Month |
Year Month |
The year and month of the reported data, used for temporal breakdown. |
dimension |
account_attribution_type |
account_attribution_type |
The attribution model used for the ad account (e.g., last click, first click). |
dimension |
account_click_attribution_window |
account_click_attribution_window |
The duration after a click during which conversions are attributed to the ad account. |
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_status |
account_status |
The current operational status of the ad account. |
dimension |
account_time_zone_id |
account_time_zone_id |
The time zone identifier configured for 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_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_ad_account_id |
ad_group_ad_account_id |
The unique identifier of the ad account to which this ad group belongs. |
dimension |
ad_group_app_id |
ad_group_app_id |
The unique identifier of the application associated with the ad group. |
dimension |
ad_group_bid_strategy |
ad_group_bid_strategy |
The bidding strategy employed for the ad group. |
dimension |
ad_group_bid_type |
ad_group_bid_type |
The type of bidding strategy used for the ad group. |
dimension |
ad_group_bid_value |
ad_group_bid_value |
The value of the bid set for the ad group. |
dimension |
ad_group_campaign_id |
ad_group_campaign_id |
The unique identifier of the campaign to which this ad group belongs. |
dimension |
ad_group_campaign_objective_type |
ad_group_campaign_objective_type |
The specific type of marketing objective defined for the campaign that the ad group belongs to. |
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_created_at |
ad_group_created_at |
The timestamp indicating when the ad group was created. |
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_is_campaign_budget_optimization |
ad_group_is_campaign_budget_optimization |
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign associated with this ad group. |
dimension |
ad_group_modified_at |
ad_group_modified_at |
The timestamp indicating when the ad group was last modified. |
dimension |
ad_group_name |
ad_group_name |
The name of the ad group. |
dimension |
ad_group_optimization_goal |
ad_group_optimization_goal |
The primary objective for optimizing ad delivery within this ad group (e.g., clicks, conversions). |
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 starts. |
dimension |
ad_group_schedule_{NUM}_end_day |
ad_group_schedule_{NUM}_end_day |
The day of the week when a specific ad group schedule entry ends. |
metric |
ad_group_schedule_{NUM}_end_hour |
ad_group_schedule_{NUM}_end_hour |
The hour of the day when a specific ad group schedule entry ends. |
metric |
ad_group_schedule_{NUM}_start_day |
ad_group_schedule_{NUM}_start_day |
The day of the week when a specific ad group schedule entry starts. |
metric |
ad_group_schedule_{NUM}_start_hour |
ad_group_schedule_{NUM}_start_hour |
The hour of the day when a specific ad group schedule entry starts. |
metric |
ad_group_skadnetwork_metadata |
ad_group_skadnetwork_metadata |
Metadata related to Apple’s SKAdNetwork for app install attribution specifically for this ad group. |
dimension |
ad_group_start_time |
ad_group_start_time |
The date and time when the ad group is scheduled to start. |
dimension |
ad_group_targeting_communities |
ad_group_targeting_communities |
The list of communities targeted by the ad group. |
dimension |
ad_group_targeting_communities_{NUM} |
ad_group_targeting_communities_{NUM} |
A specific Reddit community (subreddit) targeted for the ad group. |
dimension |
ad_group_targeting_custom_audience_ids |
ad_group_targeting_custom_audience_ids |
The list of custom audience IDs targeted by the ad group. |
dimension |
ad_group_targeting_custom_audience_ids_{NUM} |
ad_group_targeting_custom_audience_ids_{NUM} |
A specific custom audience identifier targeted for 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_devices_{NUM}_max_version |
ad_group_targeting_devices_{NUM}_max_version |
The maximum operating system version targeted for a specific device configuration within an ad group. |
dimension |
ad_group_targeting_devices_{NUM}_min_version |
ad_group_targeting_devices_{NUM}_min_version |
The minimum operating system version targeted for a specific device configuration within an ad group. |
dimension |
ad_group_targeting_devices_{NUM}_os |
ad_group_targeting_devices_{NUM}_os |
The operating system targeted for a specific device configuration within an ad group. |
dimension |
ad_group_targeting_devices_{NUM}_type |
ad_group_targeting_devices_{NUM}_type |
The type of device targeted (e.g., mobile, desktop) for a specific device configuration within an ad group. |
dimension |
ad_group_targeting_excluded_communities |
ad_group_targeting_excluded_communities |
The list of communities explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_communities_{NUM} |
ad_group_targeting_excluded_communities_{NUM} |
A specific Reddit community (subreddit) explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_excluded_custom_audience_ids |
ad_group_targeting_excluded_custom_audience_ids |
The list of custom audience IDs explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_custom_audience_ids_{NUM} |
ad_group_targeting_excluded_custom_audience_ids_{NUM} |
A specific custom audience identifier explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_excluded_geolocations |
ad_group_targeting_excluded_geolocations |
A list of geographic locations explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_excluded_geolocations_{NUM} |
ad_group_targeting_excluded_geolocations_{NUM} |
A specific geographic location explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_excluded_interests |
ad_group_targeting_excluded_interests |
The list of interests explicitly excluded from the ad group’s targeting. |
dimension |
ad_group_targeting_excluded_keywords |
ad_group_targeting_excluded_keywords |
A list of keywords explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_excluded_keywords_{NUM} |
ad_group_targeting_excluded_keywords_{NUM} |
A specific keyword explicitly excluded from targeting for the ad group. |
dimension |
ad_group_targeting_expand_targeting |
ad_group_targeting_expand_targeting |
Indicates whether targeting expansion is enabled for the ad group, allowing the system to reach a broader audience. |
dimension |
ad_group_targeting_gender |
ad_group_targeting_gender |
The gender demographic targeted by 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_geolocations_{NUM} |
ad_group_targeting_geolocations_{NUM} |
A specific geographic location targeted for the ad group. |
dimension |
ad_group_targeting_interests |
ad_group_targeting_interests |
The list of interests targeted by the ad group. |
dimension |
ad_group_targeting_interests_{NUM} |
ad_group_targeting_interests_{NUM} |
A specific interest category targeted for the ad group. |
dimension |
ad_group_targeting_keywords |
ad_group_targeting_keywords |
A list of keywords used for targeting the ad group. |
dimension |
ad_group_targeting_keywords_{NUM} |
ad_group_targeting_keywords_{NUM} |
A specific keyword targeted for the ad group. |
dimension |
ad_group_targeting_locations |
ad_group_targeting_locations |
A list of specific geographic locations targeted for the ad group. |
dimension |
ad_group_targeting_locations_{NUM} |
ad_group_targeting_locations_{NUM} |
A specific location targeted for the ad group. |
dimension |
ad_group_targeting_placements |
ad_group_targeting_placements |
The list of placements targeted by the ad group, such as ‘feed’ or ‘conversations’. |
dimension |
ad_group_targeting_platforms_{NUM} |
ad_group_targeting_platforms_{NUM} |
A specific platform (e.g., desktop, mobile app) where the ad group is targeted. |
dimension |
ad_group_targeting_view_modes_{NUM} |
ad_group_targeting_view_modes_{NUM} |
dimension |
|
ad_group_view_through_conversion_type |
ad_group_view_through_conversion_type |
The type of view-through conversion attributed to 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 |
ad_status |
ad_status |
The current status of the ad. |
dimension |
adset_name |
adset_name |
The name of the ad group (also known as ad set), which is a container for ads with shared targeting, budget, and schedule. |
dimension |
adset_status |
adset_status |
The current status of the ad group (e.g., active, paused, archived). |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser account. |
dimension |
app_id |
app_id |
The unique identifier of the application associated with app install campaigns. |
dimension |
app_install_add_payment_info_count |
app_install_add_payment_info_count |
The number of times users added payment information after an app install, tracked as a conversion event. |
metric |
app_install_add_to_cart_count |
app_install_add_to_cart_count |
The number of app install ‘add to cart’ conversion events. |
metric |
app_install_app_launch_count |
app_install_app_launch_count |
The number of app launch events after an install. |
metric |
app_install_completed_tutorial_count |
app_install_completed_tutorial_count |
The number of times users completed a tutorial after an app install, tracked as a conversion event. |
metric |
app_install_install_count |
app_install_install_count |
The total number of app install events. |
metric |
app_install_level_achieved_count |
app_install_level_achieved_count |
The number of app install ‘level achieved’ conversion events. |
metric |
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 events. |
metric |
app_install_search_count |
app_install_search_count |
The number of app install ‘search’ conversion events. |
metric |
app_install_sign_up_count |
app_install_sign_up_count |
The number of app install ‘sign up’ conversion events. |
metric |
app_install_skan_ad_click_count |
app_install_skan_ad_click_count |
The count of SKAdNetwork attributed ad clicks for app installs. |
metric |
app_install_skan_ad_view_count |
app_install_skan_ad_view_count |
The count of SKAdNetwork attributed ad views for app installs. |
metric |
app_install_skan_add_payment_info_count |
app_install_skan_add_payment_info_count |
The count of SKAdNetwork attributed ‘add payment info’ events for app installs. |
metric |
app_install_skan_add_to_cart_count |
app_install_skan_add_to_cart_count |
The count of SKAdNetwork attributed ‘add to cart’ events for app installs. |
metric |
app_install_skan_add_to_wishlist_count |
app_install_skan_add_to_wishlist_count |
The count of app install SKAdNetwork (SKAN) conversions where an ‘add to wishlist’ event occurred. |
metric |
app_install_skan_app_launch_count |
app_install_skan_app_launch_count |
The count of SKAdNetwork attributed app launch events for app installs. |
metric |
app_install_skan_checkout_count |
app_install_skan_checkout_count |
The count of SKAdNetwork attributed ‘checkout’ events for app installs. |
metric |
app_install_skan_completed_tutorial_count |
app_install_skan_completed_tutorial_count |
The count of SKAdNetwork attributed ‘completed tutorial’ events for app installs. |
metric |
app_install_skan_first_time_purchase_count |
app_install_skan_first_time_purchase_count |
The count of SKAdNetwork attributed ‘first-time purchase’ events for app installs. |
metric |
app_install_skan_install_count |
app_install_skan_install_count |
The count of SKAdNetwork attributed app install events. |
metric |
app_install_skan_level_achieved_count |
app_install_skan_level_achieved_count |
The count of app install SKAdNetwork (SKAN) conversions where a specific level achievement event occurred. |
metric |
app_install_skan_login_count |
app_install_skan_login_count |
The count of app install SKAdNetwork (SKAN) conversions where a login event occurred. |
metric |
app_install_skan_onboard_completed_count |
app_install_skan_onboard_completed_count |
The count of app install SKAdNetwork (SKAN) conversions where an onboarding completed event occurred. |
metric |
app_install_skan_onboard_started_count |
app_install_skan_onboard_started_count |
The count of app install SKAdNetwork (SKAN) conversions where an onboarding started event occurred. |
metric |
app_install_skan_purchase_count |
app_install_skan_purchase_count |
The count of app install SKAdNetwork (SKAN) conversions where a purchase event occurred. |
metric |
app_install_skan_rate_count |
app_install_skan_rate_count |
The count of app install SKAdNetwork (SKAN) conversions where an app rating event occurred. |
metric |
app_install_skan_reinstall_count |
app_install_skan_reinstall_count |
The count of app install SKAdNetwork (SKAN) conversions where a re-install event occurred. |
metric |
app_install_skan_revenue |
app_install_skan_revenue |
The revenue generated from app install SKAdNetwork (SKAN) conversions. |
metric |
app_install_skan_search_count |
app_install_skan_search_count |
The count of app install SKAdNetwork (SKAN) conversions where a search event occurred. |
metric |
app_install_skan_sign_up_count |
app_install_skan_sign_up_count |
The count of app install SKAdNetwork (SKAN) conversions where a sign-up event occurred. |
metric |
app_install_skan_spend_credits_count |
app_install_skan_spend_credits_count |
The count of app install SKAdNetwork (SKAN) conversions where a ‘spend credits’ event occurred. |
metric |
app_install_skan_start_trial_count |
app_install_skan_start_trial_count |
The count of app install SKAdNetwork (SKAN) conversions where a trial started event occurred. |
metric |
app_install_skan_subscribe_count |
app_install_skan_subscribe_count |
The count of app install SKAdNetwork (SKAN) conversions where a subscription event occurred. |
metric |
app_install_skan_total_conversions |
app_install_skan_total_conversions |
The total number of app install SKAdNetwork (SKAN) conversions. |
metric |
app_install_skan_total_install_count |
app_install_skan_total_install_count |
The total count of app installs attributed via SKAdNetwork (SKAN). |
metric |
app_install_skan_unknown_count |
app_install_skan_unknown_count |
The count of app install SKAdNetwork (SKAN) conversions with an unknown event type. |
metric |
app_install_skan_unlock_achievement_count |
app_install_skan_unlock_achievement_count |
The count of app install SKAdNetwork (SKAN) conversions where an ‘unlock achievement’ event occurred. |
metric |
app_install_skan_view_content_count |
app_install_skan_view_content_count |
The count of app install SKAdNetwork (SKAN) conversions where a content view event occurred. |
metric |
app_install_spend_credits_count |
app_install_spend_credits_count |
The number of times users spent in-app credits after an app install ad. |
metric |
app_install_total_conversions |
app_install_total_conversions |
The total number of app install conversion events. |
metric |
app_install_view_content_count |
app_install_view_content_count |
The count of app install ‘view content’ events. |
metric |
app_install_view_content_cvr |
app_install_view_content_cvr |
The conversion rate for app install ‘view content’ events. |
metric |
app_install_view_content_ecpa |
app_install_view_content_ecpa |
The effective cost per action for app install ‘view content’ events. |
metric |
audience_source |
audience_source |
The origin or type of data used to define a custom audience, such as a customer list or CRM integration. |
dimension |
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 |
billable_amount |
billable_amount |
The amount that is eligible for billing based on ad performance. |
metric |
campaign |
campaign |
The user-defined name of the ad campaign. |
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_end_date |
campaign_end_date |
The scheduled end date of the ad campaign. |
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_start_date |
campaign_start_date |
The scheduled start date of the ad campaign. |
dimension |
campaign_status |
campaign_status |
The current status of the campaign. |
dimension |
clicks |
clicks |
The total number of clicks on your ad. |
metric |
comment_downvotes |
comment_downvotes |
The number of downvotes received on comments related to the ad. |
dimension |
comment_upvotes |
comment_upvotes |
The number of upvotes received on comments related to the ad. |
dimension |
comments_page_views |
comments_page_views |
The total number of page views for comments associated with the ad. |
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_ecpa |
conversion_add_to_cart_ecpa |
The effective cost per action (ECPA) for ‘add to cart’ conversions, calculated as total spend divided by the number of 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 that led to an add-to-wishlist conversion event. |
metric |
conversion_add_to_wishlist_ecpa |
conversion_add_to_wishlist_ecpa |
The effective cost per action (ECPA) for ‘add to wishlist’ conversions, calculated as total spend divided by the number of 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 that led to an add-to-wishlist conversion event. |
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_ecpa |
conversion_page_visit_ecpa |
The effective cost per action (ECPA) for page visit conversions, calculated as total spend divided by the number of 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 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_ecpa |
conversion_search_ecpa |
The effective cost per action (ECPA) for search conversions, calculated as total spend divided by the number of 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 number of clicks that led to a sign-up conversion event. |
metric |
conversion_sign_up_ecpa |
conversion_sign_up_ecpa |
The effective cost per action (ECPA) for sign-up conversions, calculated as total spend divided by the number of sign-up conversions. |
metric |
conversion_sign_up_views |
conversion_sign_up_views |
The number of views that led to 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_ecpa |
conversion_view_content_ecpa |
The effective cost per action (ECPA) for view content conversions, calculated as total spend divided by the number of view content conversions. |
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 |
cpv |
cpv |
The Cost Per View (CPV), representing the average cost for each video view. |
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 |
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 |
environment_device |
environment_device |
The type of device environment where the ad was displayed, such as mobile or desktop. |
dimension |
gender |
gender |
The gender demographic targeted by the ad. |
dimension |
geolocations |
geolocations |
The geographic locations targeted by the ad group. |
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 |
hour |
hour |
The specific hour of the day for which the data is reported. |
dimension |
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 |
interest |
interest |
The interest category targeted by the ad. |
dimension |
is_campaign_budget_optimization |
is_campaign_budget_optimization |
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign. |
dimension |
keyword |
keyword |
The keyword used for targeting an ad group. |
dimension |
language |
language |
The language setting for the ad or its targeting. |
dimension |
media_cost |
media_cost |
The total cost of media purchased for the ad campaign. |
metric |
media_cost_usd |
media_cost_usd |
The total cost of media purchased for the ad campaign, expressed in United States Dollars (USD). |
metric |
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 |
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 |
placement_id |
placement_id |
The unique identifier for the ad placement. |
dimension |
processing_datetime |
processing_datetime |
The timestamp indicating when the data for the record was processed by the data integration platform. |
dimension |
quarter |
quarter |
The quarter of the year (e.g., Q1, Q2) to which the reported data belongs, used for temporal breakdown. |
dimension |
reddit_ad_name |
reddit_ad_name |
The user-defined name of the individual ad on the Reddit platform. This is equivalent to ‘Ad name’. |
dimension |
reddit_clicks |
reddit_clicks |
The total number of clicks on ads on the Reddit platform. |
metric |
reddit_cost |
reddit_cost |
The total cost incurred for ads on the Reddit platform. This is equivalent to ‘spend’. |
metric |
reddit_creative_id |
reddit_creative_id |
The unique identifier for the ad creative on the Reddit platform. This is equivalent to ‘ad_id’. |
dimension |
reddit_impressions |
reddit_impressions |
The total number of times ads were displayed on the Reddit platform. |
metric |
reddit_platform_campaign |
reddit_platform_campaign |
The user-defined name of the ad campaign on the Reddit platform. This is equivalent to ‘campaign’. |
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.conversion_event_types |
shopping_targeting.conversion_event_types |
A list of conversion event types (e.g., ‘PURCHASE’, ‘ADD_TO_CART’) that are targeted for 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 |
source |
source |
The data source, which in this context refers to Reddit Ads. |
dimension |
spend |
spend |
The total amount of money spent on advertising campaigns. |
metric |
spend_DKK |
spend_DKK |
The total amount of money spent on ads, denominated in Danish Krone (DKK). |
metric |
spend_EUR |
spend_EUR |
The total amount of money spent on advertising campaigns, reported in Euros. |
metric |
spend_USD |
spend_USD |
The total amount of money spent on the ad campaign, expressed in United States Dollars (USD). |
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 |
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_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 |
viewable_impressions |
viewable_impressions |
The number of impressions that were considered viewable according to industry standards. |
dimension |
viewer_comments |
viewer_comments |
The total number of comments made by viewers on the ad. |
dimension |