Fields Reference · Reddit Ads
Reddit Ads Fields List
155 fields · 60 dimensions · 95 metrics · 11 groups
| Field name | Label | Category | Description |
|---|---|---|---|
reddit_ads_ad_account_admin_approval | Ad Account Admin Approval | Account | Employee-set state for the ad account (VALID, SUSPENDED, PENDING, etc.). |
reddit_ads_ad_account_attribution_type | Ad Account Attribution Type | Account | Attribution type used for ECPA metrics (ALL_CONVERSION, CLICK_THROUGH, VIEW_THROUGH). |
reddit_ads_ad_account_business_id | Business ID | Account | Identifier of the business that owns this ad account. |
reddit_ads_ad_account_click_attribution_window | Click Attribution Window | Account | Window used when querying click-through attribution (DAY, WEEK, MONTH). |
reddit_ads_ad_account_currency | Ad Account Currency | Account | ISO 4217 currency code billing the ad account (e.g. USD, EUR). |
reddit_ads_ad_account_id | Ad Account ID | Account | Unique identifier of the Reddit Ads ad account. |
reddit_ads_ad_account_name | Ad Account Name | Account | Human-readable name of the Reddit Ads ad account. |
reddit_ads_ad_account_time_zone | Ad Account Time Zone | Account | IANA time zone configured on the ad account (used for reporting defaults). |
reddit_ads_ad_account_type | Ad Account Type | Account | Type of ad account (MANAGED or SELF_SERVE). |
reddit_ads_ad_account_view_attribution_window | View Attribution Window | Account | Window used when querying view-through attribution (DAY, WEEK, MONTH). |
reddit_ads_currency | Currency | Account | ISO 4217 currency code reported alongside the metrics. |
reddit_ads_ad_click_url | Ad Click URL | Ad | URL users are directed to when they click the ad. |
reddit_ads_ad_create_time | Ad Create Time | Ad | Timestamp when the ad was created. |
reddit_ads_ad_effective_status | Ad Effective Status | Ad | Effective delivery status of the ad (e.g. ACTIVE, PAUSED). |
reddit_ads_ad_effective_status_enriched | Ad Status | Ad | System-calculated ad status from the Ads endpoint (current at query time). |
reddit_ads_ad_id | Ad ID | Ad | Unique identifier of the ad creative. |
reddit_ads_ad_name | Ad Name | Ad | Human-readable name of the ad creative. |
reddit_ads_ad_post_url | Ad Post URL | Ad | URL of the Reddit post backing the ad. |
reddit_ads_ad_update_time | Ad Update Time | Ad | Timestamp when the ad was last updated. |
reddit_ads_carousel_card | Carousel Card | Ad | Carousel card the impression was served on. |
reddit_ads_gallery_item_id | Gallery Item ID | Ad | Identifier of the gallery item the impression was served on. |
reddit_ads_post_id | Post ID | Ad | Identifier of the underlying Reddit post used as the ad creative. |
reddit_ads_ad_group_bid_type | Ad Group Bid Type | Ad group | Bidding strategy type for the ad group (CPC, CPM, CPV, CPV6). |
reddit_ads_ad_group_bid_value | Ad Group Bid Value | Ad group | Bid amount per event for the ad group in the ad account currency. |
reddit_ads_ad_group_campaign_objective_type | Ad Group Campaign Objective | Ad group | Parent campaign objective denormalized onto the ad group. |
reddit_ads_ad_group_configured_status | Ad Group Configured Status | Ad group | Status configured by the user on the ad group (ACTIVE, PAUSED, ARCHIVED, DELETED). |
reddit_ads_ad_group_effective_status | Ad Group Effective Status | Ad group | System-calculated real status of the ad group. |
reddit_ads_ad_group_end_time | Ad Group End Time | Ad group | Timestamp when the ad group is scheduled to stop delivering. |
reddit_ads_ad_group_id | Ad Group ID | Ad group | Unique identifier of the ad group. |
reddit_ads_ad_group_name | Ad Group Name | Ad group | Human-readable name of the ad group. |
reddit_ads_ad_group_start_time | Ad Group Start Time | Ad group | Timestamp when the ad group is scheduled to begin delivering. |
reddit_ads_adgroup_create_time | Ad Group Create Time | Ad group | Timestamp when the ad group was created. |
reddit_ads_adgroup_update_time | Ad Group Update Time | Ad group | Timestamp when the ad group was last updated. |
reddit_ads_priority | Priority | Ad group | Priority of the ad group. |
reddit_ads_app_install_install_count | App Installs | App installs | Number of mobile app installs attributed to the ads. |
reddit_ads_app_install_install_cvr | App Install CVR | App installs | Conversion rate from clicks to mobile app installs. |
reddit_ads_app_install_install_ecpa | App Install eCPA | App installs | Effective cost per mobile app install in the ad account currency. |
reddit_ads_app_install_purchase_count | App Install Purchases | App installs | Number of in-app purchases attributed to the ads. |
reddit_ads_app_install_purchase_cvr | App Install Purchase CVR | App installs | Conversion rate from clicks to in-app purchases. |
reddit_ads_app_install_purchase_ecpa | App Install Purchase eCPA | App installs | Effective cost per in-app purchase in the ad account currency. |
reddit_ads_app_install_revenue | App Install Revenue | App installs | Revenue generated by in-app purchases attributed to the ads. |
reddit_ads_app_install_roas_double | App Install ROAS | App installs | Return on ad spend for app install conversions. |
reddit_ads_app_install_total_conversions | App Install Total Conversions | App installs | Total app install conversions across all event types. |
reddit_ads_community | Community | Audience & placement | Reddit community (subreddit) the impression was served in. |
reddit_ads_gender | Gender | Audience & placement | Gender of the audience the impression was served to. |
reddit_ads_interest | Interest | Audience & placement | Interest segment of the audience. |
reddit_ads_keyword | Keyword | Audience & placement | Keyword targeted by the campaign. |
reddit_ads_os_type | OS Type | Audience & placement | Operating system of the device the ad was shown on. |
reddit_ads_placement | Placement | Audience & placement | Placement where the ad was shown (e.g. feed, conversation). |
reddit_ads_subreddit | Subreddit | Audience & placement | Subreddit name where the impression was served. |
reddit_ads_bid_strategy | Bid Strategy | Campaign | Bidding strategy in use for the campaign. |
reddit_ads_campaign_bid_strategy | Campaign Bid Strategy | Campaign | Bid strategy for CBO campaigns (BIDLESS, MAXIMIZE_VOLUME, TARGET_CPX). |
reddit_ads_campaign_bid_type | Campaign Bid Type | Campaign | Bid type for CBO campaigns (CPC, CPM, CPV6). |
reddit_ads_campaign_bid_value | Campaign Bid Value | Campaign | Campaign bid value in the ad account currency (CBO campaigns only). |
reddit_ads_campaign_configured_status | Campaign Configured Status | Campaign | Status configured by the user on the campaign (ACTIVE, PAUSED, ARCHIVED, DELETED). |
reddit_ads_campaign_create_time | Campaign Create Time | Campaign | Timestamp when the campaign was created. |
reddit_ads_campaign_effective_status | Campaign Effective Status | Campaign | System-calculated real status of the campaign (e.g. ACTIVE, PENDING_APPROVAL, PAUSED). |
reddit_ads_campaign_end_time | Campaign End Time | Campaign | Timestamp when the campaign is scheduled to stop delivering. |
reddit_ads_campaign_goal_type | Campaign Goal Type | Campaign | Budget goal type for campaign budget optimization (LIFETIME_SPEND or DAILY_SPEND). |
reddit_ads_campaign_goal_value | Campaign Goal Value | Campaign | Campaign goal value (budget) in the ad account currency. |
reddit_ads_campaign_id | Campaign ID | Campaign | Unique identifier of the campaign. |
reddit_ads_campaign_name | Campaign Name | Campaign | Human-readable name of the campaign. |
reddit_ads_campaign_objective | Campaign Objective | Campaign | Campaign objective (CLICKS, CONVERSIONS, IMPRESSIONS, APP_INSTALLS, LEAD_GENERATION, etc.). |
reddit_ads_campaign_start_time | Campaign Start Time | Campaign | Timestamp when the campaign is scheduled to begin delivering. |
reddit_ads_campaign_update_time | Campaign Update Time | Campaign | Timestamp when the campaign was last updated. |
reddit_ads_conversion_add_to_cart_avg_value | Add To Cart Average Value | Conversions | Average value of an add-to-cart conversion. |
reddit_ads_conversion_add_to_cart_clicks | Add To Cart Clicks | Conversions | Click-attributed add-to-cart conversions. |
reddit_ads_conversion_add_to_cart_ecpa | Add To Cart eCPA | Conversions | Effective cost per add-to-cart conversion in the ad account currency. |
reddit_ads_conversion_add_to_cart_total_items | Add To Cart Total Items | Conversions | Total number of items added to cart. |
reddit_ads_conversion_add_to_cart_total_value | Add To Cart Total Value | Conversions | Total reported value of all add-to-cart conversions. |
reddit_ads_conversion_add_to_cart_views | Add To Cart Views | Conversions | View-attributed add-to-cart conversions. |
reddit_ads_conversion_add_to_wishlist_avg_value | Add To Wishlist Average Value | Conversions | Average value of an add-to-wishlist conversion. |
reddit_ads_conversion_add_to_wishlist_clicks | Add To Wishlist Clicks | Conversions | Click-attributed add-to-wishlist conversions. |
reddit_ads_conversion_add_to_wishlist_ecpa | Add To Wishlist eCPA | Conversions | Effective cost per add-to-wishlist conversion in the ad account currency. |
reddit_ads_conversion_add_to_wishlist_total_items | Add To Wishlist Total Items | Conversions | Total number of items added to wishlist. |
reddit_ads_conversion_add_to_wishlist_total_value | Add To Wishlist Total Value | Conversions | Total reported value of all add-to-wishlist conversions. |
reddit_ads_conversion_add_to_wishlist_views | Add To Wishlist Views | Conversions | View-attributed add-to-wishlist conversions. |
reddit_ads_conversion_custom_avg_value | Custom Conversion Average Value | Conversions | Average value of a custom conversion. |
reddit_ads_conversion_custom_clicks | Custom Conversion Clicks | Conversions | Click-attributed custom conversions. |
reddit_ads_conversion_custom_ecpa | Custom Conversion eCPA | Conversions | Effective cost per custom conversion in the ad account currency. |
reddit_ads_conversion_custom_total_items | Custom Conversion Total Items | Conversions | Total number of items in custom conversions. |
reddit_ads_conversion_custom_total_value | Custom Conversion Total Value | Conversions | Total reported value of all custom conversions. |
reddit_ads_conversion_custom_views | Custom Conversion Views | Conversions | View-attributed custom conversions. |
reddit_ads_conversion_lead_avg_value | Lead Average Value | Conversions | Average value of a lead conversion. |
reddit_ads_conversion_lead_clicks | Lead Clicks | Conversions | Click-attributed lead conversions. |
reddit_ads_conversion_lead_ecpa | Lead eCPA | Conversions | Effective cost per lead conversion in the ad account currency. |
reddit_ads_conversion_lead_total_value | Lead Total Value | Conversions | Total reported value of all lead conversions. |
reddit_ads_conversion_lead_views | Lead Views | Conversions | View-attributed lead conversions. |
reddit_ads_conversion_page_visit_clicks | Page Visit Clicks | Conversions | Click-attributed page visit conversions. |
reddit_ads_conversion_page_visit_ecpa | Page Visit eCPA | Conversions | Effective cost per page visit conversion in the ad account currency. |
reddit_ads_conversion_page_visit_views | Page Visit Views | Conversions | View-attributed page visit conversions. |
reddit_ads_conversion_purchase_avg_value | Purchase Average Value | Conversions | Average value of a purchase conversion. |
reddit_ads_conversion_purchase_clicks | Purchase Clicks | Conversions | Click-attributed purchase conversions. |
reddit_ads_conversion_purchase_ecpa | Purchase eCPA | Conversions | Effective cost per purchase in the ad account currency. |
reddit_ads_conversion_purchase_total_items | Purchase Total Items | Conversions | Total number of items in purchase conversions. |
reddit_ads_conversion_purchase_total_value | Purchase Total Value | Conversions | Total reported value of all purchase conversions. |
reddit_ads_conversion_purchase_views | Purchase Views | Conversions | View-attributed purchase conversions. |
reddit_ads_conversion_roas | Conversion ROAS | Conversions | Return on ad spend across all conversion events. |
reddit_ads_conversion_search_clicks | Search Clicks | Conversions | Click-attributed search conversions. |
reddit_ads_conversion_search_ecpa | Search eCPA | Conversions | Effective cost per search conversion in the ad account currency. |
reddit_ads_conversion_search_views | Search Views | Conversions | View-attributed search conversions. |
reddit_ads_conversion_sign_up_clicks | Sign-Up Clicks | Conversions | Click-attributed sign-up conversions. |
reddit_ads_conversion_sign_up_ecpa | Sign-Up eCPA | Conversions | Effective cost per sign-up conversion in the ad account currency. |
reddit_ads_conversion_sign_up_views | Sign-Up Views | Conversions | View-attributed sign-up conversions. |
reddit_ads_conversion_signup_avg_value | Sign-Up Average Value | Conversions | Average value of a sign-up conversion. |
reddit_ads_conversion_signup_total_value | Sign-Up Total Value | Conversions | Total reported value of all sign-up conversions. |
reddit_ads_conversion_view_content_clicks | View Content Clicks | Conversions | Click-attributed view-content conversions. |
reddit_ads_conversion_view_content_ecpa | View Content eCPA | Conversions | Effective cost per view-content conversion in the ad account currency. |
reddit_ads_conversion_view_content_views | View Content Views | Conversions | View-attributed view-content conversions. |
reddit_ads_key_conversion_clicks | Key Conversion Clicks | Conversions | Click-attributed conversions for the configured key conversion event. |
reddit_ads_key_conversion_ecpa | Cost Per Result | Conversions | Effective cost per key conversion in the ad account currency. |
reddit_ads_key_conversion_rate | Key Conversion Rate | Conversions | Rate of key conversion events per click. |
reddit_ads_key_conversion_total_count | Total Results | Conversions | Total conversions (clicks + views) for the configured key conversion event. |
reddit_ads_key_conversion_views | Key Conversion Views | Conversions | View-attributed conversions for the configured key conversion event. |
reddit_ads_reddit_leads | Reddit Leads | Conversions | Number of leads captured directly from the ad on Reddit. |
reddit_ads_clicks | Clicks | Delivery | Number of times users clicked on the ad. |
reddit_ads_cpc | CPC | Delivery | Average cost per click in the ad account currency. |
reddit_ads_ctr | CTR | Delivery | Click-through rate: clicks divided by impressions. |
reddit_ads_ecpm | eCPM | Delivery | Effective cost per thousand impressions in the ad account currency. |
reddit_ads_engaged_click | Engaged Clicks | Delivery | Number of clicks that resulted in an engagement. |
reddit_ads_frequency | Frequency | Delivery | Average number of times each user saw the ad. |
reddit_ads_impressions | Impressions | Delivery | Number of times the ad was rendered on a user's screen. |
reddit_ads_reach | Reach | Delivery | Estimated number of unique users that saw the ad. |
reddit_ads_spend | Spend | Delivery | Total amount spent on this set of ads in the ad account currency. |
reddit_ads_country | Country | Geography | Country the impression was served in. |
reddit_ads_dma | DMA | Geography | Designated market area where the impression was served. |
reddit_ads_metro | Metro | Geography | Metropolitan area where the impression was served. |
reddit_ads_region | Region | Geography | Region (state or province) the impression was served in. |
reddit_ads_date | Date | Time | Calendar date the metrics apply to. |
reddit_ads_datetime | Datetime | Time | ISO 8601 datetime the metrics apply to. |
reddit_ads_hour | Hour | Time | Hour of the day the metrics apply to (0-23). |
reddit_ads_cost_per_15_second_view | Cost Per 15s View | Video | Average cost per 15-second video view in the ad account currency. |
reddit_ads_cost_per_3_second_view | Cost Per 3s View | Video | Average cost per 3-second video view in the ad account currency. |
reddit_ads_cost_per_6_second_view | Cost Per 6s View | Video | Average cost per 6-second video view in the ad account currency. |
reddit_ads_cost_per_completed_view | Cost Per Completed View | Video | Average cost per completed video view in the ad account currency. |
reddit_ads_cpv | CPV | Video | Average cost per video view in the ad account currency. |
reddit_ads_video_completion_rate | Video Completion Rate | Video | Percentage of video views that played to completion. |
reddit_ads_video_fully_viewable_impressions | Video Fully Viewable Impressions | Video | Impressions where the video was fully viewable on screen. |
reddit_ads_video_plays_expanded | Video Plays Expanded | Video | Number of times the video was expanded to full size. |
reddit_ads_video_plays_with_sound | Video Plays With Sound | Video | Number of video plays where audio was unmuted. |
reddit_ads_video_started | Video Starts | Video | Number of times the video creative started playing. |
reddit_ads_video_view_rate | Video View Rate | Video | Percentage of impressions that resulted in a video view. |
reddit_ads_video_view_rate_15_seconds | Video View Rate (15s) | Video | Percentage of impressions resulting in a 15-second video view. |
reddit_ads_video_view_rate_6_seconds | Video View Rate (6s) | Video | Percentage of impressions resulting in a 6-second video view. |
reddit_ads_video_viewable_impressions | Video Viewable Impressions | Video | Impressions where the video was at least partially viewable. |
reddit_ads_video_viewable_watched_15_seconds | Video Viewable Watched 15s | Video | Number of viewable video views that lasted at least 15 seconds. |
reddit_ads_video_viewable_watched_6_seconds | Video Viewable Watched 6s | Video | Number of viewable video views that lasted at least 6 seconds. |
reddit_ads_video_watched_100_percent | Video Watched 100% | Video | Number of video views that played to completion. |
reddit_ads_video_watched_10_seconds | Video Watched 10s | Video | Number of video views that lasted at least 10 seconds. |
reddit_ads_video_watched_25_percent | Video Watched 25% | Video | Number of video views that reached 25% of the video length. |
reddit_ads_video_watched_3_seconds | Video Watched 3s | Video | Number of video views that lasted at least 3 seconds. |
reddit_ads_video_watched_50_percent | Video Watched 50% | Video | Number of video views that reached 50% of the video length. |
reddit_ads_video_watched_5_seconds | Video Watched 5s | Video | Number of video views that lasted at least 5 seconds. |
reddit_ads_video_watched_75_percent | Video Watched 75% | Video | Number of video views that reached 75% of the video length. |
reddit_ads_video_watched_95_percent | Video Watched 95% | Video | Number of video views that reached 95% of the video length. |