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.
account_admin_approval Dimension
Indicates whether the ad account requires administrator approval. This field is mutable only by Reddit.
account_app_attribution_type Dimension
The type of app attribution configured for the ad account, determining how app installs and events are credited to ads.
account_app_click_attribution_window Dimension
The time duration after an ad click during which app conversions are attributed to the ad account.
account_app_view_attribution_window Dimension
The time duration after an ad view (impression) during which app conversions are attributed to the ad account.
account_attribution_type Dimension
The attribution model used for the ad account to assign credit for conversions.
account_business_id Dimension
The unique identifier for the business associated with an ad account.
account_click_attribution_window Dimension
The duration, in days, after an ad click during which a conversion is attributed to that click.
account_created_at Dimension
The timestamp indicating when the ad account was created.
account_currency Dimension
The currency code used for the ad account.
account_id Dimension
A unique identifier for the ad account.
account_modified_at Dimension
The timestamp indicating when the ad account was last modified.
account_name Dimension
The name of the ad account.
account_primary_contact_member_id Dimension
The unique identifier of the primary contact member associated with the ad account.
account_status Dimension
The current operational status of the ad account.
account_suspension_reason Dimension
The reason provided for the suspension of the ad account.
account_time_zone_id Dimension
The time zone associated with the ad account, used for reporting and scheduling.
account_view_attribution_window Dimension
The duration, in days, after an ad view during which a conversion is attributed to that view.
ad_account_id Dimension
The unique identifier for the advertising account.
ad_ad_account_id Dimension
The unique identifier of the ad account to which the ad belongs.
ad_ad_group_id Dimension
The unique identifier of the ad group that contains this ad.
ad_campaign_id Dimension
The unique identifier of the campaign to which the ad belongs.
ad_campaign_objective_type Dimension
The objective type set for the campaign associated with this ad, such as brand awareness or conversions.
ad_click_url Dimension
The destination URL configured for the ad clicks.
ad_configured_status Dimension
The status that the user has manually configured for the ad. This can differ from the effective status based on other factors.
ad_created_at Dimension
The timestamp indicating when the ad was created.
ad_delivery_status_{NUM} Dimension
The current delivery status of the ad, indicating whether it is active, paused, or archived.
ad_effective_status Dimension
The calculated current operational status of the ad, considering all relevant factors.
ad_group_ad_account_id Dimension
The unique identifier of the ad account to which the ad group belongs.
ad_group_app_id Dimension
The ID of the app associated with the ad group.
ad_group_bid_strategy Dimension
The bidding strategy configured for the ad group.
ad_group_bid_type Dimension
The bidding strategy type used for the ad group.
ad_group_bid_value Metric
The bid amount set for the ad group.
ad_group_campaign_id Dimension
The unique identifier of the campaign to which the ad group belongs.
ad_group_campaign_objective_type Dimension
The objective type set for the campaign associated with this ad group.
ad_group_configured_status Dimension
The status that the user has manually configured for the ad group. This can differ from the effective status based on other factors.
ad_group_conversion_pixel_id Dimension
The unique identifier of the conversion pixel associated with the ad group, used for tracking conversions.
ad_group_created_at Dimension
The timestamp indicating when the ad group was created.
ad_group_delivery_status Dimension
The operational status of the ad group, indicating whether it is active, paused, or has other delivery-related states.
ad_group_delivery_status_{NUM} Dimension
The current delivery status of the ad group, indicating whether it is active, paused, or archived.
ad_group_effective_status Dimension
The calculated current operational status of the ad group, considering all relevant factors.
ad_group_end_time Dimension
The date and time when the ad group is scheduled to end.
ad_group_goal_type Dimension
The type of goal set for the ad group (e.g., clicks, conversions).
ad_group_goal_value Metric
The value associated with the goal set for the ad group.
ad_group_id Dimension
A unique identifier for the ad group.
ad_group_is_campaign_budget_optimization Dimension
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled and affects this ad group.
ad_group_modified_at Dimension
The timestamp indicating when the ad group was last modified.
ad_group_name Dimension
The name of the ad group.
ad_group_optimization_goal Dimension
The primary objective or goal for which the ad group is optimized, such as 'PAGE_VISIT' or 'PURCHASE'.
ad_group_product_set_id Dimension
The unique identifier of the product set targeted by this ad group, relevant for catalog-based ads.
ad_group_saved_audience_id Dimension
The unique identifier of the saved audience targeted by this ad group.
ad_group_schedule_end_day Dimension
The day of the week when an ad group's scheduled delivery ends.
ad_group_schedule_end_hour Dimension
The hour of the day when an ad group's scheduled delivery ends.
ad_group_schedule_start_day Dimension
The day of the week when an ad group's scheduled delivery starts.
ad_group_schedule_start_hour Dimension
The scheduled hour (0-23) when an ad group is set to start running.
ad_group_shopping_type Dimension
The type of shopping ad group, indicating its specific focus within e-commerce or product promotion campaigns.
ad_group_skadnetwork_metadata Dimension
Metadata related to SKAdNetwork, used for app install attribution on iOS ad groups.
ad_group_start_time Dimension
The date and time when the ad group is scheduled to begin delivering.
ad_group_targeting_carriers_{NUM} Dimension
A list of mobile network carriers targeted by the ad group.
ad_group_targeting_communities Dimension
The Reddit communities (subreddits) targeted by the ad group.
ad_group_targeting_communities_{NUM} Dimension
A specific Reddit community targeted by the ad group, where {NUM} indicates an index in a list of communities.
ad_group_targeting_custom_audience_ids Dimension
Identifiers for custom audiences targeted by the ad group.
ad_group_targeting_custom_audience_ids_{NUM} Dimension
A specific custom audience ID targeted by the ad group, where {NUM} indicates an index in a list of custom audiences.
ad_group_targeting_devices Dimension
A summary or list of device targeting criteria applied to the ad group.
ad_group_targeting_devices_{NUM}_max_version Dimension
The maximum operating system version for a specific device type targeted by the ad group.
ad_group_targeting_devices_{NUM}_min_version Dimension
The minimum operating system version for a specific device type targeted by the ad group.
ad_group_targeting_devices_{NUM}_os Dimension
The operating system of a specific device type targeted by the ad group (e.g., 'iOS', 'Android').
ad_group_targeting_devices_{NUM}_type Dimension
A specific type of device targeted by the ad group (e.g., 'MOBILE', 'TABLET').
ad_group_targeting_excluded_communities Dimension
Reddit communities (subreddits) explicitly excluded from the ad group's targeting.
ad_group_targeting_excluded_communities_{NUM} Dimension
A specific Reddit community explicitly excluded from targeting by the ad group, where {NUM} indicates an index in a list.
ad_group_targeting_excluded_custom_audience_ids Dimension
Identifiers for custom audiences explicitly excluded from the ad group's targeting.
ad_group_targeting_excluded_custom_audience_ids_{NUM} Dimension
A specific custom audience ID explicitly excluded from targeting by the ad group, where {NUM} indicates an index in a list.
ad_group_targeting_excluded_geolocations Dimension
Geographic locations explicitly excluded from the ad group's targeting.
ad_group_targeting_excluded_geolocations_{NUM} Dimension
A specific geographic location (city, country, DMA, postal code, or region) explicitly excluded from targeting by the ad group.
ad_group_targeting_excluded_interests Dimension
Interests explicitly excluded from the ad group's targeting.
ad_group_targeting_excluded_keywords Dimension
Keywords explicitly excluded from the ad group's targeting.
ad_group_targeting_expand_targeting Dimension
Indicates whether automated targeting expansion is enabled for the ad group, allowing Reddit to reach users beyond initial targeting selections.
ad_group_targeting_gender Dimension
Gender targeting applied to the ad group.
ad_group_targeting_geolocations Dimension
A summary or list of geographic locations targeted for the ad group.
ad_group_targeting_geolocations_{NUM} Dimension
A specific geographic location (city, country, DMA, postal code, or region) targeted by the ad group.
ad_group_targeting_interests Dimension
User interests targeted by the ad group.
ad_group_targeting_interests_{NUM} Dimension
A specific user interest targeted by the ad group, where {NUM} indicates an index in a list of interests.
ad_group_targeting_keywords Dimension
Keywords targeted by the ad group, often based on user engagement with conversation threads.
ad_group_targeting_keywords_{NUM} Dimension
A specific keyword targeted by the ad group, where {NUM} indicates an index in a list of keywords.
ad_group_targeting_languages Dimension
A list of languages targeted by the ad group.
ad_group_targeting_languages_{NUM} Dimension
A specific language targeted by the ad group, where {NUM} indicates an index in a list of languages.
ad_group_targeting_locations Dimension
Geographic locations (e.g., countries, states, or cities) targeted by the ad group.
ad_group_targeting_locations_{NUM} Dimension
A specific physical location targeted by the ad group.
ad_group_targeting_platforms_{NUM} Dimension
A specific platform (e.g., 'WEB', 'MOBILE_APP') where the ad group's ads will be shown.
ad_group_targeting_view_modes Dimension
Defines the configuration or display modes for targeting settings applied to an ad group.
ad_group_targeting_view_modes_{NUM} Dimension
The modes or categories used to define and view the targeting settings for an ad group, such as audience segments or demographic criteria.
ad_group_view_through_conversion_type Dimension
The type of view-through conversion attribution configured for the ad group.
ad_id Dimension
A unique identifier for the ad.
ad_modified_at Dimension
The timestamp indicating when the ad was last modified.
ad_name Dimension
The name of the ad.
ad_post_body Dimension
The main content or body text of the ad post.
ad_post_content_{NUM}_call_to_action Dimension
The call to action text associated with a specific content block within the ad post, prompting users to take a desired action.
ad_post_content_{NUM}_caption Dimension
The caption text associated with an image or video asset within an ad post, particularly for carousel ads.
ad_post_content_{NUM}_destination_url Dimension
The destination URL for a specific content block within the ad post, where users are directed after clicking the ad.
ad_post_content_{NUM}_display_url Dimension
The URL displayed to users as part of the ad's post content, which may or may not be the direct landing page URL.
ad_post_content_{NUM}_media_url Dimension
The URL of the media (e.g., image or video) used in a specific content block within the ad post.
ad_post_created_at created_at Dimension
The timestamp indicating when the ad post was originally created. This field is retrieved from the Structured Post schema.
ad_post_headline Dimension
The main headline text for the ad post.
ad_post_id Dimension
The unique identifier of the Reddit post that is being promoted as an ad.
ad_post_thumbnail_url Dimension
The URL for the thumbnail image associated with the ad post, used for visual representation in various ad placements.
ad_post_type type Dimension
The type of the promoted Reddit post, such as an image, video, or text post. This field indicates the creative format of the ad.
ad_post_url Dimension
The URL to which users are directed when they click the ad.
ad_preview_expiry Dimension
The expiration timestamp for the ad's preview URL.
ad_preview_url Dimension
The URL that provides a preview of how the ad will appear to users.
ad_products Dimension
The specific types of ad products offered by Reddit, such as promoted posts, video ads, or other creative formats.
ad_profile_id Dimension
The unique identifier of the Reddit profile associated with the ad, often through a structured post.
ad_rejection_reason Dimension
The reason provided if the ad was rejected during the review process.
ad_shopping_creative Dimension
The creative asset specifically designed for shopping ads, influencing how the ad's destination URL is handled.
ad_skadnetwork_metadata Dimension
Metadata related to SKAdNetwork, used for app install attribution on iOS.
age_restriction Dimension
A general age restriction setting, potentially applicable to an ad or a broader entity, indicating the minimum age requirement for viewing the content.
app_id Dimension
The unique identifier for the mobile application being advertised.
app_install_add_payment_info_count Metric
The number of times users added payment information within the app after an install.
app_install_add_payment_info_cvr Metric
The conversion rate for the add payment info event in an app install campaign.
app_install_add_payment_info_ecpa Metric
The effective cost per action for the add payment info event in an app install campaign.
app_install_add_to_cart_count Metric
The number of times users added items to their cart within the app after an install.
app_install_add_to_cart_cvr Metric
The conversion rate for 'add to cart' events that occur after an app installation. This is a metric available for performance reporting.
app_install_app_launch_count Metric
The number of times the app was launched after an install.
app_install_app_launch_cvr Metric
The conversion rate for the app launch event in an app install campaign.
app_install_app_launch_ecpa Metric
The effective cost per action for the app launch event in an app install campaign.
app_install_completed_tutorial_count Metric
The number of times users completed an in-app tutorial after an install.
app_install_completed_tutorial_cvr Metric
The conversion rate for the completed tutorial event in an app install campaign.
app_install_completed_tutorial_ecpa Metric
The effective cost per action for the completed tutorial event in an app install campaign.
app_install_install_count Metric
The number of app installs attributed to the ad campaign.
app_install_install_cvr Metric
The conversion rate for the app install event in an app install campaign.
app_install_install_ecpa Metric
The effective cost per action for the app install event in an app install campaign.
app_install_level_achieved_count Metric
The number of times users achieved a new level within the app after an install.
app_install_level_achieved_cvr Metric
The conversion rate for the level achieved event in an app install campaign.
app_install_level_achieved_ecpa Metric
The effective cost per action for the level achieved event in an app install campaign.
app_install_mmp_ad_click_cvr Metric
The conversion rate for an ad click event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_ad_click_ecpa Metric
The effective cost per action for an ad click event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_add_to_wishlist_cvr Metric
The conversion rate for an add to wishlist event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_add_to_wishlist_ecpa Metric
The effective cost per action for an add to wishlist event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_checkout_cvr Metric
The conversion rate for a checkout event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_checkout_ecpa Metric
The effective cost per action for a checkout event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_first_time_purchase_cvr Metric
The conversion rate for a first-time purchase event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_first_time_purchase_ecpa Metric
The effective cost per action for a first-time purchase event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_login_cvr Metric
The conversion rate for a login event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_login_ecpa Metric
The effective cost per action for a login event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_onboard_completed_cvr Metric
The conversion rate for an onboard completed event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_onboard_completed_ecpa Metric
The effective cost per action for an onboard completed event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_onboard_started_cvr Metric
The conversion rate for an onboard started event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_onboard_started_ecpa Metric
The effective cost per action for an onboard started event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_rate_ecpa Metric
The effective cost per action for a rating event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_start_trial_cvr Metric
The conversion rate for a start trial event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_start_trial_ecpa Metric
The effective cost per action for a start trial event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_subscribe_cvr Metric
The conversion rate for a subscribe event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_subscribe_ecpa Metric
The effective cost per action for a subscribe event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_unlock_achievement_cvr Metric
The conversion rate for an unlock achievement event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_mmp_unlock_achievement_ecpa Metric
The effective cost per action for an unlock achievement event, attributed by a Mobile Measurement Partner (MMP), in an app install campaign.
app_install_purchase_count Metric
The number of purchases made within the app following an ad install.
app_install_purchase_cvr Metric
The conversion rate for the purchase event in an app install campaign.
app_install_purchase_ecpa Metric
The effective cost per action for the purchase event in an app install campaign.
app_install_revenue Metric
The total revenue generated from app install conversion events.
app_install_search_count Metric
The number of in-app searches performed by users after an install.
app_install_search_cvr Metric
The conversion rate for the search event in an app install campaign.
app_install_search_ecpa Metric
The effective cost per action for the search event in an app install campaign.
app_install_sign_up_count Metric
The number of user sign-ups within the app after an install.
app_install_sign_up_cvr Metric
The conversion rate for the sign up event in an app install campaign.
app_install_sign_up_ecpa Metric
The effective cost per action for the sign up event in an app install campaign.
app_install_skan_ad_click_count Metric
The number of ad clicks attributed to app installs via SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_click_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an ad click event in an app install campaign.
app_install_skan_ad_click_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an ad click event in an app install campaign.
app_install_skan_ad_view_count Metric
The number of ad views attributed to app installs via SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_view_cvr Metric
The conversion rate from ad views to app installs, as reported by SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_view_ecpa Metric
The effective cost per action for app installs attributed to ad views, as reported by SKAdNetwork for iOS app install campaigns.
app_install_skan_add_payment_info_count Metric
The number of times users added payment information, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_add_payment_info_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an add payment info event in an app install campaign.
app_install_skan_add_payment_info_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an add payment info event in an app install campaign.
app_install_skan_add_to_cart_count Metric
The number of times users added items to their cart, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_add_to_cart_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an add to cart event in an app install campaign.
app_install_skan_add_to_cart_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an add to cart event in an app install campaign.
app_install_skan_add_to_wishlist_count Metric
The number of times users added items to a wishlist, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_add_to_wishlist_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an add to wishlist event in an app install campaign.
app_install_skan_add_to_wishlist_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an add to wishlist event in an app install campaign.
app_install_skan_app_launch_count Metric
The number of times the app was launched, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_app_launch_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an app launch event in an app install campaign.
app_install_skan_app_launch_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an app launch event in an app install campaign.
app_install_skan_checkout_count Metric
The number of times users completed a checkout, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_checkout_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a checkout event in an app install campaign.
app_install_skan_checkout_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a checkout event in an app install campaign.
app_install_skan_completed_tutorial_count Metric
The number of times users completed an in-app tutorial, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_completed_tutorial_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a completed tutorial event in an app install campaign.
app_install_skan_completed_tutorial_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a completed tutorial event in an app install campaign.
app_install_skan_first_time_purchase_count Metric
The number of first-time purchases made by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_first_time_purchase_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a first-time purchase event in an app install campaign.
app_install_skan_first_time_purchase_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a first-time purchase event in an app install campaign.
app_install_skan_install_count Metric
The number of app installs attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_install_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an app install event in an app install campaign.
app_install_skan_install_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an app install event in an app install campaign.
app_install_skan_level_achieved_count Metric
The number of times users achieved a new level within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_level_achieved_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a level achieved event in an app install campaign.
app_install_skan_level_achieved_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a level achieved event in an app install campaign.
app_install_skan_login_count Metric
The number of times users logged into the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_login_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a login event in an app install campaign.
app_install_skan_login_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a login event in an app install campaign.
app_install_skan_onboard_completed_count Metric
The number of times users completed the onboarding process, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_onboard_completed_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an onboard completed event in an app install campaign.
app_install_skan_onboard_completed_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an onboard completed event in an app install campaign.
app_install_skan_onboard_started_count Metric
The number of times users started the onboarding process, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_onboard_started_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an onboard started event in an app install campaign.
app_install_skan_onboard_started_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an onboard started event in an app install campaign.
app_install_skan_purchase_count Metric
The number of purchases made by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_purchase_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a purchase event in an app install campaign.
app_install_skan_purchase_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a purchase event in an app install campaign.
app_install_skan_rate_count Metric
The number of times users rated the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_rate_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a rating event in an app install campaign.
app_install_skan_rate_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a rating event in an app install campaign.
app_install_skan_reinstall_count Metric
The number of app reinstalls, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_reinstall_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a reinstall event in an app install campaign.
app_install_skan_reinstall_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a reinstall event in an app install campaign.
app_install_skan_revenue Metric
The total revenue attributed via SKAdNetwork (SKAN) for app install campaigns.
app_install_skan_roas Metric
The SKAdNetwork (SKAN) Return on Ad Spend for app install campaigns.
app_install_skan_search_count Metric
The number of in-app searches performed by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_search_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a search event in an app install campaign.
app_install_skan_search_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a search event in an app install campaign.
app_install_skan_sign_up_count Metric
The number of user sign-ups, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_sign_up_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a sign up event in an app install campaign.
app_install_skan_sign_up_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a sign up event in an app install campaign.
app_install_skan_spend_credits_count Metric
The number of times users spent in-app credits, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_start_trial_count Metric
The number of times users started a trial, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_start_trial_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a start trial event in an app install campaign.
app_install_skan_start_trial_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a start trial event in an app install campaign.
app_install_skan_subscribe_count Metric
The number of user subscriptions, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_subscribe_cvr Metric
The SKAdNetwork (SKAN) conversion rate for a subscribe event in an app install campaign.
app_install_skan_subscribe_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for a subscribe event in an app install campaign.
app_install_skan_total_conversions Metric
The aggregated count of app install conversions attributed through Apple's SKAdNetwork for app-focused advertising campaigns.
app_install_skan_total_install_count Metric
The total number of app installs, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_total_install_cvr Metric
The SKAdNetwork (SKAN) conversion rate for total installs in an app install campaign.
app_install_skan_total_install_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for total installs in an app install campaign.
app_install_skan_unknown_count Metric
The number of unknown app-install related events, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_unlock_achievement_count Metric
The number of times users unlocked an in-app achievement, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_unlock_achievement_cvr Metric
The SKAdNetwork (SKAN) conversion rate for an unlock achievement event in an app install campaign.
app_install_skan_unlock_achievement_ecpa Metric
The SKAdNetwork (SKAN) effective cost per action for an unlock achievement event in an app install campaign.
app_install_skan_view_content_count Metric
The number of times users viewed content within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_view_content_cvr Metric
The conversion rate from viewing content within the app to app installs, as reported by SKAdNetwork for iOS app install campaigns.
app_install_skan_view_content_ecpa Metric
The effective cost per action for viewing content within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_spend_credits_count Metric
The number of times users spent in-app credits after an install.
app_install_total_conversions Metric
The total number of conversions related to app installs.
app_install_view_content_count Metric
The number of times users viewed content within the app after an install.
app_install_view_content_cvr Metric
The conversion rate from app installs to viewing content within the app.
app_install_view_content_ecpa Metric
The effective cost per action for viewing content within the app after an install.
bid_strategy Dimension
The bidding strategy employed for the ad campaign or ad group, e.g., target cost, lowest cost.
bid_type Dimension
The type of bid, such as CPM (cost per mille/thousand impressions) or CPC (cost per click).
bid_value Dimension
The monetary value of the bid placed for the ad or ad group.
campaign_ad_account_id Dimension
The unique identifier of the ad account to which the campaign belongs.
campaign_age_restriction Dimension
The age restrictions applied to a campaign, defining the minimum and maximum age of the audience eligible to see the ads.
campaign_app_id Dimension
The unique identifier of the app associated with the campaign, specifically for app install campaigns.
campaign_bid_strategy Dimension
The bidding strategy configured for the campaign, such as lowest cost or target cost.
campaign_bid_type Dimension
The bidding strategy set for the campaign, which defines how costs are managed to achieve campaign objectives.
campaign_bid_value Dimension
The bid value set for the campaign.
campaign_configured_status Dimension
The status that the user has manually configured for the campaign. This can differ from the effective status based on other factors.
campaign_conversion_pixel_id Dimension
The unique identifier of the conversion pixel associated with the campaign, particularly for campaign budget optimization (CBO) campaigns.
campaign_created_at Dimension
The timestamp indicating when the campaign was created.
campaign_delivery_status_{NUM} Dimension
The current delivery status of the campaign, indicating whether it is active, paused, or archived.
campaign_effective_status Dimension
The calculated current operational status of the campaign, considering all relevant factors.
campaign_end_time Dimension
The scheduled end time for the campaign.
campaign_funding_instrument_id Dimension
The unique identifier of the funding instrument used to pay for the campaign.
campaign_goal_type Dimension
The primary objective of the advertising campaign, indicating the desired outcome. Examples include brand awareness, driving website traffic, or increasing conversions.
campaign_goal_value Metric
The target value for the campaign's lifetime budget. This field has been superseded by `spend_cap`.
campaign_id Dimension
A unique identifier for the campaign.
campaign_invoice_label Dimension
A custom label that appears on the invoice for the campaign.
campaign_is_campaign_budget_optimization Dimension
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled for the campaign.
campaign_is_max Dimension
A boolean indicating whether the campaign is a Reddit Max campaign.
campaign_modified_at Dimension
The timestamp indicating when the campaign was last modified.
campaign_name Dimension
The name of the campaign.
campaign_objective Dimension
The marketing objective set for the campaign (e.g., reach, traffic, conversions).
campaign_objective_type Dimension
The primary goal or objective of the campaign, e.g., brand awareness, traffic, conversions.
campaign_optimization_goal Dimension
The primary objective or goal for which the campaign is optimized, such as 'SALES' or 'PAGE_VISIT'.
campaign_skadnetwork_metadata Dimension
Metadata related to SKAdNetwork, used for app install attribution on iOS campaigns.
campaign_special_ad_categories Dimension
A list of special ad categories that apply to the campaign, such as housing or employment.
campaign_special_ad_categories_{NUM} Dimension
A specific special ad category that applies to the campaign, where {NUM} indicates an index in a list.
campaign_spend_cap Metric
The maximum amount of money the campaign is allowed to spend over its lifetime.
campaign_start_time Dimension
The scheduled start time for the campaign.
campaign_use_catalog Dimension
A boolean indicating whether the campaign uses a product catalog, primarily for 'SALES' objectives.
campaign_view_through_conversion_type Dimension
The specific type or attribution model for view-through conversions recorded for a campaign, which counts conversions where a user saw an ad but did not click it before converting.
clicks Metric
The total number of clicks on your ad.
comment_downvotes Metric
The number of downvotes received on a promoted Reddit post.
comment_upvotes Metric
The number of upvotes received on a promoted Reddit post.
comments_page_views Metric
The total count of page views specifically for the comments section associated with an advertisement.
community Dimension
The Reddit community (subreddit) targeted by the ad.
configured_status Dimension
The status of an entity (ad, ad group, or campaign) as manually set by the advertiser.
conversion_add_to_cart_avg_value Metric
The average monetary value of items added to a shopping cart as a result of an ad conversion event.
conversion_add_to_cart_clicks Metric
The number of clicks that led to an add-to-cart conversion event.
conversion_add_to_cart_ecpa Metric
The effective cost per action for 'add to cart' conversions.
conversion_add_to_cart_total_items Metric
The total number of items added to a shopping cart as a result of an ad conversion event.
conversion_add_to_cart_total_value Metric
The total monetary value generated from add-to-cart conversion events.
conversion_add_to_cart_views Metric
The number of views that led to an add-to-cart conversion event.
conversion_add_to_wishlist_avg_value Metric
The average monetary value of items added to a wishlist as a result of an ad conversion event.
conversion_add_to_wishlist_clicks Metric
The number of clicks on 'add to wishlist' actions that led to a conversion.
conversion_add_to_wishlist_ecpa Metric
The effective cost per action for 'add to wishlist' conversions.
conversion_add_to_wishlist_total_items Metric
The total number of items added to a wishlist as a result of an ad conversion event.
conversion_add_to_wishlist_total_value Metric
The total monetary value generated from add-to-wishlist conversion events.
conversion_add_to_wishlist_views Metric
The number of views of 'add to wishlist' opportunities that led to a conversion.
conversion_lead_avg_value Metric
The average monetary value generated from lead conversion events.
conversion_lead_clicks Metric
The number of clicks that led to a lead conversion event.
conversion_lead_ecpa Metric
The effective cost per action for lead generation conversions.
conversion_lead_total_value Metric
The total monetary value generated from lead conversion events.
conversion_lead_views Metric
The number of views that led to a lead conversion event.
conversion_page_visit_clicks Metric
The number of clicks that led to a page visit conversion event.
conversion_page_visit_ecpa Metric
The effective cost per action for page visit conversions.
conversion_page_visit_views Metric
The number of views that led to a page visit conversion event.
conversion_pixel_id Dimension
The unique identifier for the Reddit Pixel used to track conversions.
conversion_purchase_avg_value Metric
The average monetary value of purchases made as a result of an ad conversion event.
conversion_purchase_clicks Metric
The number of clicks that led to a purchase conversion event.
conversion_purchase_ecpa Metric
The effective cost per action for purchase conversions.
conversion_purchase_total_items Metric
The total number of items purchased as a result of conversion events.
conversion_purchase_total_value Metric
The total monetary value generated from purchase conversion events.
conversion_purchase_views Metric
The number of views that led to a purchase conversion event.
conversion_roas Metric
The Return On Ad Spend (ROAS), which measures the revenue generated for each unit of currency spent on advertising.
conversion_search_clicks Metric
The number of clicks that led to a search conversion event.
conversion_search_ecpa Metric
The effective cost per action for search conversions.
conversion_search_views Metric
The number of views that led to a search conversion event.
conversion_sign_up_clicks Metric
The total number of clicks attributed to a sign-up conversion event.
conversion_sign_up_ecpa Metric
The effective cost-per-acquisition (eCPA) for a sign-up conversion event.
conversion_sign_up_views Metric
The number of views recorded for a sign-up conversion event.
conversion_signup_avg_value Metric
The average monetary value generated from sign-up conversion events.
conversion_signup_total_value Metric
The total monetary value generated from sign-up conversion events.
conversion_view_content_clicks Metric
The number of clicks that led to a view content conversion event.
conversion_view_content_ecpa Metric
The effective cost per action for viewing content conversions.
conversion_view_content_views Metric
The number of views that led to a view content conversion event.
cost_per_completed_view Metric
The cost incurred for each video view that was watched to 100% completion.
cost_per_{NUM}_second_view Metric
The cost incurred for each video view that reaches a specific duration (e.g., 3 seconds, 10 seconds).
country Dimension
The country where the ad was displayed or targeted.
cpc Metric
The average cost per click for your ads.
cpv Metric
Cost per video view, which is the average cost incurred for each video view.
ctr Metric
The click-through rate, calculated as clicks divided by impressions.
currency Dimension
The currency in which the financial data is reported.
date Dimension
The specific date for which the data is reported.
dma Dimension
Designated Market Area (DMA) related to ad performance, often used for geographical reporting or targeting.
dma_name Dimension
The name of the Designated Market Area (DMA) targeted by an ad campaign or ad group. DMA names are retrieved from geolocation targeting data.
ecpm Metric
The effective cost per thousand impressions.
effective_status Dimension
The calculated, real-time status of an entity (ad, ad group, or campaign), taking into account various factors like configured status, budget, and targeting.
endDate Dimension
The end date for the campaign or ad group delivery.
endTime Dimension
The end time for the campaign or ad group delivery within a day.
end_time Dimension
The date and time when the entity (e.g., campaign, ad group) is scheduled to stop delivering.
engaged_click Metric
A metric representing a user's more significant interaction with an ad beyond a standard click, indicating deeper engagement.
frequency Metric
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.
funding_instrument_id Dimension
The unique identifier of the payment method or funding source associated with an ad campaign.
gender Dimension
The gender demographic data used for targeting ads or available as a breakdown in ad performance reports.
geolocations Dimension
Geographic locations used for targeting audiences or as a breakdown dimension in reports.
goal_type Dimension
The specific type of goal set for the campaign's optimization, e.g., conversions, clicks, impressions.
goal_value Dimension
The target value associated with the campaign's optimization goal.
hour Dimension
A breakdown option for reports, allowing data to be viewed by hour. Reports using this breakdown are limited to a 7-day range.
id Metric
The unique identifier for an entity (e.g., ad, ad group, campaign, account).
impressions Metric
The total number of times your ad was shown to users.
interest Dimension
Audience interest categories used for targeting ads to specific user segments or for analyzing ad performance based on user interests.
is_campaign_budget_optimization Dimension
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign.
keyword Dimension
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.
media_cost Metric
The total cost incurred for an ad, ad group, or campaign related to media placements.
media_cost_usd Metric
The cost incurred for displaying ad media, presented in United States Dollars (USD). This field represents the monetized value of ad impressions or clicks.
modified_at Dimension
The timestamp when the entity (e.g., ad, ad group, campaign) was last modified.
name Dimension
The name of the entity (e.g., ad, ad group, campaign, account).
objective Dimension
The primary goal of the campaign, such as driving app installs, conversions, clicks, impressions, lead generation, video views, or catalog sales.
optimization_goal Dimension
The specific action or metric the campaign is optimized to achieve.
placement Dimension
The location where the ad was displayed (e.g., feed, sidebar).
placement_id Dimension
The unique identifier for the ad placement.
region Dimension
A geographical region targeted by the ad campaign.
schedule Dimension
The defined start and end times for the campaign's active period.
skadnetwork_metadata Dimension
Metadata related to SKAdNetwork settings and attribution for the ad, used for iOS app install campaigns.
spend Metric
The total amount of money spent on advertising campaigns.
spend_USD Metric
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.
spend_cap Metric
The maximum amount of money a campaign is allowed to spend over its entire lifetime.
startDate Dimension
The start date for the campaign or ad group delivery.
startTime Dimension
The start time for the campaign or ad group delivery within a day.
start_time Dimension
The date and time when the entity (e.g., campaign, ad group) is scheduled to begin delivering.
targeting.carriers Dimension
Mobile carriers targeted for ad delivery.
targeting.communities Dimension
Reddit communities (subreddits) targeted for ad delivery.
targeting.custom_audience_ids Dimension
Identifiers for custom audiences to be targeted.
targeting.devices Dimension
Device types (e.g., mobile, desktop) targeted for ad delivery.
targeting.excluded_communities Dimension
Reddit communities (subreddits) explicitly excluded from targeting.
targeting.excluded_custom_audience_ids Dimension
Identifiers for custom audiences explicitly excluded from targeting.
targeting.excluded_geolocations Dimension
Geographic locations explicitly excluded from targeting.
targeting.excluded_keywords Dimension
Keywords explicitly excluded from targeting.
targeting.expand_targeting Dimension
Indicates whether automated targeting expansion is enabled, allowing Reddit to reach users beyond initial targeting selections.
targeting.gender Dimension
Gender targeting preference for ad delivery.
targeting.geolocations Dimension
Geographic locations targeted for ad delivery.
targeting.interests Dimension
User interests targeted for ad delivery.
targeting.keywords Dimension
Keywords targeted for ad delivery, often based on user engagement with conversation threads.
targeting.languages Dimension
Languages of the users to be targeted for ad delivery.
targeting.locations Dimension
Geographic locations (e.g., countries, states, or cities) targeted for ad delivery.
targeting.platforms Dimension
The platforms (e.g., iOS, Android, Desktop) where ads are displayed.
targeting.suppression_event_types Dimension
Event types used to suppress ad delivery to users who have completed these actions, preventing retargeting.
targeting.view_modes Dimension
Specifies the contexts or placements where targeted ads can be displayed, influencing how users encounter the advertising content on Reddit.
video_completion_rate Metric
The percentage of video ads that were watched to 100% completion.
video_fully_viewable_impressions Metric
The number of impressions where the video ad was 100% in view for at least two consecutive seconds.
video_plays_expanded Metric
The number of times a video ad was played in an expanded view.
video_plays_with_sound Metric
The number of times a video ad was played with sound enabled.
video_started Metric
The number of times the video ad started playing.
video_view_rate Metric
The rate at which video ads were viewed, calculated as video plays divided by impressions.
video_view_rate_{NUM}_seconds Metric
The percentage of impressions that result in a video view of a specific duration (e.g., 3 seconds, 10 seconds).
video_viewable_impressions Metric
The number of times your video ad was considered viewable by industry standards.
video_viewable_watched_{NUM}_seconds Metric
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.
video_watched_{NUM}_percent Metric
The number of times a video ad was watched up to a specific percentage completion (e.g., 25%, 50%, 75%).
video_watched_{NUM}_seconds Metric
The number of times a video ad was watched for at least a specific duration in seconds.
view_through_conversion_type Dimension
The type of view-through conversion, indicating conversions that occurred after an impression but without a direct click.
viewable_impressions Metric
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.
viewer_comments Metric
The total number of comments submitted by viewers in response to an advertisement or associated content.