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_approvalDimension
Indicates whether the ad account requires administrator approval. This field is mutable only by Reddit.
account_app_attribution_typeDimension
The type of app attribution configured for the ad account, determining how app installs and events are credited to ads.
account_app_click_attribution_windowDimension
The time duration after an ad click during which app conversions are attributed to the ad account.
account_app_view_attribution_windowDimension
The time duration after an ad view (impression) during which app conversions are attributed to the ad account.
account_attribution_typeDimension
The attribution model used for the ad account to assign credit for conversions.
account_business_idDimension
The unique identifier for the business associated with an ad account.
account_click_attribution_windowDimension
The duration, in days, after an ad click during which a conversion is attributed to that click.
account_created_atDimension
The timestamp indicating when the ad account was created.
account_currencyDimension
The currency code used for the ad account.
account_idDimension
A unique identifier for the ad account.
account_modified_atDimension
The timestamp indicating when the ad account was last modified.
account_nameDimension
The name of the ad account.
account_primary_contact_member_idDimension
The unique identifier of the primary contact member associated with the ad account.
account_statusDimension
The current operational status of the ad account.
account_suspension_reasonDimension
The reason provided for the suspension of the ad account.
account_time_zone_idDimension
The time zone associated with the ad account, used for reporting and scheduling.
account_view_attribution_windowDimension
The duration, in days, after an ad view during which a conversion is attributed to that view.
ad_account_idDimension
The unique identifier for the advertising account.
ad_ad_account_idDimension
The unique identifier of the ad account to which the ad belongs.
ad_ad_group_idDimension
The unique identifier of the ad group that contains this ad.
ad_campaign_idDimension
The unique identifier of the campaign to which the ad belongs.
ad_campaign_objective_typeDimension
The objective type set for the campaign associated with this ad, such as brand awareness or conversions.
ad_click_urlDimension
The destination URL configured for the ad clicks.
ad_configured_statusDimension
The status that the user has manually configured for the ad. This can differ from the effective status based on other factors.
ad_created_atDimension
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_statusDimension
The calculated current operational status of the ad, considering all relevant factors.
ad_group_ad_account_idDimension
The unique identifier of the ad account to which the ad group belongs.
ad_group_app_idDimension
The ID of the app associated with the ad group.
ad_group_bid_strategyDimension
The bidding strategy configured for the ad group.
ad_group_bid_typeDimension
The bidding strategy type used for the ad group.
ad_group_bid_valueDimension
The bid amount set for the ad group.
ad_group_campaign_idDimension
The unique identifier of the campaign to which the ad group belongs.
ad_group_campaign_objective_typeDimension
The objective type set for the campaign associated with this ad group.
ad_group_configured_statusDimension
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_idDimension
The unique identifier of the conversion pixel associated with the ad group, used for tracking conversions.
ad_group_created_atDimension
The timestamp indicating when the ad group was created.
ad_group_delivery_statusDimension
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_statusDimension
The calculated current operational status of the ad group, considering all relevant factors.
ad_group_end_timeDimension
The date and time when the ad group is scheduled to end.
ad_group_goal_typeDimension
The type of goal set for the ad group (e.g., clicks, conversions).
ad_group_goal_valueMetric
The value associated with the goal set for the ad group.
ad_group_idDimension
A unique identifier for the ad group.
ad_group_is_campaign_budget_optimizationDimension
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled and affects this ad group.
ad_group_modified_atDimension
The timestamp indicating when the ad group was last modified.
ad_group_nameDimension
The name of the ad group.
ad_group_optimization_goalDimension
The primary objective or goal for which the ad group is optimized, such as 'PAGE_VISIT' or 'PURCHASE'.
ad_group_product_set_idDimension
The unique identifier of the product set targeted by this ad group, relevant for catalog-based ads.
ad_group_saved_audience_idDimension
The unique identifier of the saved audience targeted by this ad group.
ad_group_schedule_end_dayDimension
The day of the week when an ad group's scheduled delivery ends.
ad_group_schedule_end_hourDimension
The hour of the day when an ad group's scheduled delivery ends.
ad_group_schedule_start_dayDimension
The day of the week when an ad group's scheduled delivery starts.
ad_group_schedule_start_hourDimension
The scheduled hour (0-23) when an ad group is set to start running.
ad_group_shopping_typeDimension
The type of shopping campaign associated with the ad group, indicating how products from a catalog are used for ad delivery, particularly for sales and catalog sales objectives. This field is required for all ad groups.
ad_group_skadnetwork_metadataDimension
Metadata related to SKAdNetwork, used for app install attribution on iOS ad groups.
ad_group_start_timeDimension
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_communitiesDimension
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_idsDimension
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_devicesDimension
A summary or list of device targeting criteria applied to the ad group.
ad_group_targeting_devices_{NUM}_max_versionDimension
The maximum operating system version for a specific device type targeted by the ad group.
ad_group_targeting_devices_{NUM}_min_versionDimension
The minimum operating system version for a specific device type targeted by the ad group.
ad_group_targeting_devices_{NUM}_osDimension
The operating system of a specific device type targeted by the ad group (e.g., 'iOS', 'Android').
ad_group_targeting_devices_{NUM}_typeDimension
A specific type of device targeted by the ad group (e.g., 'MOBILE', 'TABLET').
ad_group_targeting_excluded_communitiesDimension
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_idsDimension
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_geolocationsDimension
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_interestsDimension
Interests explicitly excluded from the ad group's targeting.
ad_group_targeting_excluded_keywordsDimension
Keywords explicitly excluded from the ad group's targeting.
ad_group_targeting_expand_targetingDimension
Indicates whether automated targeting expansion is enabled for the ad group, allowing Reddit to reach users beyond initial targeting selections.
ad_group_targeting_genderDimension
Gender targeting applied to the ad group.
ad_group_targeting_geolocationsDimension
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_interestsDimension
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_keywordsDimension
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_languagesDimension
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_locationsDimension
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_modesDimension
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_typeDimension
The type of view-through conversion attribution configured for the ad group.
ad_idDimension
A unique identifier for the ad.
ad_modified_atDimension
The timestamp indicating when the ad was last modified.
ad_nameDimension
The name of the ad.
ad_post_bodyDimension
The main content or body text of the ad post.
ad_post_content_{NUM}_call_to_actionDimension
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}_captionDimension
The caption text associated with an image or video asset within an ad post, particularly for carousel ads.
ad_post_content_{NUM}_destination_urlDimension
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_urlDimension
The URL displayed as part of the ad's content for a specific promoted post.
ad_post_content_{NUM}_media_urlDimension
The URL of the media (e.g., image or video) used in a specific content block within the ad post.
ad_post_created_atcreated_atDimension
The timestamp indicating when the ad post was originally created. This field is retrieved from the Structured Post schema.
ad_post_headlineDimension
The main headline text for the ad post.
ad_post_idDimension
The unique identifier of the Reddit post that is being promoted as an ad.
ad_post_thumbnail_urlDimension
The URL for the thumbnail image associated with the ad post, used for visual representation in various ad placements.
ad_post_typetypeDimension
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_urlDimension
The URL to which users are directed when they click the ad.
ad_preview_expiryDimension
The expiration timestamp for the ad's preview URL.
ad_preview_urlDimension
The URL that provides a preview of how the ad will appear to users.
ad_productsDimension
Represents the types of ad products available or used within a campaign, such as various ad formats (e.g., image, video, carousel).
ad_profile_idDimension
The unique identifier of the Reddit profile associated with the ad, often through a structured post.
ad_rejection_reasonDimension
The reason provided if the ad was rejected during the review process.
ad_shopping_creativeDimension
The creative asset specifically designed for shopping ads, influencing how the ad's destination URL is handled.
ad_skadnetwork_metadataDimension
Metadata related to SKAdNetwork, used for app install attribution on iOS.
age_restrictionDimension
The age demographic targeted or restricted for the ad, allowing advertisers to refine their audience based on age groups. This is a setting within the ad group's audience parameters.
app_idDimension
The unique identifier for the mobile application being advertised.
app_install_add_payment_info_countMetric
The number of times users added payment information within the app after an install.
app_install_add_to_cart_countMetric
The number of times users added items to their cart within the app after an install.
app_install_add_to_cart_cvrMetric
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_countMetric
The number of times the app was launched after an install.
app_install_completed_tutorial_countMetric
The number of times users completed an in-app tutorial after an install.
app_install_install_countMetric
The number of app installs attributed to the ad campaign.
app_install_level_achieved_countMetric
The number of times users achieved a new level within the app after an install.
app_install_purchase_countMetric
The number of purchases made within the app following an ad install.
app_install_revenueMetric
The total revenue generated from app install conversion events.
app_install_search_countMetric
The number of in-app searches performed by users after an install.
app_install_search_ecpaMetric
The effective cost per action for the search event in an app install campaign.
app_install_sign_up_countMetric
The number of user sign-ups within the app after an install.
app_install_skan_ad_click_countMetric
The number of ad clicks attributed to app installs via SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_view_countMetric
The number of ad views attributed to app installs via SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_view_cvrMetric
The conversion rate from ad views to app installs, as reported by SKAdNetwork for iOS app install campaigns.
app_install_skan_ad_view_ecpaMetric
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_countMetric
The number of times users added payment information, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_add_to_cart_countMetric
The number of times users added items to their cart, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_add_to_wishlist_countMetric
The number of times users added items to a wishlist, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_app_launch_countMetric
The number of times the app was launched, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_checkout_countMetric
The number of times users completed a checkout, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_completed_tutorial_countMetric
The number of times users completed an in-app tutorial, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_first_time_purchase_countMetric
The number of first-time purchases made by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_install_countMetric
The number of app installs attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_level_achieved_countMetric
The number of times users achieved a new level within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_login_countMetric
The number of times users logged into the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_onboard_completed_countMetric
The number of times users completed the onboarding process, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_onboard_started_countMetric
The number of times users started the onboarding process, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_purchase_countMetric
The number of purchases made by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_rate_countMetric
The number of times users rated the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_reinstall_countMetric
The number of app reinstalls, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_search_countMetric
The number of in-app searches performed by users, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_sign_up_countMetric
The number of user sign-ups, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_spend_credits_countMetric
The number of times users spent in-app credits, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_start_trial_countMetric
The number of times users started a trial, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_subscribe_countMetric
The number of user subscriptions, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_total_conversionsMetric
The aggregated count of app install conversions attributed through Apple's SKAdNetwork for app-focused advertising campaigns.
app_install_skan_total_install_countMetric
The total number of app installs, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_unknown_countMetric
The number of unknown app-install related events, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_unlock_achievement_countMetric
The number of times users unlocked an in-app achievement, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_view_content_countMetric
The number of times users viewed content within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_skan_view_content_cvrMetric
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_ecpaMetric
The effective cost per action for viewing content within the app, attributed via SKAdNetwork for iOS app install campaigns.
app_install_spend_credits_countMetric
The number of times users spent in-app credits after an install.
app_install_total_conversionsMetric
The total number of conversions related to app installs.
app_install_view_content_countMetric
The number of times users viewed content within the app after an install.
app_install_view_content_cvrMetric
The conversion rate from app installs to viewing content within the app.
app_install_view_content_ecpaMetric
The effective cost per action for viewing content within the app after an install.
bid_strategyDimension
The bidding strategy employed for the ad campaign or ad group, e.g., target cost, lowest cost.
bid_typeDimension
The type of bid, such as CPM (cost per mille/thousand impressions) or CPC (cost per click).
bid_valueDimension
The monetary value of the bid placed for the ad or ad group.
billable_amountMetric
The total amount spent or billed for advertising activities.
campaign_ad_account_idDimension
The unique identifier of the ad account to which the campaign belongs.
campaign_age_restrictionDimension
The age restrictions applied to a campaign, defining the minimum and maximum age of the audience eligible to see the ads.
campaign_app_idDimension
The unique identifier of the app associated with the campaign, specifically for app install campaigns.
campaign_bid_strategyDimension
The bidding strategy configured for the campaign, such as lowest cost or target cost.
campaign_bid_typeDimension
The bidding strategy set for the campaign, which defines how costs are managed to achieve campaign objectives.
campaign_bid_valueDimension
The bid value set for the campaign.
campaign_configured_statusDimension
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_idDimension
The unique identifier of the conversion pixel associated with the campaign, particularly for campaign budget optimization (CBO) campaigns.
campaign_created_atDimension
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_statusDimension
The calculated current operational status of the campaign, considering all relevant factors.
campaign_end_timeDimension
The scheduled end time for the campaign.
campaign_funding_instrument_idDimension
The unique identifier of the funding instrument used to pay for the campaign.
campaign_goal_typeDimension
The primary objective of the advertising campaign, indicating the desired outcome. Examples include brand awareness, driving website traffic, or increasing conversions.
campaign_goal_valueMetric
The target value for the campaign's lifetime budget. This field has been superseded by `spend_cap`.
campaign_idDimension
A unique identifier for the campaign.
campaign_invoice_labelDimension
A custom label that appears on the invoice for the campaign.
campaign_is_campaign_budget_optimizationDimension
A boolean indicating whether Campaign Budget Optimization (CBO) is enabled for the campaign.
campaign_is_maxDimension
A boolean indicating whether the campaign is a Reddit Max campaign.
campaign_modified_atDimension
The timestamp indicating when the campaign was last modified.
campaign_nameDimension
The name of the campaign.
campaign_objectiveDimension
The marketing objective set for the campaign (e.g., reach, traffic, conversions).
campaign_objective_typeDimension
The primary goal or objective of the campaign, e.g., brand awareness, traffic, conversions.
campaign_optimization_goalDimension
The primary objective or goal for which the campaign is optimized, such as 'SALES' or 'PAGE_VISIT'.
campaign_skadnetwork_metadataDimension
Metadata related to SKAdNetwork, used for app install attribution on iOS campaigns.
campaign_special_ad_categoriesDimension
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_capMetric
The maximum amount of money the campaign is allowed to spend over its lifetime.
campaign_start_timeDimension
The scheduled start time for the campaign.
campaign_use_catalogDimension
A boolean indicating whether the campaign uses a product catalog, primarily for 'SALES' objectives.
campaign_view_through_conversion_typeDimension
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.
clicksMetric
The total number of clicks on your ad.
comment_downvotesMetric
The number of downvotes received on a promoted Reddit post.
comment_upvotesMetric
The number of upvotes received on a promoted Reddit post.
comments_page_viewsMetric
The total count of page views specifically for the comments section associated with an advertisement.
communityDimension
The Reddit community (subreddit) targeted by the ad.
configured_statusDimension
The status of an entity (ad, ad group, or campaign) as manually set by the advertiser.
conversion_add_to_cart_avg_valueMetric
The average monetary value of items added to a shopping cart as a result of an ad conversion event.
conversion_add_to_cart_clicksMetric
The number of clicks that led to an add-to-cart conversion event.
conversion_add_to_cart_ecpaMetric
The effective cost per action for 'add to cart' conversions.
conversion_add_to_cart_total_itemsMetric
The total number of items added to a shopping cart as a result of an ad conversion event.
conversion_add_to_cart_total_valueMetric
The total monetary value generated from add-to-cart conversion events.
conversion_add_to_cart_viewsMetric
The number of views that led to an add-to-cart conversion event.
conversion_add_to_wishlist_avg_valueMetric
The average monetary value of items added to a wishlist as a result of an ad conversion event.
conversion_add_to_wishlist_clicksMetric
The number of clicks on 'add to wishlist' actions that led to a conversion.
conversion_add_to_wishlist_ecpaMetric
The effective cost per action for 'add to wishlist' conversions.
conversion_add_to_wishlist_total_itemsMetric
The total number of items added to a wishlist as a result of an ad conversion event.
conversion_add_to_wishlist_total_valueMetric
The total monetary value generated from add-to-wishlist conversion events.
conversion_add_to_wishlist_viewsMetric
The number of views of 'add to wishlist' opportunities that led to a conversion.
conversion_lead_avg_valueMetric
The average monetary value generated from lead conversion events.
conversion_lead_clicksMetric
The number of clicks that led to a lead conversion event.
conversion_lead_ecpaMetric
The effective cost per action for lead generation conversions.
conversion_lead_total_valueMetric
The total monetary value generated from lead conversion events.
conversion_lead_viewsMetric
The number of views that led to a lead conversion event.
conversion_page_visit_clicksMetric
The number of clicks that led to a page visit conversion event.
conversion_page_visit_ecpaMetric
The effective cost per action for page visit conversions.
conversion_page_visit_viewsMetric
The number of views that led to a page visit conversion event.
conversion_pixel_idDimension
The unique identifier for the Reddit Pixel used to track conversions.
conversion_purchase_avg_valueMetric
The average monetary value of purchases made as a result of an ad conversion event.
conversion_purchase_clicksMetric
The number of clicks that led to a purchase conversion event.
conversion_purchase_ecpaMetric
The effective cost per action for purchase conversions.
conversion_purchase_total_itemsMetric
The total number of items purchased as a result of conversion events.
conversion_purchase_total_valueMetric
The total monetary value generated from purchase conversion events.
conversion_purchase_viewsMetric
The number of views that led to a purchase conversion event.
conversion_roasMetric
The Return On Ad Spend (ROAS), which measures the revenue generated for each unit of currency spent on advertising.
conversion_search_clicksMetric
The number of clicks that led to a search conversion event.
conversion_search_ecpaMetric
The effective cost per action for search conversions.
conversion_search_viewsMetric
The number of views that led to a search conversion event.
conversion_sign_up_clicksMetric
The total number of clicks attributed to a sign-up conversion event.
conversion_sign_up_ecpaMetric
The effective cost-per-acquisition (eCPA) for a sign-up conversion event.
conversion_sign_up_viewsMetric
The number of views recorded for a sign-up conversion event.
conversion_signup_avg_valueMetric
The average monetary value generated from sign-up conversion events.
conversion_signup_total_valueMetric
The total monetary value generated from sign-up conversion events.
conversion_view_content_clicksMetric
The number of clicks that led to a view content conversion event.
conversion_view_content_ecpaMetric
The effective cost per action for viewing content conversions.
conversion_view_content_viewsMetric
The number of views that led to a view content conversion event.
cost_per_completed_viewMetric
The cost incurred for each video view that was watched to 100% completion.
cost_per_{NUM}_second_viewMetric
The cost incurred for each video view that reaches a specific duration (e.g., 3 seconds, 10 seconds).
countryDimension
The country where the ad was displayed or targeted.
cpcMetric
The average cost per click for your ads.
cpvMetric
Cost per video view, which is the average cost incurred for each video view.
ctrMetric
The click-through rate, calculated as clicks divided by impressions.
currencyDimension
The currency in which the financial data is reported.
dateDimension
The specific date for which the data is reported.
dmaDimension
Designated Market Area (DMA) related to ad performance, often used for geographical reporting or targeting.
dma_nameDimension
The name of the Designated Market Area (DMA) targeted by an ad campaign or ad group. DMA names are retrieved from geolocation targeting data.
ecpmMetric
The effective cost per thousand impressions.
effective_statusDimension
The calculated, real-time status of an entity (ad, ad group, or campaign), taking into account various factors like configured status, budget, and targeting.
endDateDimension
The end date for the campaign or ad group delivery.
endTimeDimension
The end time for the campaign or ad group delivery within a day.
end_timeDimension
The date and time when the entity (e.g., campaign, ad group) is scheduled to stop delivering.
frequencyMetric
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_idDimension
The unique identifier of the payment method or funding source associated with an ad campaign.
genderDimension
The gender demographic data used for targeting ads or available as a breakdown in ad performance reports.
geolocationsDimension
Geographic locations used for targeting audiences or as a breakdown dimension in reports.
goal_typeDimension
The specific type of goal set for the campaign's optimization, e.g., conversions, clicks, impressions.
goal_valueDimension
The target value associated with the campaign's optimization goal.
hourDimension
A breakdown option for reports, allowing data to be viewed by hour. Reports using this breakdown are limited to a 7-day range.
idMetric
The unique identifier for an entity (e.g., ad, ad group, campaign, account).
impressionsMetric
The total number of times your ad was shown to users.
interestDimension
Audience interest categories used for targeting ads to specific user segments or for analyzing ad performance based on user interests.
is_campaign_budget_optimizationDimension
Indicates whether Campaign Budget Optimization (CBO) is enabled for the campaign.
keywordDimension
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_costMetric
The total cost incurred for an ad, ad group, or campaign related to media placements.
media_cost_usdMetric
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_atDimension
The timestamp when the entity (e.g., ad, ad group, campaign) was last modified.
nameDimension
The name of the entity (e.g., ad, ad group, campaign, account).
objectiveDimension
The primary goal of the campaign, such as driving app installs, conversions, clicks, impressions, lead generation, video views, or catalog sales.
optimization_goalDimension
The specific action or metric the campaign is optimized to achieve.
placementDimension
The location where the ad was displayed (e.g., feed, sidebar).
placement_idDimension
The unique identifier for the ad placement.
regionDimension
A geographical region targeted by the ad campaign.
scheduleDimension
The defined start and end times for the campaign's active period.
shopping_targeting.ad_group_idDimension
The unique identifier for the ad group to which the shopping targeting configuration applies. Ad groups are used to organize ads with shared targeting criteria and budgets.
shopping_targeting.conversion_event_typesDimension
A list of conversion event types (e.g., 'Purchase', 'Add to Cart') that this shopping targeting is configured to optimize for or measure.
shopping_targeting.excluded_conversion_event_typesDimension
A list of conversion event types that are explicitly excluded from being considered for optimization or measurement within this shopping targeting.
shopping_targeting.lookback_window_daysMetric
The number of days to look back for user actions when defining an audience for shopping ad targeting.
shopping_targeting.targeting_typeDimension
The specific type or strategy of shopping targeting implemented for the ad group, defining how the ads will reach relevant audiences (e.g., dynamic product ads, catalog sales).
skadnetwork_metadataDimension
Metadata related to SKAdNetwork settings and attribution for the ad, used for iOS app install campaigns.
special_ad_categoriesDimension
Indicates whether a campaign targets specific sensitive categories such as housing, employment, or credit. This setting impacts targeting options and cannot be modified after a campaign is published.
spendMetric
The total amount of money spent on advertising campaigns.
spend_USDMetric
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_capMetric
The maximum amount of money a campaign is allowed to spend over its entire lifetime.
startDateDimension
The start date for the campaign or ad group delivery.
startTimeDimension
The start time for the campaign or ad group delivery within a day.
start_timeDimension
The date and time when the entity (e.g., campaign, ad group) is scheduled to begin delivering.
targeting.carriersDimension
Mobile carriers targeted for ad delivery.
targeting.communitiesDimension
Reddit communities (subreddits) targeted for ad delivery.
targeting.custom_audience_idsDimension
Identifiers for custom audiences to be targeted.
targeting.devicesDimension
Device types (e.g., mobile, desktop) targeted for ad delivery.
targeting.excluded_communitiesDimension
Reddit communities (subreddits) explicitly excluded from targeting.
targeting.excluded_custom_audience_idsDimension
Identifiers for custom audiences explicitly excluded from targeting.
targeting.excluded_geolocationsDimension
Geographic locations explicitly excluded from targeting.
targeting.excluded_keywordsDimension
Keywords explicitly excluded from targeting.
targeting.expand_targetingDimension
Indicates whether automated targeting expansion is enabled, allowing Reddit to reach users beyond initial targeting selections.
targeting.genderDimension
Gender targeting preference for ad delivery.
targeting.geolocationsDimension
Geographic locations targeted for ad delivery.
targeting.interestsDimension
User interests targeted for ad delivery.
targeting.keywordsDimension
Keywords targeted for ad delivery, often based on user engagement with conversation threads.
targeting.languagesDimension
Languages of the users to be targeted for ad delivery.
targeting.locationsDimension
Geographic locations (e.g., countries, states, or cities) targeted for ad delivery.
targeting.platformsDimension
The platforms (e.g., iOS, Android, Desktop) where ads are displayed.
targeting.suppression_event_typesDimension
Event types used to suppress ad delivery to users who have completed these actions, preventing retargeting.
targeting.view_modesDimension
Specifies the contexts or placements where targeted ads can be displayed, influencing how users encounter the advertising content on Reddit.
use_catalogDimension
Specifies whether a campaign utilizes a product catalog. This field should be set to TRUE for campaigns with a 'SALES' objective, which then requires all associated ad groups to use a catalog.
video_completion_rateDimension
The percentage of video ads that were watched to 100% completion.
video_fully_viewable_impressionsMetric
The number of impressions where the video ad was 100% in view for at least two consecutive seconds.
video_plays_expandedMetric
The number of times a video ad was played in an expanded view.
video_plays_with_soundMetric
The number of times a video ad was played with sound enabled.
video_startedMetric
The number of times the video ad started playing.
video_view_rateMetric
The rate at which video ads were viewed, calculated as video plays divided by impressions.
video_view_rate_{NUM}_secondsMetric
The percentage of impressions that result in a video view of a specific duration (e.g., 3 seconds, 10 seconds).
video_viewable_impressionsMetric
The number of times your video ad was considered viewable by industry standards.
video_viewable_watched_{NUM}_secondsMetric
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}_percentMetric
The number of times a video ad was watched up to a specific percentage completion (e.g., 25%, 50%, 75%).
video_watched_{NUM}_secondsMetric
The number of times a video ad was watched for at least a specific duration in seconds.
view_through_conversion_typeDimension
The type of view-through conversion, indicating conversions that occurred after an impression but without a direct click.
viewable_impressionsMetric
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_commentsMetric
The total number of comments submitted by viewers in response to an advertisement or associated content.