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_admin_approval |
account_admin_approval |
Indicates whether the ad account requires administrator approval. This field is mutable only by Reddit. |
dimension |
account_app_attribution_type |
account_app_attribution_type |
The type of app attribution configured for the ad account, determining how app installs and events are credited to ads. |
dimension |
account_app_click_attribution_window |
account_app_click_attribution_window |
The time duration after an ad click during which app conversions are attributed to the ad account. |
dimension |
account_app_view_attribution_window |
account_app_view_attribution_window |
The time duration after an ad view (impression) during which app conversions are attributed to the ad account. |
dimension |
account_attribution_type |
account_attribution_type |
The attribution model used for the ad account to assign credit for conversions. |
dimension |
account_business_id |
account_business_id |
The unique identifier for the business associated with an ad account. |
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_modified_at |
account_modified_at |
The timestamp indicating when the ad account was last modified. |
dimension |
account_name |
account_name |
The name of the ad account. |
dimension |
account_primary_contact_member_id |
account_primary_contact_member_id |
The unique identifier of the primary contact member associated with the ad account. |
dimension |
account_status |
account_status |
The current operational status of the ad account. |
dimension |
account_suspension_reason |
account_suspension_reason |
The reason provided for the suspension 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_ad_account_id |
ad_ad_account_id |
The unique identifier of the ad account to which the ad belongs. |
dimension |
ad_ad_group_id |
ad_ad_group_id |
The unique identifier of the ad group that contains this ad. |
dimension |
ad_campaign_id |
ad_campaign_id |
The unique identifier of the campaign to which the ad belongs. |
dimension |
ad_campaign_objective_type |
ad_campaign_objective_type |
The objective type set for the campaign associated with this ad, such as brand awareness or conversions. |
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_created_at |
ad_created_at |
The timestamp indicating when the ad was created. |
dimension |
ad_delivery_status_{NUM} |
ad_delivery_status_{NUM} |
The current delivery status of the ad, indicating whether it is active, paused, or archived. |
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 the ad group belongs. |
dimension |
ad_group_app_id |
ad_group_app_id |
The ID of the app associated with the ad group. |
dimension |
ad_group_bid_strategy |
ad_group_bid_strategy |
The bidding strategy configured for the ad group. |
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_campaign_id |
ad_group_campaign_id |
The unique identifier of the campaign to which the ad group belongs. |
dimension |
ad_group_campaign_objective_type |
ad_group_campaign_objective_type |
The objective type set for the campaign associated with this ad group. |
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_conversion_pixel_id |
ad_group_conversion_pixel_id |
The unique identifier of the conversion pixel associated with the ad group, used for tracking conversions. |
dimension |
ad_group_created_at |
ad_group_created_at |
The timestamp indicating when the ad group was created. |
dimension |
ad_group_delivery_status_{NUM} |
ad_group_delivery_status_{NUM} |
The current delivery status of the ad group, indicating whether it is active, paused, or archived. |
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 |
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled and affects 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 or goal for which the ad group is optimized, such as ‘PAGE_VISIT’ or ‘PURCHASE’. |
dimension |
ad_group_product_set_id |
ad_group_product_set_id |
The unique identifier of the product set targeted by this ad group, relevant for catalog-based ads. |
dimension |
ad_group_saved_audience_id |
ad_group_saved_audience_id |
The unique identifier of the saved audience targeted by this 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 hour (0-23) when an ad group is set to start running. |
dimension |
ad_group_skadnetwork_metadata |
ad_group_skadnetwork_metadata |
Metadata related to SKAdNetwork, used for app install attribution on iOS ad groups. |
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_targeting_carriers_{NUM} |
ad_group_targeting_carriers_{NUM} |
A list of mobile network carriers targeted by the ad group. |
dimension |
ad_group_targeting_communities |
ad_group_targeting_communities |
The Reddit communities (subreddits) targeted by the ad group. |
dimension |
ad_group_targeting_communities_{NUM} |
ad_group_targeting_communities_{NUM} |
A specific Reddit community targeted by the ad group, where {NUM} indicates an index in a list of communities. |
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_custom_audience_ids_{NUM} |
ad_group_targeting_custom_audience_ids_{NUM} |
A specific custom audience ID targeted by the ad group, where {NUM} indicates an index in a list of custom audiences. |
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 for a specific device type targeted by the ad group. |
dimension |
ad_group_targeting_devices_{NUM}_min_version |
ad_group_targeting_devices_{NUM}_min_version |
The minimum operating system version for a specific device type targeted by the ad group. |
dimension |
ad_group_targeting_devices_{NUM}_os |
ad_group_targeting_devices_{NUM}_os |
The operating system of a specific device type targeted by the ad group (e.g., ‘iOS’, ‘Android’). |
dimension |
ad_group_targeting_devices_{NUM}_type |
ad_group_targeting_devices_{NUM}_type |
A specific type of device targeted by the ad group (e.g., ‘MOBILE’, ‘TABLET’). |
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_communities_{NUM} |
ad_group_targeting_excluded_communities_{NUM} |
A specific Reddit community explicitly excluded from targeting by the ad group, where {NUM} indicates an index in a list. |
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_custom_audience_ids_{NUM} |
ad_group_targeting_excluded_custom_audience_ids_{NUM} |
A specific custom audience ID explicitly excluded from targeting by the ad group, where {NUM} indicates an index in a list. |
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_geolocations_{NUM} |
ad_group_targeting_excluded_geolocations_{NUM} |
A specific geographic location (city, country, DMA, postal code, or region) explicitly excluded from targeting by the ad group. |
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_geolocations_{NUM} |
ad_group_targeting_geolocations_{NUM} |
A specific geographic location (city, country, DMA, postal code, or region) targeted by the ad group. |
dimension |
ad_group_targeting_interests |
ad_group_targeting_interests |
User interests targeted by the ad group. |
dimension |
ad_group_targeting_interests_{NUM} |
ad_group_targeting_interests_{NUM} |
A specific user interest targeted by the ad group, where {NUM} indicates an index in a list of interests. |
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_keywords_{NUM} |
ad_group_targeting_keywords_{NUM} |
A specific keyword targeted by the ad group, where {NUM} indicates an index in a list of keywords. |
dimension |
ad_group_targeting_languages |
ad_group_targeting_languages |
A list of languages targeted by the ad group. |
dimension |
ad_group_targeting_languages_{NUM} |
ad_group_targeting_languages_{NUM} |
A specific language targeted by the ad group, where {NUM} indicates an index in a list of languages. |
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_locations_{NUM} |
ad_group_targeting_locations_{NUM} |
A specific physical location targeted by the ad group. |
dimension |
ad_group_targeting_platforms_{NUM} |
ad_group_targeting_platforms_{NUM} |
A specific platform (e.g., ‘WEB’, ‘MOBILE_APP’) where the ad group’s ads will be shown. |
dimension |
ad_group_targeting_view_modes |
ad_group_targeting_view_modes |
Defines the configuration or display modes for targeting settings applied to an ad group. |
dimension |
ad_group_targeting_view_modes_{NUM} |
ad_group_targeting_view_modes_{NUM} |
The targeting view modes configured for the ad group, which define how ads are displayed to specific audiences. |
dimension |
ad_group_view_through_conversion_type |
ad_group_view_through_conversion_type |
The type of view-through conversion attribution configured for the ad group. |
dimension |
ad_id |
ad_id |
A unique identifier for the ad. |
dimension |
ad_modified_at |
ad_modified_at |
The timestamp indicating when the ad was last modified. |
dimension |
ad_name |
ad_name |
The name of the ad. |
dimension |
ad_post_body |
ad_post_body |
The main content or body text of the ad post. |
dimension |
ad_post_content_{NUM}_call_to_action |
ad_post_content_{NUM}_call_to_action |
The call to action text associated with a specific content block within the ad post, prompting users to take a desired action. |
dimension |
ad_post_content_{NUM}_caption |
ad_post_content_{NUM}_caption |
The caption text for a specific content block within the ad post. |
dimension |
ad_post_content_{NUM}_destination_url |
ad_post_content_{NUM}_destination_url |
The destination URL for a specific content block within the ad post, where users are directed after clicking the ad. |
dimension |
ad_post_content_{NUM}_display_url |
ad_post_content_{NUM}_display_url |
The display URL for a specific content block within the ad post, which is shown to users. |
dimension |
ad_post_content_{NUM}_media_url |
ad_post_content_{NUM}_media_url |
The URL of the media (e.g., image or video) used in a specific content block within the ad post. |
dimension |
ad_post_created_at |
created_at |
The timestamp indicating when the ad post was originally created. This field is retrieved from the Structured Post schema. |
dimension |
ad_post_headline |
ad_post_headline |
The main headline text for the ad post. |
dimension |
ad_post_id |
ad_post_id |
The unique identifier of the Reddit post that is being promoted as an ad. |
dimension |
ad_post_thumbnail_url |
ad_post_thumbnail_url |
The URL for the thumbnail image of the ad post. |
dimension |
ad_post_type |
ad_post_type |
The type of the promoted Reddit post, such as an image, video, or text post. This field indicates the creative format of the ad. |
dimension |
ad_post_url |
ad_post_url |
The URL to which users are directed when they click the ad. |
dimension |
ad_preview_expiry |
ad_preview_expiry |
The expiration timestamp for the ad’s preview URL. |
dimension |
ad_preview_url |
ad_preview_url |
The URL that provides a preview of how the ad will appear to users. |
dimension |
ad_profile_id |
ad_profile_id |
The unique identifier of the Reddit profile associated with the ad, often through a structured post. |
dimension |
ad_rejection_reason |
ad_rejection_reason |
The reason provided if the ad was rejected during the review process. |
dimension |
ad_shopping_creative |
ad_shopping_creative |
Indicates if the ad is a shopping creative, typically used for catalog or product ads. |
dimension |
ad_skadnetwork_metadata |
ad_skadnetwork_metadata |
Metadata related to SKAdNetwork, used for app install attribution on iOS. |
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_payment_info_cvr |
app_install_add_payment_info_cvr |
The conversion rate for the add payment info event in an app install campaign. |
metric |
app_install_add_payment_info_ecpa |
app_install_add_payment_info_ecpa |
The effective cost per action for the add payment info event in an app install campaign. |
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_app_launch_cvr |
app_install_app_launch_cvr |
The conversion rate for the app launch event in an app install campaign. |
metric |
app_install_app_launch_ecpa |
app_install_app_launch_ecpa |
The effective cost per action for the app launch event in an app install campaign. |
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_completed_tutorial_cvr |
app_install_completed_tutorial_cvr |
The conversion rate for the completed tutorial event in an app install campaign. |
metric |
app_install_completed_tutorial_ecpa |
app_install_completed_tutorial_ecpa |
The effective cost per action for the completed tutorial event in an app install campaign. |
metric |
app_install_install_count |
app_install_install_count |
The number of app installs attributed to the ad campaign. |
metric |
app_install_install_cvr |
app_install_install_cvr |
The conversion rate for the app install event in an app install campaign. |
metric |
app_install_install_ecpa |
app_install_install_ecpa |
The effective cost per action for the app install event in an app install 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_level_achieved_cvr |
app_install_level_achieved_cvr |
The conversion rate for the level achieved event in an app install campaign. |
metric |
app_install_level_achieved_ecpa |
app_install_level_achieved_ecpa |
The effective cost per action for the level achieved event in an app install campaign. |
metric |
app_install_mmp_ad_click_cvr |
app_install_mmp_ad_click_cvr |
The conversion rate for an ad click event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_ad_click_ecpa |
app_install_mmp_ad_click_ecpa |
The effective cost per action for an ad click event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_add_to_wishlist_cvr |
app_install_mmp_add_to_wishlist_cvr |
The conversion rate for an add to wishlist event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_add_to_wishlist_ecpa |
app_install_mmp_add_to_wishlist_ecpa |
The effective cost per action for an add to wishlist event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_checkout_cvr |
app_install_mmp_checkout_cvr |
The conversion rate for a checkout event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_checkout_ecpa |
app_install_mmp_checkout_ecpa |
The effective cost per action for a checkout event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_first_time_purchase_cvr |
app_install_mmp_first_time_purchase_cvr |
The conversion rate for a first-time purchase event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_first_time_purchase_ecpa |
app_install_mmp_first_time_purchase_ecpa |
The effective cost per action for a first-time purchase event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_login_cvr |
app_install_mmp_login_cvr |
The conversion rate for a login event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_login_ecpa |
app_install_mmp_login_ecpa |
The effective cost per action for a login event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_onboard_completed_cvr |
app_install_mmp_onboard_completed_cvr |
The conversion rate for an onboard completed event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_onboard_completed_ecpa |
app_install_mmp_onboard_completed_ecpa |
The effective cost per action for an onboard completed event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_onboard_started_cvr |
app_install_mmp_onboard_started_cvr |
The conversion rate for an onboard started event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_onboard_started_ecpa |
app_install_mmp_onboard_started_ecpa |
The effective cost per action for an onboard started event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_rate_ecpa |
app_install_mmp_rate_ecpa |
The effective cost per action for a rating event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_start_trial_cvr |
app_install_mmp_start_trial_cvr |
The conversion rate for a start trial event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_start_trial_ecpa |
app_install_mmp_start_trial_ecpa |
The effective cost per action for a start trial event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_subscribe_cvr |
app_install_mmp_subscribe_cvr |
The conversion rate for a subscribe event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_subscribe_ecpa |
app_install_mmp_subscribe_ecpa |
The effective cost per action for a subscribe event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_unlock_achievement_cvr |
app_install_mmp_unlock_achievement_cvr |
The conversion rate for an unlock achievement event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_mmp_unlock_achievement_ecpa |
app_install_mmp_unlock_achievement_ecpa |
The effective cost per action for an unlock achievement event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign. |
metric |
app_install_purchase_count |
app_install_purchase_count |
The number of purchases made within the app following an ad install. |
metric |
app_install_purchase_cvr |
app_install_purchase_cvr |
The conversion rate for the purchase event in an app install campaign. |
metric |
app_install_purchase_ecpa |
app_install_purchase_ecpa |
The effective cost per action for the purchase event in an app install campaign. |
metric |
app_install_revenue |
app_install_revenue |
The total revenue generated from app install conversion events. |
metric |
app_install_search_count |
app_install_search_count |
The number of in-app searches performed by users after an install. |
metric |
app_install_search_cvr |
app_install_search_cvr |
The conversion rate for the search event in an app install campaign. |
metric |
app_install_search_ecpa |
app_install_search_ecpa |
The effective cost per action for the search event in an app install campaign. |
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_sign_up_cvr |
app_install_sign_up_cvr |
The conversion rate for the sign up event in an app install campaign. |
metric |
app_install_sign_up_ecpa |
app_install_sign_up_ecpa |
The effective cost per action for the sign up event in an app install campaign. |
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_click_cvr |
app_install_skan_ad_click_cvr |
The SKAdNetwork (SKAN) conversion rate for an ad click event in an app install campaign. |
metric |
app_install_skan_ad_click_ecpa |
app_install_skan_ad_click_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an ad click event in an app install campaign. |
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_payment_info_cvr |
app_install_skan_add_payment_info_cvr |
The SKAdNetwork (SKAN) conversion rate for an add payment info event in an app install campaign. |
metric |
app_install_skan_add_payment_info_ecpa |
app_install_skan_add_payment_info_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an add payment info event in an app install campaign. |
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_cart_cvr |
app_install_skan_add_to_cart_cvr |
The SKAdNetwork (SKAN) conversion rate for an add to cart event in an app install campaign. |
metric |
app_install_skan_add_to_cart_ecpa |
app_install_skan_add_to_cart_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an add to cart event in an app install campaign. |
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_add_to_wishlist_cvr |
app_install_skan_add_to_wishlist_cvr |
The SKAdNetwork (SKAN) conversion rate for an add to wishlist event in an app install campaign. |
metric |
app_install_skan_add_to_wishlist_ecpa |
app_install_skan_add_to_wishlist_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an add to wishlist event in an app install campaign. |
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_app_launch_cvr |
app_install_skan_app_launch_cvr |
The SKAdNetwork (SKAN) conversion rate for an app launch event in an app install campaign. |
metric |
app_install_skan_app_launch_ecpa |
app_install_skan_app_launch_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an app launch event in an app install campaign. |
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_checkout_cvr |
app_install_skan_checkout_cvr |
The SKAdNetwork (SKAN) conversion rate for a checkout event in an app install campaign. |
metric |
app_install_skan_checkout_ecpa |
app_install_skan_checkout_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a checkout event in an app install campaign. |
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_completed_tutorial_cvr |
app_install_skan_completed_tutorial_cvr |
The SKAdNetwork (SKAN) conversion rate for a completed tutorial event in an app install campaign. |
metric |
app_install_skan_completed_tutorial_ecpa |
app_install_skan_completed_tutorial_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a completed tutorial event in an app install campaign. |
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_first_time_purchase_cvr |
app_install_skan_first_time_purchase_cvr |
The SKAdNetwork (SKAN) conversion rate for a first-time purchase event in an app install campaign. |
metric |
app_install_skan_first_time_purchase_ecpa |
app_install_skan_first_time_purchase_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a first-time purchase event in an app install campaign. |
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_install_cvr |
app_install_skan_install_cvr |
The SKAdNetwork (SKAN) conversion rate for an app install event in an app install campaign. |
metric |
app_install_skan_install_ecpa |
app_install_skan_install_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an app install event in an app install campaign. |
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_level_achieved_cvr |
app_install_skan_level_achieved_cvr |
The SKAdNetwork (SKAN) conversion rate for a level achieved event in an app install campaign. |
metric |
app_install_skan_level_achieved_ecpa |
app_install_skan_level_achieved_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a level achieved event in an app install campaign. |
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_login_cvr |
app_install_skan_login_cvr |
The SKAdNetwork (SKAN) conversion rate for a login event in an app install campaign. |
metric |
app_install_skan_login_ecpa |
app_install_skan_login_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a login event in an app install campaign. |
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_completed_cvr |
app_install_skan_onboard_completed_cvr |
The SKAdNetwork (SKAN) conversion rate for an onboard completed event in an app install campaign. |
metric |
app_install_skan_onboard_completed_ecpa |
app_install_skan_onboard_completed_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an onboard completed event in an app install campaign. |
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_onboard_started_cvr |
app_install_skan_onboard_started_cvr |
The SKAdNetwork (SKAN) conversion rate for an onboard started event in an app install campaign. |
metric |
app_install_skan_onboard_started_ecpa |
app_install_skan_onboard_started_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an onboard started event in an app install campaign. |
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_purchase_cvr |
app_install_skan_purchase_cvr |
The SKAdNetwork (SKAN) conversion rate for a purchase event in an app install campaign. |
metric |
app_install_skan_purchase_ecpa |
app_install_skan_purchase_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a purchase event in an app install campaign. |
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_rate_cvr |
app_install_skan_rate_cvr |
The SKAdNetwork (SKAN) conversion rate for a rating event in an app install campaign. |
metric |
app_install_skan_rate_ecpa |
app_install_skan_rate_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a rating event in an app install campaign. |
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_reinstall_cvr |
app_install_skan_reinstall_cvr |
The SKAdNetwork (SKAN) conversion rate for a reinstall event in an app install campaign. |
metric |
app_install_skan_reinstall_ecpa |
app_install_skan_reinstall_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a reinstall event in an app install campaign. |
metric |
app_install_skan_revenue |
app_install_skan_revenue |
The total revenue attributed via SKAdNetwork (SKAN) for app install campaigns. |
metric |
app_install_skan_roas |
app_install_skan_roas |
The SKAdNetwork (SKAN) Return on Ad Spend for 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_search_cvr |
app_install_skan_search_cvr |
The SKAdNetwork (SKAN) conversion rate for a search event in an app install campaign. |
metric |
app_install_skan_search_ecpa |
app_install_skan_search_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a search event in an app install campaign. |
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_sign_up_cvr |
app_install_skan_sign_up_cvr |
The SKAdNetwork (SKAN) conversion rate for a sign up event in an app install campaign. |
metric |
app_install_skan_sign_up_ecpa |
app_install_skan_sign_up_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a sign up event in an app install campaign. |
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_start_trial_cvr |
app_install_skan_start_trial_cvr |
The SKAdNetwork (SKAN) conversion rate for a start trial event in an app install campaign. |
metric |
app_install_skan_start_trial_ecpa |
app_install_skan_start_trial_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a start trial event in an app install campaign. |
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_subscribe_cvr |
app_install_skan_subscribe_cvr |
The SKAdNetwork (SKAN) conversion rate for a subscribe event in an app install campaign. |
metric |
app_install_skan_subscribe_ecpa |
app_install_skan_subscribe_ecpa |
The SKAdNetwork (SKAN) effective cost per action for a subscribe event in an app install campaign. |
metric |
app_install_skan_total_conversions |
app_install_skan_total_conversions |
The aggregated count of app install conversions attributed through Apple’s SKAdNetwork for app-focused advertising 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_total_install_cvr |
app_install_skan_total_install_cvr |
The SKAdNetwork (SKAN) conversion rate for total installs in an app install campaign. |
metric |
app_install_skan_total_install_ecpa |
app_install_skan_total_install_ecpa |
The SKAdNetwork (SKAN) effective cost per action for total installs in an app install campaign. |
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_unlock_achievement_cvr |
app_install_skan_unlock_achievement_cvr |
The SKAdNetwork (SKAN) conversion rate for an unlock achievement event in an app install campaign. |
metric |
app_install_skan_unlock_achievement_ecpa |
app_install_skan_unlock_achievement_ecpa |
The SKAdNetwork (SKAN) effective cost per action for an unlock achievement event in an app install campaign. |
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 |
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. |
dimension |
campaign_ad_account_id |
campaign_ad_account_id |
The unique identifier of the ad account to which the campaign belongs. |
dimension |
campaign_app_id |
campaign_app_id |
The unique identifier of the app associated with the campaign, specifically for app install campaigns. |
dimension |
campaign_bid_strategy |
campaign_bid_strategy |
The bidding strategy configured for the campaign, such as lowest cost or target cost. |
dimension |
campaign_bid_value |
campaign_bid_value |
The bid value set for the 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_conversion_pixel_id |
campaign_conversion_pixel_id |
The unique identifier of the conversion pixel associated with the campaign, particularly for campaign budget optimization (CBO) campaigns. |
dimension |
campaign_created_at |
campaign_created_at |
The timestamp indicating when the campaign was created. |
dimension |
campaign_delivery_status_{NUM} |
campaign_delivery_status_{NUM} |
The current delivery status of the campaign, indicating whether it is active, paused, or archived. |
dimension |
campaign_effective_status |
campaign_effective_status |
The calculated current operational status of the campaign, considering all relevant factors. |
dimension |
campaign_end_time |
campaign_end_time |
The scheduled end time for the campaign. |
dimension |
campaign_funding_instrument_id |
campaign_funding_instrument_id |
The unique identifier of the funding instrument used to pay for the campaign. |
dimension |
campaign_goal_type |
campaign_goal_type |
The primary objective of the advertising campaign, indicating the desired outcome. Examples include brand awareness, driving website traffic, or increasing conversions. |
dimension |
campaign_goal_value |
campaign_goal_value |
The target value for the campaign’s lifetime budget. This field has been superseded by spend_cap. |
metric |
campaign_id |
campaign_id |
A unique identifier for the campaign. |
dimension |
campaign_invoice_label |
campaign_invoice_label |
A custom label that appears on the invoice for the campaign. |
dimension |
campaign_is_campaign_budget_optimization |
campaign_is_campaign_budget_optimization |
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled for the campaign. |
dimension |
campaign_is_max |
campaign_is_max |
A boolean indicating whether the campaign is a Reddit Max campaign. |
dimension |
campaign_modified_at |
campaign_modified_at |
The timestamp indicating when the campaign was last modified. |
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_optimization_goal |
campaign_optimization_goal |
The primary objective or goal for which the campaign is optimized, such as ‘SALES’ or ‘PAGE_VISIT’. |
dimension |
campaign_skadnetwork_metadata |
campaign_skadnetwork_metadata |
Metadata related to SKAdNetwork, used for app install attribution on iOS campaigns. |
dimension |
campaign_special_ad_categories |
campaign_special_ad_categories |
A list of special ad categories that apply to the campaign, such as housing or employment. |
dimension |
campaign_special_ad_categories_{NUM} |
campaign_special_ad_categories_{NUM} |
A specific special ad category that applies to the campaign, where {NUM} indicates an index in a list. |
dimension |
campaign_spend_cap |
campaign_spend_cap |
The maximum amount of money the campaign is allowed to spend over its lifetime. |
metric |
campaign_start_time |
campaign_start_time |
The scheduled start time for the campaign. |
dimension |
campaign_use_catalog |
campaign_use_catalog |
A boolean indicating whether the campaign uses a product catalog, primarily for ‘SALES’ objectives. |
dimension |
clicks |
clicks |
The total number of clicks on your ad. |
metric |
comment_downvotes |
comment_downvotes |
The number of downvotes received on a promoted Reddit post. |
metric |
comment_upvotes |
comment_upvotes |
The number of upvotes received on a promoted Reddit post. |
metric |
comments_page_views |
comments_page_views |
The total count of page views specifically for the comments section associated with an advertisement. |
metric |
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_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 |
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 |
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 |
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. |
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 |
frequency |
frequency |
The average number of times an ad is shown to a unique user within a specified reporting period. This is a key performance metric available in ad reports. |
metric |
gender |
gender |
The gender demographic data used for targeting ads or available as a breakdown in ad performance reports. |
dimension |
geolocations |
geolocations |
Geographic locations used for targeting audiences or as a breakdown dimension in reports. |
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. |
dimension |
hour |
hour |
A breakdown option for reports, allowing data to be viewed by hour. Reports using this breakdown are limited to a 7-day range. |
dimension |
id |
id |
The unique identifier for an entity (e.g., ad, ad group, campaign, account). |
metric |
impressions |
impressions |
The total number of times your ad was shown to users. |
metric |
interest |
interest |
Audience interest categories used for targeting ads to specific user segments or for analyzing ad performance based on user interests. |
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 field is used for contextual targeting, allowing advertisers to reach Reddit users engaging with conversations or content containing specific words or phrases relevant to the advertised product or service. |
dimension |
media_cost |
media_cost |
The total cost incurred for an ad, ad group, or campaign related to media placements. |
metric |
media_cost_usd |
media_cost_usd |
The cost incurred for displaying ad media, presented in United States Dollars (USD). This field represents the monetized value of ad impressions or clicks. |
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 |
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 |
region |
region |
A geographical region targeted by the ad campaign. |
dimension |
schedule |
schedule |
The defined start and end times for the campaign’s active period. |
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 of money spent on the ad campaign or ad entity, denominated in United States Dollars (USD). This metric is directly available in ad performance reports. |
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 |
Specifies the contexts or placements where targeted ads can be displayed, influencing how users encounter the advertising content on Reddit. |
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_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_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 |
viewable_impressions |
viewable_impressions |
The number of impressions where at least 50% of the ad pixels were on screen for at least one continuous second for display ads, or two continuous seconds for video ads. |
metric |
viewer_comments |
viewer_comments |
The total number of comments submitted by viewers in response to an advertisement or associated content. |
metric |