Facebook Ads Dimensions & Metrics: Complete Reference 2026

Understanding the full landscape of Facebook Ads dimensions and metrics is essential for anyone running paid campaigns on Meta platforms. Whether you're building custom dashboards, pulling data through the Marketing API, or simply trying to make sense of Ads Manager reports, knowing exactly what data is available — and what each field means — is the foundation of effective campaign optimization.

This guide provides a complete reference of every dimension and metric available in Facebook Ads as of 2026. We've organized them by category, included the API field names for developers and analysts, and added practical context on when and how to use each one. We also cover recent deprecations and changes that affect how you access and interpret your data.

What Are Facebook Ads Dimensions vs Metrics?

Before diving into the full reference, it's important to understand the difference between dimensions and metrics — two concepts that are often confused but serve fundamentally different purposes in advertising data.

Dimensions are descriptive attributes that define what you're looking at. They are the labels, categories, and identifiers that let you organize and filter your data. Examples include campaign name, ad set ID, targeting age range, publisher platform, and country. Dimensions answer the question: "How do I want to slice this data?"

Metrics are quantitative measurements that tell you how things performed. They are the numbers: impressions, clicks, spend, conversions, CTR, CPC. Metrics answer the question: "What happened with my ads?"

Breakdowns are a special type of dimension that you can apply across any metric to segment performance. For example, you can break down your conversion metrics by age group, country, placement, or device to identify which segments drive the best results.

How Is Facebook Ads Data Structured?

Facebook Ads data follows a strict hierarchy: Account > Campaign > Ad Set > Ad. Each level inherits configuration from above and adds its own settings. Campaigns define the objective and buying type. Ad sets control targeting, budget, schedule, and optimization. Ads contain the creative and tracking links. Metrics can be queried at any level — ad-level metrics roll up to ad set, campaign, and account totals.

The Meta Marketing API returns dimensions as object fields and metrics through the Insights API endpoint. Most metrics are available at all levels, while some dimensions are level-specific (e.g., targeting parameters only exist at the ad set level). The actions and action_values fields are arrays that break down into dozens of action types — from purchases and leads to video views and page likes.

Campaign-Level Dimensions

Campaign-level dimensions define the top-level structure of your advertising. These fields identify the campaign and its core configuration — objective, buying type, budget strategy, and status. Use these dimensions to organize reporting by campaign and understand the strategic setup behind your results.

Ad Set-Level Dimensions

Ad set dimensions control who sees your ads, where they appear, when they run, and how they're optimized. This is the most configuration-heavy level in the Facebook Ads hierarchy, covering targeting, placement, scheduling, bidding, and optimization settings.

Ad-Level Dimensions

Ad-level dimensions describe the individual ad unit — its identity, creative content, format, and status. These are critical for creative analysis, identifying which ad variations drive performance, and managing the creative lifecycle.

Creative Asset Dimensions

These dimensions describe the actual creative content within your ads — images, videos, copy, links, and format-specific elements like carousel cards. Essential for creative analysis and identifying which assets drive the best performance.

Core Performance Metrics

These are the fundamental metrics that measure how your ads are delivered and interacted with. Every Facebook advertiser should understand these — they form the basis of all campaign analysis and optimization decisions.

Conversion and Action Metrics

Conversion metrics measure the business outcomes driven by your ads — purchases, leads, registrations, and other valuable actions. These are sourced from Meta Pixel events, Conversions API (CAPI), app SDK events, offline event uploads, and on-Facebook conversions. All action metrics are returned through the actions and action_values arrays, broken down by action_type.

Standard Conversion Events

Cross-Channel and Specialized Conversion Metrics

Video Metrics

Video metrics measure how users engage with your video ad content. From initial plays through completion rates, these metrics help you understand which parts of your video capture attention and where viewers drop off. Essential for optimizing video hooks, length, and creative strategy.

Engagement Metrics

Engagement metrics measure how people interact with your ad content beyond clicking — reactions, comments, shares, saves, page likes, messaging, and event responses. High engagement signals ad relevance and can improve delivery costs through better quality scores.

Reach, Frequency, and Brand Metrics

These metrics measure the breadth and intensity of your ad exposure, plus brand-level outcomes like estimated ad recall. Critical for awareness campaigns, frequency management, and understanding the balance between reach and repetition.

Ad Relevance and Quality Rankings

These diagnostic dimensions evaluate how your ad compares to competitors targeting the same audience. Higher rankings correlate with lower costs and better delivery. They replaced the old single relevance score in March 2019 with three separate, more actionable dimensions.

How to interpret rankings: ABOVE_AVERAGE means your ad is in the top tier. AVERAGE puts you in the middle. BELOW_AVERAGE_35 means you're in the bottom 35% — which is still acceptable. BELOW_AVERAGE_20 (bottom 20%) and BELOW_AVERAGE_10 (bottom 10%) signal serious issues that need fixing. Rankings only appear after approximately 500 impressions.

Breakdown Dimensions (Segmentation)

Breakdowns are cross-cutting dimensions you can apply to any metric to segment your data. They answer questions like "Which age group converts best?", "Which placement has the lowest CPC?", or "What time of day gets the most engagement?" Some breakdowns have restrictions — notably, reach cannot be combined with breakdowns for data older than 13 months (since June 2025).

