Meta Ads metrics
Every metric you can request on Meta Ads through an AI assistant: 190 in total, 73 of them computed by the gateway, each with the API field it maps to.
190 rows
The 190 metrics you can request on Meta Ads. The key is what you pass to a tool; the field is what the platform returns.
conversion (87)Link to this section
| Key | Name | Field | Notes |
|---|---|---|---|
actions | All Actions | actions | Master array containing all action types attributed to your ads. Format: number. |
action_values | Action Values | action_values | Monetary value associated with each action type. Format: currency. |
conversions | Conversions | conversions | Tracked conversion events (purchases) from Meta Pixel, Conversions API, or App SDK. Format: number. |
conversion_ | Conversion Values | conversion_ | Total monetary value of all conversions (purchases). Format: currency. |
purchases | Purchases | actions | Website purchases tracked via Meta Pixel Purchase event. Format: number. |
purchase_value | Purchase Value | action_values | Total revenue from website purchases. Format: currency. |
omni_purchases | Omni Purchases | actions | All purchases across website, app, and offline channels. Format: number. |
omni_ | Omni Purchase Value | action_values | Total revenue from omnichannel purchases (website, app, offline). Format: currency. |
add_to_cart | Add to Cart | actions | Products added to shopping cart on your website. Format: number. |
add_ | Add to Cart Value | action_values | Total value of products added to cart. Format: currency. |
initiate_ | Initiate Checkout | actions | Users who began the checkout process. Format: number. |
initiate_ | Initiate Checkout Value | action_values | Total value of checkouts initiated. Format: currency. |
view_content | View Content | actions | Views of product/content pages on your website. Format: number. |
view_ | View Content Value | action_values | Total value of content views. Format: currency. |
add_payment_info | Add Payment Info | actions | Users who added payment details during checkout. Format: number. |
search | Search | actions | Searches performed on your website. Format: number. |
add_to_wishlist | Add to Wishlist | actions | Products saved to wishlist. Format: number. |
leads | Leads | actions | Website leads tracked via Meta Pixel on your website. Format: number. |
onsite_leads | On-Facebook Leads | actions | Leads from Facebook/Instagram lead forms completed without leaving the platform. Format: number. |
leadgen_grouped | Leadgen Grouped | actions | Combined leads from Messenger conversations and Instant Forms. Format: number. |
complete_ | Complete Registration | actions | Completed account registrations on your website. Format: number. |
contact | Contact | actions | Contact form submissions on your website. Format: number. |
schedule | Schedule | actions | Appointments scheduled on your website. Format: number. |
start_trial | Start Trial | actions | Free trial or demo registrations. Format: number. |
subscribe | Subscribe | actions | Recurring subscription signups. Format: number. |
messaging_ | Conversations Started | actions | New Messenger or Instagram Direct conversations started within 7 days. Format: number. |
messaging_ | First Reply | actions | Users who sent their first message in a conversation. Format: number. |
landing_ | Landing Page Views | actions | Number of times the landing page loaded after link click. Format: number. |
app_installs | App Installs | actions | Number of app installs attributed to your ads. Format: number. |
app_purchases | In-App Purchases | actions | Completed transactions within your mobile app. Format: number. |
app_ | In-App Purchase Value | action_values | Total revenue from in-app purchases tracked via App SDK. Format: currency. |
website_ | Website Purchases | actions | Purchases tracked via Meta Pixel/CAPI only (excludes in-app and shop). Format: number. |
website_ | Website Purchase Value | action_values | Revenue from website purchases only (Pixel/CAPI, excludes in-app and shop). Format: currency. |
purchase_roas | ROAS | purchase_roas | Return on ad spend. Revenue per dollar spent. ROAS of 3.0 = $3 revenue per $1 spent. Format: ratio. |
website_ | Website ROAS | website_ | ROAS from website purchases tracked via Pixel/CAPI only. Format: ratio. |
mobile_ | App ROAS | mobile_ | ROAS from mobile app purchases tracked via App SDK. Format: ratio. |
results | Results | results | Number of results based on your campaign objective. Format: number. |
result_rate | Result Rate | result_rate | Percentage of impressions that achieved your objective result. Format: percentage. |
clickToAtcRatio | Click to Add to Cart Ratio | computed here | Percentage of link clicks that resulted in add to cart. Landing page effectiveness. Calculated: (addToCart /. Format: percentage. |
atcToPurchaseRatio | Add to Cart to Purchase Ratio | computed here | Percentage of add to carts that converted to purchase. Checkout funnel efficiency. Calculated: (purchases /. Format: percentage. |
clickToPurchaseRatio | Click to Purchase Ratio | computed here | Percentage of link clicks that resulted in purchase. Overall conversion efficiency. Calculated: (purchases /. Format: percentage. |
aov | Average Order Value | computed here | Average Order Value. Average basket size calculated as purchase value / purchase count. Calculated: revenue /. Format: currency. |
find_location | Find Location | actions | Number of times users clicked to find a store location. Format: number. |
subscribe_value | Subscription Value | action_values | Total revenue from subscription signups. Format: currency. |
leads_value | Leads Value | action_values | Total monetary value of leads generated. Format: currency. |
start_ | Trial Started Value | action_values | Total value of trial subscriptions started. Format: currency. |
app_add_to_cart | App Add to Cart | actions | Products added to cart within your mobile app. Format: number. |
app_ | App Initiate Checkout | actions | Users who began checkout within your mobile app. Format: number. |
app_ | App Registration | actions | Completed account registrations within your mobile app. Format: number. |
achievement_ | Achievement Unlocked | actions | In-app achievements unlocked by users. Format: number. |
credit_spent | Credit Spent | actions | In-app credit spending events. Format: number. |
app_start_trial | App Trial Started | actions | Free trial starts within your mobile app. Format: number. |
app_subscribe | App Subscribe | actions | Subscription purchases within your mobile app. Format: number. |
shop_purchases | Shop Purchases | actions | Purchases completed within Facebook/Instagram Shops. Format: number. |
shop_ | Shop Purchase Value | action_values | Total revenue from Facebook/Instagram Shop purchases. Format: currency. |
purchaseValueShare | % Purchase Value | computed here | Percentage of total revenue represented by this row. Shows revenue contribution. Calculated from action_values. Format: percentage. |
subscriptionRoas | Subscription ROAS | computed here | Return on ad spend from subscription revenue only. Calculated: subscriptionValue /. Format: ratio. |
leadsRoas | Leads ROAS | computed here | Return on ad spend from lead value only. Calculated: leadsValue /. Format: ratio. |
purchasesPerMille | Purchases per 1K Impressions | computed here | Number of purchases for every 1,000 impressions. Direct conversion efficiency. Calculated: (purchases /. Format: number. |
revenuePerMille | Revenue per 1K Impressions | computed here | Revenue generated for every 1,000 impressions. Calculated: (purchaseValue /. Format: currency. |
installsPerMille | Installs per 1K Impressions | computed here | App installs for every 1,000 impressions. Calculated: (appInstalls /. Format: number. |
leadsPerMille | Leads per 1K Impressions | computed here | Leads generated for every 1,000 impressions. Calculated: (leads /. Format: number. |
impressionsToLeadsRatio | Impressions to Leads Ratio | computed here | Percentage of impressions that resulted in leads. Calculated: (leads /. Format: percentage. |
clickQuality | Click Quality | computed here | Conversion rate from clicks. Higher = better quality traffic. Calculated: (purchases /. Format: percentage. |
averageLeadsValue | Average Lead Value | computed here | Average monetary value per lead generated. Calculated: leadsValue /. Format: currency. |
clickToAppInstallRatio | Click to Install Ratio | computed here | Percentage of clicks that resulted in app installs. Calculated: (appInstalls /. Format: percentage. |
clickToLeadsRatio | Click to Leads Ratio | computed here | Percentage of clicks that resulted in leads. Calculated: (leads /. Format: percentage. |
clickToSubscriptionsRatio | Click to Subscription Ratio | computed here | Percentage of clicks that resulted in subscriptions. Calculated: (subscriptions /. Format: percentage. |
clickToRegistrationsRatio | Click to Registration Ratio | computed here | Percentage of clicks that resulted in completed registrations. Calculated: (registrations /. Format: percentage. |
clickToTrialStartedRatio | Click to Trial Ratio | computed here | Percentage of clicks that resulted in trial starts. Calculated: (trials /. Format: percentage. |
leadsToSubscriptionsRatio | Leads to Subscription Ratio | computed here | Percentage of leads that converted to subscriptions. Calculated: (subscriptions /. Format: percentage. |
clickToContactRatio | Click to Contact Ratio | computed here | Percentage of clicks that resulted in contact form submissions. Calculated: (contacts /. Format: percentage. |
clickToFindLocationRatio | Click to Find Location Ratio | computed here | Percentage of clicks that resulted in store locator searches. Calculated: (findLocations /. Format: percentage. |
clickToAppointmentsRatio | Click to Appointment Ratio | computed here | Percentage of clicks that resulted in scheduled appointments. Calculated: (appointments /. Format: percentage. |
clickToInitiateCheckoutRatio | Click to Checkout Ratio | computed here | Percentage of clicks that resulted in checkout initiations. Calculated: (initiateCheckout /. Format: percentage. |
clickToWebsitePurchaseRatio | Click to Website Purchase Ratio | computed here | Percentage of clicks that resulted in website purchases. Calculated: (purchases /. Format: percentage. |
installToTrialRate | Install to Trial Rate | computed here | Percentage of app installs that started a trial. Calculated: (appTrials /. Format: percentage. |
installToPurchaseRatio | Install to Purchase Ratio | computed here | Percentage of app installs that made a purchase. Calculated: (appPurchases /. Format: percentage. |
installToRegistrationRate | Install to Registration Rate | computed here | Percentage of app installs that completed registration. Calculated: (appRegistrations /. Format: percentage. |
registrationToAchievementRate | Registration to Achievement Rate | computed here | Percentage of registrations that unlocked an achievement. Calculated: (achievements /. Format: percentage. |
achievementToPurchaseRate | Achievement to Purchase Rate | computed here | Percentage of achievement unlocks that resulted in purchase. Calculated: (appPurchases /. Format: percentage. |
viewContentRatio | View Content Ratio | computed here | Percentage of impressions that resulted in content views. Calculated: (viewContent /. Format: percentage. |
viewContentToAtcRatio | View Content to Add to Cart Ratio | computed here | Percentage of content views that resulted in add to cart. Calculated: (addToCart /. Format: percentage. |
checkoutToPurchaseRatio | Checkout to Purchase Ratio | computed here | Percentage of checkout initiations that completed purchase. Calculated: (purchases /. Format: percentage. |
aovWebsite | Average Order Value (Website) | computed here | Average order value from website purchases only. Calculated: purchaseValue /. Format: currency. |
aovShop | Average Order Value (Shop) | computed here | Average order value from Facebook/Instagram Shop purchases. Calculated: shopPurchaseValue /. Format: currency. |
aovApp | Average Order Value (In-App) | computed here | Average order value from mobile app purchases. Calculated from actions, action_values. Format: currency. |
video (32)Link to this section
| Key | Name | Field | Notes |
|---|---|---|---|
video_plays | Video Plays | video_ | Number of times video playback started. Includes both auto-play and click-to-play. Format: number. |
video_views_3s | 3-Second Video Views | actions | Standard video view metric - plays of 3+ seconds or 97% of video if shorter. Format: number. |
video_views_10s | 10-Second Video Views | video_ | DEPRECATED - Videos watched for at least 10 seconds. Use ThruPlay instead. Format: number. |
video_views_15s | 15-Second Video Views | video_ | DEPRECATED - Videos watched for at least 15 seconds. Use ThruPlay instead. Format: number. |
video_views_30s | 30-Second Video Views | video_ | Videos watched for at least 30 seconds, or nearly total length if shorter. Industry standard for meaningful engagement. Format: number. |
video_p25 | 25% Video Completion | video_ | Videos watched to 25% of total length. First milestone for retention analysis. Format: number. |
video_p50 | 50% Video Completion | video_ | Videos watched to 50% of length. Shows sustained attention. Format: number. |
video_p75 | 75% Video Completion | video_ | Videos watched to 75% of length. Strong engagement indicator. Format: number. |
video_p95 | 95% Video Completion | video_ | Videos watched to 95% of length. Almost complete views. Format: number. |
video_p100 | 100% Video Completion | video_ | Videos watched to 100%. Your most engaged viewers. Format: number. |
thruplay | ThruPlay | video_ | Complete views OR 15+ seconds for videos over 15 seconds. Meta's standard video completion metric. Format: number. |
video_ | Average Watch Time | video_ | Average time in seconds viewers spent watching your video. Format: duration. |
video_ | Total Watch Time | video_ | Cumulative watch time in seconds across all viewers. Format: duration. |
hookRate | Hook Rate | computed here | Percentage of impressions that resulted in 3-second video views. Measures if the first 3 seconds grab attention. Calculated: (videoViews /. Format: percentage. |
thumbstopRate | Thumbstop Rate | computed here | Percentage of impressions that resulted in video plays. How many people stopped scrolling to watch. Calculated: (videoPlays /. Format: percentage. |
holdRate | Hold Rate | computed here | Percentage of impressions that resulted in a ThruPlay. Overall video engagement. Calculated: (video_. Format: percentage. |
completionRate | Completion Rate | computed here | Percentage of 25% viewers who watched to 100%. Full video watch-through rate. Calculated: (video_. Format: percentage. |
video15sTo3sRetention | 15s/3s Video Retention | computed here | Percentage of 3-second viewers who continued to 15 seconds. Calculated: (video15s /. Format: percentage. |
thruplayCtr | ThruPlay Rate | computed here | Percentage of impressions that resulted in a ThruPlay (15+ seconds or complete view). Measures video engagement quality. Calculated: (thruPlay /. Format: percentage. |
firstFrameRetention | First Frame Retention | computed here | Percentage of impressions where video started playing. Same as thumbstop rate. Calculated: (videoPlays /. Format: percentage. |
thumbstopClickRate | Thumbstop Click Rate | computed here | Percentage of video plays that resulted in link clicks. Calculated: (linkClicks /. Format: percentage. |
videoP25Rate | 25% Video View Rate | computed here | Percentage of impressions that resulted in 25% video completion. Calculated: (video_. Format: percentage. |
videoP50Rate | 50% Video View Rate | computed here | Percentage of impressions that resulted in 50% video completion. Calculated: (video_. Format: percentage. |
videoP75Rate | 75% Video View Rate | computed here | Percentage of impressions that resulted in 75% video completion. Calculated: (video_. Format: percentage. |
videoP95Rate | 95% Video View Rate | computed here | Percentage of impressions that resulted in 95% video completion. Calculated: (video_. Format: percentage. |
videoP100Rate | 100% Video View Rate | computed here | Percentage of impressions that resulted in complete video views. Calculated: (video_. Format: percentage. |
dropOffP25ToP50 | Drop-off 25% to 50% | computed here | Percentage of viewers lost between 25% and 50% mark. Calculated: (1 - video_. Format: percentage. |
dropOffP50ToP75 | Drop-off 50% to 75% | computed here | Percentage of viewers lost between 50% and 75% mark. Calculated: (1 - video_. Format: percentage. |
dropOffP75ToP95 | Drop-off 75% to 95% | computed here | Percentage of viewers lost between 75% and 95% mark. Calculated: (1 - video_. Format: percentage. |
dropOffP75ToP100 | Drop-off 75% to 100% | computed here | Percentage of viewers lost between 75% mark and completion. Calculated: (1 - video_. Format: percentage. |
dropOffP95ToP100 | Drop-off 95% to 100% | computed here | Percentage of viewers lost between 95% mark and completion. Calculated: (1 - video_. Format: percentage. |
sustainRate | Sustain Rate | computed here | Percentage of viewers who watched 25% that continued to 95%. Measures sustained attention. Calculated: (thruPlay /. Format: percentage. |
cost (27)Link to this section
| Key | Name | Field | Notes |
|---|---|---|---|
spend | Spend | spend | Total amount spent. The actual budget consumed by your ads. Format: currency. |
cpc | CPC | cpc | Cost per click. Average cost for each click on your ad. Format: currency. |
cpm | CPM | cpm | Cost per 1,000 impressions. How much you pay for every thousand ad displays. Format: currency. |
cpp | Cost per Person | cpp | DEPRECATED: Cost per 1,000 people reached. Removed from UI, the metric name was confusing. Format: currency. |
cost_ | Cost per Link Click | cost_ | Average cost for each click on links within your ad. Format: currency. |
cost_ | Cost per Unique Click | cost_ | Average cost to acquire each unique person who clicked. Format: currency. |
cost_ | Cost per Unique Link Click | cost_ | Average cost per unique person clicking your links. Format: currency. |
cost_ | Cost per Outbound Click | cost_ | Average cost for clicks leading users off Meta platforms. Format: currency. |
cost_ | Cost per Engagement | cost_ | Average cost for each engagement action on your ad. Format: currency. |
cost_ | Cost per ThruPlay | cost_ | Average cost for each ThruPlay (complete view or 15+ seconds). Format: currency. |
social_spend | Social Spend | social_spend | Amount spent on impressions that included social proof. Format: currency. |
cost_ | Cost per Action | cost_ | Average cost for each specific action type. Format: currency. |
cost_ | Cost per Conversion | cost_ | Average cost to generate each tracked conversion (purchase). Format: currency. |
cost_per_result | Cost per Result | cost_per_result | Average cost for each result based on your objective. Format: currency. |
cost_ | Cost per Ad Recaller | cost_ | How much you paid for each person estimated to remember your ad. Format: currency. |
costPerAtc | Cost per Add to Cart | computed here | DEPRECATED: Duplicate of cost_per_add_to_cart. Use cost_per_add_to_cart instead. Calculated: spend /. Format: currency. |
cost_ | Cost per Page Like | computed here | Average cost to acquire each new Page like/follow. Calculated as spend / page_likes. Calculated: spend /. Format: currency. |
cost_ | Cost per Conversation | computed here | Average cost per messaging conversation started. Calculated as spend / conversations. Calculated: spend /. Format: currency. |
cost_per_lead | Cost per Lead | computed here | Average cost to generate each lead. Calculated as spend / leads. Calculated: spend / leads. Format: currency. |
cost_ | Cost per Purchase | computed here | Average cost to generate each purchase. Calculated as spend / purchases. Calculated: spend /. Format: currency. |
cost_ | Cost per Add to Cart | computed here | Average cost for each add to cart action. Calculated as spend / add_to_cart. Calculated: spend /. Format: currency. |
cost_ | Cost per Checkout | computed here | Average cost for each checkout initiation. Calculated as spend / checkouts. Calculated: spend /. Format: currency. |
cost_ | Cost per Install | computed here | Average cost to generate each app install. Calculated as spend / installs. Calculated: spend /. Format: currency. |
cost_ | Cost per Landing Page View | computed here | Average cost for each landing page view. Calculated as spend / landing_page_views. Calculated: spend /. Format: currency. |
cost_ | Cost per 3s Video View | computed here | Average cost for each 3-second video view. Calculated as spend / video_views_3s. Calculated: spend /. Format: currency. |
spendShare | % Spend | computed here | Percentage of total spend represented by this row. Useful for budget allocation analysis. Calculated: (outboundClicks /. Format: percentage. |
costPerMinuteViewed | Cost per Minute Viewed | computed here | Average cost for each minute of video watched. Calculated as spend / (total_watch_time / 60). Calculated: spend /. Format: currency. |
delivery (27)Link to this section
| Key | Name | Field | Notes |
|---|---|---|---|
impressions | Impressions | impressions | Total ad displays. The number of times your ad was shown on screen. Format: number. |
reach | Reach | reach | Unique people reached. The number of unique individuals who saw your ad at least once. Format: number. |
frequency | Frequency | frequency | Average impressions per person. Calculated as impressions / reach. Format: ratio. |
social_reach | Social Reach | social_reach | DEPRECATED (Aug 2024): Number of unique people who saw your ad with social information. Format: number. |
social_ | Social Impressions | social_ | DEPRECATED (Aug 2024): Total impressions that included social context like friends' interactions. Format: number. |
full_ | Full View Impressions | full_ | Number of times users saw your entire ad content. Format: number. |
full_view_reach | Full View Reach | full_view_reach | Unique individuals who saw your entire ad content. Format: number. |
clicks | Total Clicks | clicks | All click interactions on your ad including link clicks, profile clicks, and expansions. Format: number. |
unique_clicks | Unique Clicks | unique_clicks | Number of distinct individuals who clicked on your ad at least once. Format: number. |
inline_ | Inline Link Clicks | inline_ | Clicks specifically on links embedded in your ad (CTA button, display URL, etc.). Format: number. |
unique_ | Unique Link Clicks | unique_ | Number of distinct people who clicked on links within your ad. Format: number. |
outbound_clicks | Outbound Clicks | outbound_clicks | Clicks that navigate users away from Meta platforms to external websites or apps. Format: number. |
unique_ | Unique Outbound Clicks | unique_ | Number of distinct people who clicked to leave Meta platforms. Format: number. |
social_clicks | Social Clicks | social_clicks | DEPRECATED (Aug 2024): Clicks that occurred when social proof was displayed. Format: number. |
instant_ | Instant Experience Open Clicks | instant_ | DEPRECATED: Number of clicks that opened your Instant Experience. Format: number. |
instant_ | Instant Experience Start Clicks | instant_ | DEPRECATED: Number of interactions that initiated Instant Experience content. Format: number. |
ctr | CTR | ctr | Click-through rate. Percentage of impressions that resulted in any click. Format: percentage. |
unique_ctr | Unique CTR | unique_ctr | Percentage of people reached who clicked at least once. Format: percentage. |
inline_ | Link CTR | inline_ | Percentage of impressions that resulted in link clicks. Format: percentage. |
unique_ | Unique Link CTR | unique_ | Percentage of people reached who clicked on links. Format: percentage. |
outbound_ | Outbound CTR | outbound_ | Percentage of impressions resulting in clicks to external destinations. Format: percentage. |
link_clicks | Link Clicks | actions | Clicks on the main destination link of your ad. Format: number. |
quality_ranking | Quality Ranking | quality_ranking | How your ad's perceived quality compared to competing ads. Format: number. |
engagement_ | Engagement Ranking | engagement_ | Your ad's expected engagement rate compared to competitors. Format: number. |
conversion_ | Conversion Ranking | conversion_ | Expected conversion rate compared to competitors with same optimization goal. Format: number. |
estimated_ | Ad Recall Rate | estimated_ | Estimated percentage of people who would remember seeing your ad if asked within 2 days. Format: percentage. |
estimated_ | Estimated Ad Recallers | estimated_ | Estimated number of people who would recall seeing your ad. Format: number. |
engagement (17)Link to this section
| Key | Name | Field | Notes |
|---|---|---|---|
inline_ | Post Engagement | inline_ | Sum of all engagement actions: reactions, comments, shares, saves, photo views, video plays. Format: number. |
post_engagement | Post Engagement (Action) | actions | All interactions with your ad post: reactions, comments, shares, clicks. Format: number. |
page_engagement | Page Engagement | actions | All interactions with your Page from the ad: page likes, post engagements, check-ins. Format: number. |
post_reactions | Post Reactions | actions | Total reactions (like, love, wow, haha, sad, angry) on your ad. Format: number. |
comments | Comments | actions | Number of comments left on your ad. Format: number. |
shares | Shares | actions | Number of times your ad was shared. Format: number. |
saves | Saves | actions | Number of times users saved your ad for later. Format: number. |
page_likes | Page Likes | actions | Number of people who liked/followed your Page from the ad. Format: number. |
photo_views | Photo Views | actions | Number of times photos in your ad were viewed in enlarged format. Format: number. |
canvas_ | Instant Experience View Percent | canvas_ | DEPRECATED: Average percentage of Instant Experience content users scrolled through. Format: percentage. |
canvas_ | Instant Experience View Time | canvas_ | DEPRECATED: Mean duration in seconds users spent inside your Instant Experience. Format: duration. |
engagementRate | Engagement Rate | computed here | Percentage of impressions that resulted in any engagement. Content resonance. Calculated: (engagements /. Format: percentage. |
likeRate | Like Rate | computed here | Percentage of impressions that resulted in post reactions (likes, love, etc.). Calculated: (postReactions /. Format: percentage. |
commentRate | Comment Rate | computed here | Percentage of impressions that resulted in comments. Calculated: (comments /. Format: percentage. |
postShareRatio | Post Share Ratio (PSR) | computed here | Percentage of impressions that resulted in shares. Viral potential indicator. Calculated: (shares /. Format: percentage. |
postEngagementsExclVideo | Engagements (exc. Video) | computed here | Post engagements excluding video plays. Pure social engagement. Calculated: Math.. Format: number. |
postEngagementRateExclVideo | Engagement Rate (exc. Video) | computed here | Engagement rate excluding video plays from engagement count. Calculated: (Math.. Format: percentage. |