Demographic Breakdowns

Delivery Breakdowns

Action Breakdowns

Creative Asset Breakdowns

Instant Experience (Canvas) Metrics

These metrics apply to Instant Experience ads (formerly Canvas) — full-screen interactive experiences that open within the Facebook or Instagram app.

How to Use These Metrics for Campaign Optimization

Having access to 250+ metrics is powerful, but knowing which ones matter for your specific goals is what separates effective analysts from data-overwhelmed marketers. Here's a practical framework for selecting the right metrics at each stage.

For awareness campaigns

Focus on reach, frequency, CPM, CPP, and estimated ad recall lift. Monitor frequency to prevent ad fatigue — generally keep it below 3-4 for cold audiences. Use the frequency value breakdown to see how many people have seen your ad 1x, 2x, 3x, etc.

For traffic campaigns

Prioritize outbound clicks (not clicks all), outbound CTR, cost per outbound click, and landing page views. The ratio of landing page views to link clicks reveals your page load rate — if it's below 70%, your landing page is too slow.

For conversion campaigns

Track purchase ROAS, cost per purchase, add-to-cart rate, initiate checkout rate, and conversion value. Use the conversion funnel metrics (view content → add to cart → initiate checkout → purchase) to identify where drop-offs occur. Break down by conversion_destination to see which channels drive the most value.

For video campaigns

Use hook rate (3-second views ÷ impressions) to test opening hooks. Track ThruPlay rate for genuine engagement. Analyze the video play curve to identify exact drop-off points. The ratio of 25%/50%/75%/100% completion tells you where attention declines — if 50% is dramatically lower than 25%, your middle section needs work.

For creative optimization

Compare quality ranking, engagement rate ranking, and conversion rate ranking across ads to identify winners. Use the creative asset breakdowns (body_asset, title_asset, image_asset) to determine which variations of flexible creative perform best. Track inline post engagement and post saves as secondary signals of ad quality.

What Changed in 2024-2026: Deprecations and Updates

Meta has made significant changes to its reporting metrics over the past two years. Understanding these changes is critical for anyone working with historical data or migrating dashboards.

October 2024: Unique action metrics mass deprecation

Meta removed over 100 unique_actions and cost_per_unique_action_type metrics. Only four action types survived for unique counting: link_click, messaging_first_reply, messaging_connection, and outbound_click. All other unique action types (unique purchases, unique leads, unique add-to-carts, etc.) now return errors if queried.

January 2026: Attribution window changes

The 7-day view and 28-day view attribution windows were deprecated and no longer return data. Remaining supported windows are: 1d_click, 7d_click, 28d_click, 1d_view, and 1d_engaged_view. If your dashboards relied on 7-day view attribution, you need to update them to use the 1-day view window instead.

June 2025: Reach with breakdowns restriction

The reach metric can no longer be returned when using breakdowns (age, gender, country, placement, etc.) with historical data exceeding 13 months. For data within 13 months, reach with breakdowns still works normally.

New additions in 2025

New metrics include instagram_profile_visits for tracking profile visits post-ad interaction, and the is_adset_budget_sharing campaign flag for the new budget sharing feature that allows up to 20% budget redistribution between ad sets. The CREDIT special ad category was replaced by FINANCIAL_PRODUCTS_SERVICES in January 2025.

Common Mistakes When Analyzing Facebook Ads Data

Even experienced marketers make these mistakes when working with Facebook Ads metrics. Avoiding them will save you from flawed analyses and bad optimization decisions.

1. Using clicks (all) instead of link clicks

Clicks (all) includes every interaction — likes, comments, shares, image expansions, profile clicks — not just clicks to your website. When measuring traffic intent, always use link clicks or outbound clicks. The difference can be 2-5x, leading to massively inflated click counts.

2. Summing reach across time periods

Reach is a deduplicated metric — the same person seeing your ad in January and February counts as 1 person for the year but 1 person in each month. Summing monthly reach numbers will overcount your actual audience. Always query reach for the full period you want to measure.

3. Comparing 3-second views to ThruPlay

A 3-second video view only requires 3 seconds of aggregate watch time (can include scrolling past and back). ThruPlay requires 15+ continuous seconds or full completion. They measure fundamentally different levels of engagement — comparing them directly is misleading.

4. Ignoring the attribution window

The same campaign can show 50 conversions with 7-day click attribution and 80 conversions with 28-day click. Always check which attribution_setting applies to your data. When comparing campaigns, ensure they use the same attribution window.

5. Overlooking modeled conversions

With iOS 14+ privacy changes, a significant portion of conversions are estimated (modeled) rather than directly observed. The is_conversion_id_modeled breakdown tells you how much of your conversion data is modeled vs. observed. Don't treat modeled conversions with the same confidence as pixel-observed ones.

6. Averaging ROAS across ad sets

ROAS is a ratio. Averaging ROAS across ad sets gives mathematically incorrect results. Instead, sum the total conversion value and total spend, then calculate ROAS from the totals: Total Conversion Value ÷ Total Spend.