Metrics
Meta Ads metrics via API
Your customer connects their Meta Ads account and your product queries 346 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "fb_ads:cpc",
"component": "number_v1",
"metrics": [
"cpc"
]
}
]
}More Meta Ads request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Impressions and reach by age
This graph shows the impressions and reach of your ads grouped by the age of the person who saw them
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb_ads:impressions_reach_by_age",
"component": "chart_v1",
"metrics": [
"impressions",
"reach"
],
"dimensions": [
{
"field": "age"
}
]
}
]
}Table
Featured Ads
Your ads in the specified time period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb_ads:ads",
"component": "datatable_v1",
"metrics": [
"results",
"cost_per_results",
"spend",
"reach",
"impressions",
"ctr",
"cpc",
"cpm",
"frequency"
],
"dimensions": [
{
"field": "ad"
}
]
}
]
}Number
Total Reach
Total number of people who saw your ad at least once during the selected review period. This metric is estimated.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "fb_ads:reach",
"component": "number_v1",
"metrics": [
"reach"
]
}
]
}Numbers
323 metrics
Total Average CPC
Cost per Click (CPC) shows how much, on average, each click costs you. It is calculated by dividing Spent Amount/Number of Clicks. CPC is a metric used in the online advertising industry for benchmarking ad efficiency and performance.
fb_ads:cpcTotal Reach
Total number of people who saw your ad at least once during the selected review period. This metric is estimated.
fb_ads:reachReach on Facebook
Reach of your Ads, taking in consideration the Ads served on Facebook
fb_ads:reach_facebookReach on Messenger
Reach of your Ads, taking in consideration the Ads served on Messenger
fb_ads:reach_messengerReach on Audience Networks
Reach of your Ads, taking in consideration the Ads served on Audience Networks
fb_ads:reach_audience_networkReach on Instagram
Reach of your Ads, taking in consideration the Ads served on Instagram
fb_ads:reach_instagramTotal Impressions
The number of times your ads were on screen of your target audience.
fb_ads:impressionsImpressions on Facebook
Number of impressions on your Ads, taking in consideration the Ads served on Facebook
fb_ads:impressions_facebookImpressions on Messenger
Number of impressions on your Ads, taking in consideration the Ads served on Messenger
fb_ads:impressions_messengerImpressions on Audience Networks
Number of impressions on your Ads, taking in consideration the Ads served on Audience Networks
fb_ads:impressions_audience_networkImpressions on Instagram
Number of impressions on your Ads, taking in consideration the Ads served on Instagram
fb_ads:impressions_instagramTotal Clicks
Total number of clicks on your ad. This metric considers any types of clicks. Clicks on the link, image, reactions to publication, comments, shares, among others.
fb_ads:clicksClicks on Facebook
The number of clicks on your ads, taking in consideration the Ads served on Facebook
fb_ads:clicks_facebookClicks on Instagram
The number of clicks on your ads, taking in consideration the Ads served on Instagram
fb_ads:clicks_instagramCTR (All)
Total click-trough rate (CTR) indicates how many times people clicked on your ad compared to the number of times they viewed it. It is a common digital advertising metric to understand how ads drive traffic to websites and other destinations.
fb_ads:ctrCTR (All) on Facebook
Indicates how many times people clicked on your ad compared to the number of times they viewed it. Taking into account the ads served on Facebook, Messenger and Audience Networks platforms.
fb_ads:ctr_facebookCTR (All) on Instagram
Indicates how many times people clicked on your ad compared to the number of times they viewed it. Taking into account the ads served on Instagram.
fb_ads:ctr_instagramFrequency
The average number of times each person saw your ad.
fb_ads:frequencyFrequency on Facebook
The average number of times each person saw your ad, taking in consideration the Ads served on the Facebook, Messenger and Audience Network platforms
fb_ads:frequency_facebookFrequency on Instagram
The average number of times each person saw your ad, taking in consideration the Ads served on Instagram
fb_ads:frequency_instagramAmount spent
The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule.
fb_ads:spendAmount invested in Audience Network
Total amount invested in Audience Network during the analyzed period. The Audience Network takes Facebook's people-based advertising beyond the Facebook platform.
fb_ads:spend_audience_networkAmount invested in Messenger
Total amount invested in Messenger during the analyzed period.
fb_ads:spend_messengerAmount Spent on Facebook
The estimated total amount of money you've spent on your campaign, taking in consideration the Ads served on Facebook
fb_ads:spend_facebookAmount Spent on Instagram
The estimated total amount of money you've spent on your campaign, taking in consideration the Ads served on Instagram
fb_ads:spend_instagramCPC on Facebook
Cost per click (CPC) shows how much, on average, each click costs you. Taking into account the ads served on Facebook, Messenger and Audience Networks platforms.
fb_ads:cpc_facebookCPC on Instagram
Cost Per Click (CPC) shows how much, on average, each click costs you. Taking into account the ads served on Instagram.
fb_ads:cpc_instagramAverage CPM
Cost Per Mille (CPM) is the average price of 1000 impressions. It's calculated by dividing Amount Invested/Number of Impressions x 1000. CPM is a common metric in online advertising to indicate the cost-effectiveness of an ad campaign. It's often used to compare performance between different campaigns.
fb_ads:cpmCost per Reach
The average cost to reach one person with your ads, calculated by dividing the total amount spent by the total reach.
fb_ads:cost_per_reachAverage CPM on Facebook
Cost Per Thousand (CPM) is the average price of 1000 impressions. It is calculated by dividing the Invested Value / Number of Impressions x 1000. Taking into account the ads served on the Facebook, Messenger and Audience Networks platforms
fb_ads:cpm_facebookAverage CPM on Instagram
Cost Per Thousand (CPM) is the average price of 1000 impressions. It is calculated by dividing the Invested Value / Number of Impressions x 1000. Taking into account the ads served on Instagram.
fb_ads:cpm_instagramTotal clicks on the link
Total number of clicks on links within the ad that led to specified destinations, on or off Facebook.
fb_ads:inline_link_clicksInstagram Link Clicks
Number of clicks on links within the Instagram ad that led to specified destinations, whether on or off Instagram.
fb_ads:instagram_link_clicksFacebook Link Clicks
Number of clicks on links within the Facebook ad that led to specified destinations, whether on or off Facebook.
fb_ads:facebook_link_clicksCTR (Link click rate)
CTR indicates how many link clicks your ad received compared to how many impressions it received. It's a common metric used by online advertisers to understand how ads drive traffic to websites and other destinations.
fb_ads:inline_link_click_ctrCTR (Link click rate) on Instagram
CTR indicates how many link clicks your ad received compared to how many impressions it received on Instagram.
fb_ads:inline_link_click_ctr_instagramCTR (Link click rate) on Facebook
CTR indicates how many link clicks your ad received compared to how many impressions it received on Facebook.
fb_ads:inline_link_click_ctr_facebookAverage CPC
Cost Per Click (CPC) shows how much, on average, each click on the link costs you. It is calculated by dividing the amount invested / number of clicks on the link. CPC is a metric used in the online advertising industry to measure the efficiency and performance of ads.
fb_ads:cost_per_inline_link_clickAds count
Number of page ads published by the page.
fb_ads:count_adsCampaigns count
Number of page campaigns published by the page.
fb_ads:count_campaignsPage Engagement
The total number of actions that people took on your Facebook Page and its posts, attributed to your ads. Page engagement can include actions such as liking your Page, loving a post, checking in to your location, clicking a link and more.
fb_ads:actions_page_engagementPost Engagement
The total number of actions that people take involving your ads. Post engagements can include actions such as reacting to, commenting on or sharing the ad, claiming an offer, viewing a photo or video, or clicking on a link.
fb_ads:actions_post_engagementPost Engagement on Facebook
Total number of actions people took involving your Facebook ads. It can include actions like reactions, comments, shares, photo views, link clicks, or getting the offer.
fb_ads:actions_post_engagement_facebookPost Engagement on Instagram
Total number of actions people took involving your Instagram ads. It can include actions like reactions, comments, shares, photo views, link clicks, or getting the offer.
fb_ads:actions_post_engagement_instagramComments
Post comments metric counts all the comments people made to your ads while they were running.
fb_ads:actions_comment3-Second Video Plays
The number of times your video played for at least 3 seconds, or for nearly its total length if it's shorter than 3 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video.
fb_ads:actions_video_viewPhoto views
The number of views of the photos on your Page or posts that are attributed to your ads. Photo views are counted when people click on photos to view them.
fb_ads:actions_photo_viewLanding Page Views
The number of times a person clicked on an ad link and then successfully loaded the destination webpage or Instant Experience. To report on landing page views, you must have created a Facebook pixel. You can compare landing page views to link clicks to understand how many people clicked on your ad but left before your website or Instant Experience loaded.
fb_ads:actions_landing_page_viewTotal Leads
The number of leads attributed to your ads from all Meta technologies (including forms, Instagram and Messenger) plus non-Meta leads tracked by one or more of your connected Meta Business Tools.
fb_ads:actions_leadTotal Contacts
The number of contact events attributed to your ads, in the analysis period.
fb_ads:actions_contactsWebsite Contacts
The number of website contact events attributed to your ads, in the analysis period.
fb_ads:actions_contacts_websiteApp Contacts
The number of mobile apps contact events attributed to your ads, in the analysis period.
fb_ads:actions_contacts_mobile_appActions View Content
The number of view content events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_view_contentOffline Contacts
The number of offline contact events attributed to your ads, in the analysis period.
fb_ads:actions_contacts_offlineReactions to publication
The Post Likes Metric is now called Post Reactions. It measures the amount of reactions in your boosted ads or publications. The reactions button in an ad allows people to share different reactions to the content: Like, Loved, Haha, Wow, Sad or Grr.
fb_ads:actions_post_reactionFacebook Page likes
The number of likes on your Facebook Page attributed to your ads during the analysis period.
fb_ads:actions_likePosts Shares
The number of shares of your ads. People can share your ads or posts on their own or friends' Timelines, in groups and on their own Pages. The metric counts shares of your ads while they were running. It may also include Instagram shares sent to people's inboxes. It doesn't count engagement with the post after it's shared on another person's or Page's timeline.
fb_ads:actions_postCheck-ins
The number of check-ins to your Facebook Page that are attributed to your ads. If your Page has a physical address associated with it, people can check in to your Page when they update their status in their Facebook News Feed or Timeline.
fb_ads:actions_checkinAdds to Cart
The number of add to cart events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_omni_add_to_cartSearches
The number of search events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_omni_searchRegistrations Completed
The number of complete registration events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_omni_complete_registrationCost per Completed Registration
.
fb_ads:cost_per_actions_omni_complete_registrationPurchases
The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set). This metric also counts purchases that occurred on a Facebook-owned property (such as Marketplace, Instagram Shopping or during checkout from ads) and are attributed to your ads.
fb_ads:actions_omni_purchaseInstagram Purchases
The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set). This metric also counts purchases that occurred on a Facebook-owned property (such as Marketplace, Instagram Shopping or during checkout from ads) and are attributed to your ads.
fb_ads:actions_instagram_purchaseTotal Engagement Rate
Percentage of total interaction with your ads, taking into account the total reach. The calculation is performed by dividing the page engagement by the total reach.
fb_ads:engagement_page_rateInstagram Engagement Rate
Percentage of interaction with your ads displayed on Instagram, taking into account the reach on Instagram. The calculation is performed by dividing the page engagement by the reach on Instagram.
fb_ads:engagement_page_rate_instagramFacebook Engagement Rate
Percentage of interaction with your ads displayed on Facebook, taking into account the reach on Facebook. The calculation is performed by dividing the page engagement by the reach on Facebook.
fb_ads:engagement_page_rate_facebookFacebook Purchases
The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set). This metric also counts purchases that occurred on a Facebook-owned property (such as Marketplace, Instagram Shopping or during checkout from ads) and are attributed to your ads.
fb_ads:actions_facebook_purchaseTrials Started
The start of a free trial of a product or service you offer. For example, trial subscription.
fb_ads:actions_start_trial_totalOffline Add To Cart
The number of add to cart events that were recorded by your offline events data and attributed to your ads. If you are uploading offline data to Facebook (through the offline event manager or API), and you've chosen to report on this offline event, this metric counts when the event is reported and attributed to your ads.
fb_ads:actions_onsite_conversion.fb_pixel_add_to_cartMessaging conversations started
The number of times people started messaging your business after at least 7 days of inactivity, attributed to your ads. Conversations with people who have never sent a message to your company are counted, as well as reengagement conversations. The metric includes the number of times two-way messaging conversations started in messaging apps (including Facebook Messenger, Instagram Direct and WhatsApp Business), either when people clicked your ad in a messaging app or when they clicked a button in your ad on another Facebook-owned platform (such as Facebook News Feed) to send a message to your business.
fb_ads:actions_onsite_conversion.messaging_conversation_started_7dMessaging conversations started (Instagram)
The number of times people started messaging your business after at least 7 days of inactivity, attributed to your ads. Conversations with people who have never messaged your business are counted, as well as re-engagement conversations. The metric includes the number of times two-way message conversations were initiated on Instagram Direct. This could be when people clicked on the ad in a messaging app or when they clicked a button on an ad on another Facebook platform (such as Facebook News Feed) to send your business a message.
fb_ads:actions_onsite_conversion.messaging_conversation_started_7d_instagramMessaging conversations started (Facebook)
The number of times people started messaging your business after at least 7 days of inactivity, attributed to your ads. Conversations with people who have never messaged your business are counted, as well as re-engagement conversations. The metric includes the number of times two-way message conversations were initiated on Facebook Messenger. This could be when people clicked on the ad in a messaging app or when they clicked a button on an ad on another Facebook platform (such as Facebook News Feed) to send your business a message.
fb_ads:actions_onsite_conversion.messaging_conversation_started_7d_facebookPost saves
The total number of times your ad has been saved. Includes all the times you saved your ads while they're running on Facebook.
fb_ads:actions_onsite_conversion.post_saveWebsite leads
The number of lead events tracked by the pixel or the Conversions API on your website and attributed to your ads.
fb_ads:actions_offsite_conversion.fb_pixel_leadWebsite Adds to Cart
The number of add to cart events tracked by the pixel or Conversions API on your website and attributed to your ads. If you have an add to cart standard event implemented on your website, this metric counts when the Facebook pixel or Conversions API tracks that event, attributed to your ads.
fb_ads:actions_offsite_conversion.fb_pixel_add_to_cartWebsite Searches
The number of search events tracked by the pixel or Conversions API on your website and attributed to your ads. If you have a search standard event implemented on your website, this metric counts when the Facebook pixel or Conversions API tracks that event, attributed to your ads.
fb_ads:actions_offsite_conversion.fb_pixel_searchAdds of Payment Info
The number of add payment info events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_offsite_conversion.fb_pixel_add_payment_infoCheckouts Initiated
The number of initiate checkout events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_omni_initiated_checkoutCost per purchase
The estimated average cost of each purchase. The metric is calculated by dividing the total amount spent by the amount of purchases.
fb_ads:actions_cost_per_purchaseCost per 3-Second Video Plays
The average cost for each 3-second video play. This metric is calculated as total amount spent, divided by 3-second video plays.
fb_ads:actions_cost_per_video_viewCosts per add to cart
The average cost for each cart addition found to your ads, based on information received from one or more of your Facebook Tools for Connected Businesses (such as a Facebook pixel, a Conversions API, the app SDK, or a set of offline events). This metric is constructed as the amount spent divided by the cart add events.
fb_ads:actions_cost_per_omni_add_to_cartAdd to cart Conversion Value
The total value of adds to cart tracked with the sales objective.
fb_ads:actions_conversion_value_omni_add_to_cartCost per website adds to cart
The average cost for each addition to the cart on the site (conversion tracking pixel). This metric is calculated as the total amount spent divided by cart add events (conversion tracking pixel).
fb_ads:actions_cost_per_onsite_conversion.fb_pixel_add_to_cartCost per offline add to cart
The average cost for each addition to your cart that was logged by your offline event data and called to your ads. This metric is constructed as the amount spent divided by the offline cart addition events.
fb_ads:actions_cost_per_offsite_conversion.fb_pixel_add_to_cartCost per landing page view
The average cost of each landing page view. This metric is calculated as the total amount spent divided by the landing page views.
fb_ads:actions_cost_per_landing_page_viewCost per lead
The average cost of each lead attributed to your ads through Facebook properties as well as off-Facebook leads tracked by one or more of your connected Facebook Business Tools (such as a Facebook pixel, Conversions API, app SDK or offline event set).
fb_ads:actions_cost_per_leadCost per website lead
The average cost of each lead on the website. The metric is dividing the total spend by the number of website leads.
fb_ads:actions_cost_per_offsite_conversion.fb_pixel_leadCost per adds of payment info
The estimated average cost of each inclusion of payment information assigned to your ads, based on information received from one or more of your Facebook Tools for Connected Businesses (such as a Facebook pixel, the Conversions API, the app SDK, or a set of offline events). The metric is calculated as the total amount spent divided by the payment information inclusions.
fb_ads:actions_cost_per_offsite_conversion.fb_pixel_add_payment_infoCost per website purchase
The estimated average cost of each purchase on your site (purchases tracked by pixel or the Conversions API on your site and attributed to your ads). The metric is calculated by dividing the total amount spent by the amount of purchases on the site.
fb_ads:actions_cost_per_offsite_conversion.fb_pixel_purchaseWebsite Purchase
The number of purchase events tracked by the pixel or Conversions API on your website and attributed to your ads. If you have a purchase standard event implemented on your website, this metric counts when the Facebook pixel or Conversions API tracks that event, attributed to your ads.
fb_ads:actions_offsite_conversion.fb_pixel_purchaseCost per Initiates Checkout
The average cost of each checkout initiated. The average cost of each checkout initiated. This metric is calculated as the total amount spent during the selected time period, divided by checkouts initiated that occurred within the same time period.
fb_ads:actions_cost_per_omni_initiated_checkoutCheckout Initiated Conversion Value
The total value of initiated checkouts tracked with the sales objective
fb_ads:actions_conversion_omni_initiated_checkoutVideos 25% watched
The number of times your video was played at 25% of its length, including plays that skipped to this point.
fb_ads:video_p25_watchedCost per videos 25% watched
The average cost per play of 25% of the video. It takes into account the number of times your video has been played up to 25% of its duration, including plays where the viewer skipped ahead to that point.
fb_ads:cost_per_video_p25_watchedVideo plays
The number of times your video starts to play. This is counted for each impression of a video, and excludes replays.
fb_ads:video_play_actionsVideos 50% watched
The number of times your video was played at 50% of its length, including plays that skipped to this point.
fb_ads:video_p50_watchedCost per videos 50% watched
The average cost per play of 50% of the video. It takes into account the number of times your video has been played up to 50% of its duration, including plays where the viewer skipped ahead to that point.
fb_ads:cost_per_video_p50_watchedVideos 75% watched
The number of times your video was played at 75% of its length, including plays that skipped to this point.
fb_ads:video_p75_watchedCost per videos 75% watched
The average cost per play of 75% of the video. It takes into account the number of times your video has been played up to 75% of its duration, including plays where the viewer skipped ahead to that point.
fb_ads:cost_per_video_p75_watchedVideos 95% watched
The number of times your video was played at 95% of its length, including plays that skipped to this point.
fb_ads:video_p95_watchedVideo average play time
The average time a video was played in seconds, including any time spent replaying the video for a single impression.
fb_ads:video_avg_time_watchedCost per videos 95% watched
The average cost per play of 95% of the video. It takes into account the number of times your video has been played up to 95% of its duration, including plays where the viewer skipped ahead to that point.
fb_ads:cost_per_video_p95_watchedThruplays
Number of times your video played to the end or for at least 15 seconds. If your video is 15 seconds or less, the metric will consider how many times your video played to the end. For longer videos, this metric will count times someone played at least 15 seconds of the video.
fb_ads:thruplaysCost per Thruplay
The average cost of each ThruPlay. The metric is calculated by dividing the total amount spent by ThruPlays.
fb_ads:cost_per_thruplaysCost per Contacts Total
Cost per Contact shows how much, on average, each contact costs you. It is calculated by dividing Spent Amount/Number of Contacts.
fb_ads:cost_per_contacts_totalCurrent balance (postpaid)
Amount already spent on this postpaid ad account that Meta has not charged yet, which is the amount of the next charge. Prepaid accounts show a notice pointing to Available funds (prepaid balance). Shown without taxes by default, as in Ads Manager. Turn on 'Show with taxes' to add the taxes Meta charges in the country of the account's business, as in Billing & payments; when that country's tax is not known, the value stays without taxes. Only available at the ad account level.
fb_ads:current_account_balanceAvailable funds (prepaid balance)
Funds still available to spend on this prepaid ad account. Postpaid accounts show a notice pointing to Current balance (postpaid). Shown by default with the taxes Meta charges in the country of the account's business, as in Billing & payments; turn off 'Show with taxes' to see it as in Ads Manager. When that country's tax is not known, the value is shown without taxes. Only available at the ad account level.
fb_ads:available_account_balanceWebsite Purchase ROAS
The total return on ad spend (ROAS) from website purchases. This is based on the value of all conversions recorded by the Facebook pixel on your website and attributed to your ads.
fb_ads:website_roasWebsite Purchase ROAS Instagram
Instagram website purchase ROAS is a metric that evaluates the return on advertising investment specific to ads run on the Instagram platform. It measures the value of website purchase conversions attributed to Instagram ads, divided by the total advertising spend on Instagram.
fb_ads:website_roas_instagramWebsite Purchase ROAS Facebook
Facebook website purchase ROAS is a metric that assesses the return on advertising investment for ads run on the Facebook platform. It measures the value of website purchase conversions attributed to Facebook ads, calculated as the conversion value of website purchases divided by the total advertising spend on Facebook.
fb_ads:website_roas_facebookPurchase ROAS
The total return on ad spend (ROAS) from purchases. This is based on information received from one or more of your connected Facebook Business Tools and attributed to your ads.
fb_ads:purchase_roasPurchase ROAS Instagram
Instagram purchase ROAS is a metric that evaluates the return on advertising investment specific to ads run on the Instagram platform. It measures the value of website purchase conversions attributed to Instagram ads, divided by the total advertising spend on Instagram.
fb_ads:roas_instagramPurchase ROAS Facebook
Facebook purchase ROAS is a metric that assesses the return on advertising investment for ads run on the Facebook platform. It measures the value of website purchase conversions attributed to Facebook ads, calculated as the conversion value of website purchases divided by the total advertising spend on Facebook.
fb_ads:roas_facebookPurchase Conversion Value
The total value of purchases tracked with the conversions objective. In some cases, this metric may be estimated.
fb_ads:purchase_conversion_valueAverage Ticket
The average value per purchase, calculated by dividing the total purchase conversion value by the number of purchases.
fb_ads:average_ticketWebsite Purchase Conversion Value
The total value of website purchases tracked with the conversions objective. In some cases, this metric may be estimated.
fb_ads:website_purchase_conversion_valueTotal Subscription Conversion Value
The total value of all subscription conversions attributed to your ads, combining website, mobile app, and offline sources.
fb_ads:subscribe_total_conversion_valueWebsite Subscription Conversion Value
The total value of website subscription conversions attributed to your ads, tracked through the Meta pixel.
fb_ads:subscribe_website_conversion_valueMobile App Subscription Conversion Value
The total value of mobile app subscription conversions attributed to your ads.
fb_ads:subscribe_mobile_app_conversion_valueOffline Subscription Conversion Value
The total value of offline subscription conversions attributed to your ads, based on offline event data.
fb_ads:subscribe_offline_conversion_valueCost per Website Contacts
The number of website contact events attributed to your ads, in the analysis period.
fb_ads:spend_contacts_websiteCost for conversations initiated per message
This metric represents the cost of each of the conversations initiated per message. Message-initiated conversations are the number of times people started messaging your business after at least 7 days of inactivity, attributed to your ads.
fb_ads:spend-actions_onsite_conversion.messaging_conversation_started_7dCost for conversations initiated per message by campaigns
This metric represents the cost of each message-initiated conversation. In conversations initiated by message, the number of times people started sending messages to your business after at least 7 days of inactivity, attributed to your ads, is considered. For the calculation of this metric, only the amounts spent on campaigns that had some value for the metric of conversations initiated by message are considered.
fb_ads:spend-actions_onsite_conversion.messaging_conversation_started_7d_campaignsMeta leads
The number of leads submitted via Meta technologies (including forms and Messenger) and attributed to your ads.
fb_ads:facebook_leadsCost per Meta leads
The cost per number of leads submitted on Facebook properties attributed to your ads.
fb_ads:facebook_leads_costMobile App Feature Unlocks
The number of times users have unlocked specific features or achievements within your mobile app. This metric measures user engagement with your app's features and gamification elements.
fb_ads:actions_app_custom_event.fb_mobile_achievement_unlockedCost per Mobile App Feature Unlocks
The average cost per Mobile App Feature Unlocks. This metric measures the efficiency of your spend, divided by Mobile App Feature Unlocks.
fb_ads:spend_app_custom_event.fb_mobile_achievement_unlockedMobile application activations
The number of times your app has been activated attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_app_custom_event.fb_mobile_activate_appCost per Mobile App Starts
The average cost per Mobile App Starts. This metric measures the efficiency of your spend, divided by Mobile App Starts.
fb_ads:spend_app_custom_event.fb_mobile_activate_appMobile App Payment Details
The number of times users have added their payment information within your mobile app. This metric helps you track user progress toward making in-app purchases.
fb_ads:actions_app_custom_event.fb_mobile_add_payment_infoCost per Mobile App Payment Details
The average cost per Mobile App Payment Details. This metric measures the efficiency of your spend, divided by Mobile App Payment Details.
fb_ads:spend_app_custom_event.fb_mobile_add_payment_infoMobile App Adds To Cart
The number of times users have added products or items to their shopping carts within your mobile app. This metric indicates user interest in making a purchase.
fb_ads:actions_app_custom_event.fb_mobile_add_to_cartCost per Mobile App Adds To Cart
The average cost per Mobile App Adds To Cart. This metric measures the efficiency of your spend, divided by Mobile App Adds To Cart.
fb_ads:spend_app_custom_event.fb_mobile_add_to_cartMobile App Adds to Wishlist
The number of times users have added products or items to their wishlists within your mobile app. This metric reflects products that have piqued user interest for future consideration.
fb_ads:actions_app_custom_event.fb_mobile_add_to_wishlistCost per Mobile App Adds to Wishlist
The average cost per Mobile App Adds to Wishlist. This metric measures the efficiency of your spend, divided by Mobile App Adds to Wishlist.
fb_ads:spend_app_custom_event.fb_mobile_add_to_wishlistMobile App Registrations
The number of times users have completed the registration process within your mobile app. This metric represents user sign-ups and account creations.
fb_ads:actions_app_custom_event.fb_mobile_complete_registrationCost per Mobile App Registrations
The average cost per Mobile App Registrations. This metric measures the efficiency of your spend, divided by Mobile App Registrations.
fb_ads:spend_app_custom_event.fb_mobile_complete_registrationMobile App Content Views
The number of times users have viewed content, such as articles, images, or videos, within your mobile app. This metric measures user engagement with your app's content.
fb_ads:actions_app_custom_event.fb_mobile_content_viewCost per Mobile App Content Views
The average cost per Mobile App Content Views. This metric measures the efficiency of your spend, divided by Mobile App Content Views.
fb_ads:spend_app_custom_event.fb_mobile_content_viewMobile App Checkouts
The number of times users have initiated the checkout process within your mobile app, indicating their intent to make a purchase. This metric is a key step in the conversion funnel.
fb_ads:actions_app_custom_event.fb_mobile_initiated_checkoutCost per Mobile App Checkouts
The average cost per Mobile App Checkouts. This metric measures the efficiency of your spend, divided by Mobile App Checkouts.
fb_ads:spend_app_custom_event.fb_mobile_initiated_checkoutMobile App Achievements
The number of times users have achieved specific levels or milestones within your mobile app. This metric reflects user progress and engagement with your app.
fb_ads:actions_app_custom_event.fb_mobile_level_achievedCost per Mobile App Achievements
The average cost per Mobile App Achievements. This metric measures the efficiency of your spend, divided by Mobile App Achievements.
fb_ads:spend_app_custom_event.fb_mobile_level_achievedMobile App Purchases
The number of times users have made in-app purchases within your mobile app. This metric measures the revenue generated through in-app transactions.
fb_ads:actions_app_custom_event.fb_mobile_purchaseCost per Mobile App Purchases
The average cost per Mobile App Purchases. This metric measures the efficiency of your spend, divided by Mobile App Purchases.
fb_ads:spend_app_custom_event.fb_mobile_purchaseMobile App Ratings
The number of times users have rated or reviewed your mobile app. Ratings and reviews can impact the app's reputation and user trust.
fb_ads:actions_app_custom_event.fb_mobile_rateCost per Mobile App Ratings
The average cost per Mobile App Ratings. This metric measures the efficiency of your spend, divided by Mobile App Ratings.
fb_ads:spend_app_custom_event.fb_mobile_rateMobile App Searches
The number of times users have conducted searches or queries within your mobile app. This metric reflects user engagement with your app's search functionality.
fb_ads:actions_app_custom_event.fb_mobile_searchCost per Mobile App Searches
The average cost per Mobile App Searches. This metric measures the efficiency of your spend, divided by Mobile App Searches.
fb_ads:spend_app_custom_event.fb_mobile_searchMobile App Credit Spends
The total amount of virtual credits or currency spent by users within your mobile app. This metric is relevant for apps with virtual economies or in-app currency systems.
fb_ads:actions_app_custom_event.fb_mobile_spent_creditsCost per Mobile App Credit Spends
The average cost per Mobile App Credit Spends. This metric measures the efficiency of your spend, divided by Mobile App Credit Spends.
fb_ads:spend_app_custom_event.fb_mobile_spent_creditsMobile App Tutorial Completions
The number of times users have successfully completed tutorial or onboarding processes within your mobile app. This metric indicates user readiness to use the app.
fb_ads:actions_app_custom_event.fb_mobile_tutorial_completionCost per Mobile App Tutorial Completions
The average cost per Mobile App Tutorial Completions. This metric measures the efficiency of your spend, divided by Mobile App Tutorial Completions.
fb_ads:spend_app_custom_event.fb_mobile_tutorial_completionOther Mobile App Actions
A category for tracking other user actions within your mobile app that are not specifically categorized by the predefined custom events. This metric captures various user interactions and behaviors.
fb_ads:actions_app_custom_event.otherCost per Other Mobile App Actions
The average cost per Other Mobile App Actions. This metric measures the efficiency of your spend, divided by Other Mobile App Actions.
fb_ads:spend_app_custom_event.otherApp Installations
The number of app installs recorded as app events and attributed to your ads.
fb_ads:actions_app_installCost per App Installs
The average cost per App Installs. This metric measures the efficiency of your spend, divided by App Installs.
fb_ads:spend_app_installApp Uses
The number of times users have actively used or launched your mobile app after installing it. This metric helps measure user engagement with your app.
fb_ads:actions_app_useCost per App Uses
The average cost per App Uses. This metric measures the efficiency of your spend, divided by App Uses.
fb_ads:spend_app_useCost per Check-ins
The average cost per Check-ins. This metric measures the efficiency of your spend, divided by Check-ins.
fb_ads:spend_checkinCost per Post Comments
The average cost per Post Comments. This metric measures the efficiency of your spend, divided by Post Comments.
fb_ads:spend_commentCredit Spending
The number of credit spend events attributed to your ads, based on information received from one or more of your connected Business Goal Tools. This does not refer to the total amount of credits spent.
fb_ads:actions_credit_spentCost per Credit Spends
The average cost per Credit Spends. This metric measures the efficiency of your spend, divided by Credit Spends.
fb_ads:spend_credit_spentGame sessions
The number of game session events attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_games.playsCost per game session
The average cost for each desktop gaming session. The metric is calculated as total spend divided by game sessions.
fb_ads:spend_games.playsAdds To Wishlist
The number of times users have added products to their wishlists on your website, tracked using the Facebook pixel. This metric reflects products that have piqued user interest.
fb_ads:actions_offsite_conversion.fb_pixel_add_to_wishlistCost per Adds To Wishlist
The average cost per Adds To Wishlist. This metric measures the efficiency of your spend, divided by Adds To Wishlist.
fb_ads:spend_offsite_conversion.fb_pixel_add_to_wishlistCost per Facebook Page like
The average cost per Facebook Page like attributed to your ads (ad spend divided by Page likes).
fb_ads:spend_likeLink Clicks
The number of times users have clicked on the links in your ads. This metric measures the effectiveness of your ad in driving traffic to your website or desired destination.
fb_ads:actions_link_clickCost per Link Clicks
The average cost per Link Clicks. This metric measures the efficiency of your spend, divided by Link Clicks.
fb_ads:spend_link_clickCost per Mobile App Installs
The average cost per Mobile App Installs. This metric measures the efficiency of your spend, divided by Mobile App Installs.
fb_ads:spend_mobile_app_installCompleted Registration
The number of times users have successfully completed a registration process on your website, tracked using the Facebook pixel. This metric represents user sign-ups or account creations.
fb_ads:actions_offsite_conversion.fb_pixel_complete_registrationCustom Pixel Events
The total number of custom pixel events defined by the advertiser on your website, tracked using the Facebook pixel. These events can represent various user actions or interactions tailored to your specific needs.
fb_ads:actions_offsite_conversion.fb_pixel_customCost per Custom Pixel Events
The average cost per Custom Pixel Events. This metric measures the efficiency of your spend, divided by Custom Pixel Events.
fb_ads:spend_offsite_conversion.fb_pixel_customCost per Checkout Initiated
The average cost per Initiates Checkout. This metric measures the efficiency of your spend, divided by Initiates Checkout.
fb_ads:spend_offsite_conversion.fb_pixel_initiate_checkoutCost per Searches
The average cost per Searches. This metric measures the efficiency of your spend, divided by Searches.
fb_ads:spend_offsite_conversion.fb_pixel_searchContent views on the website
This metric is related to the Facebook Pixel and measures specific content views on your website. It measures how many times the content viewing event configured on your Pixel was triggered during the analysis period.
fb_ads:actions_offsite_conversion.fb_pixel_view_contentCost per Views Content
The average cost per Views Content. This metric measures the efficiency of your spend, divided by Views Content.
fb_ads:spend_offsite_conversion.fb_pixel_view_contentOn-Meta Workflow Completions
The number of workflow completions that occurred across Meta technologies, attributed to your ads.
fb_ads:actions_onsite_conversion.flow_completeCost per workflow completion in Meta
The average cost of each Goal workflow completion. The metric calculation is done by dividing the value used by the Goal's workflow completions.
fb_ads:spend_onsite_conversion.flow_completeBlocked Messaging Conversations
The number of times users have blocked messaging conversations on the Facebook platform. This metric measures user actions related to messaging.
fb_ads:actions_onsite_conversion.messaging_blockCost per Blocked Messaging Conversations
The average cost per Blocked Messaging Conversations. This metric measures the efficiency of your spend, divided by Blocked Messaging Conversations.
fb_ads:spend_onsite_conversion.messaging_blockNew message contacts
The number of accounts that messaged your business for the first time, attributed to your ads. This metric is estimated.
fb_ads:actions_onsite_conversion.messaging_first_replyCost per New Messaging Conversations
The average cost per New Messaging Conversations. This metric measures the efficiency of your spend, divided by New Messaging Conversations.
fb_ads:spend_onsite_conversion.messaging_first_replyMessaging Subscriptions
The number of times users have subscribed to messaging updates or notifications on the Facebook platform. This metric represents user interest in receiving messages.
fb_ads:actions_onsite_conversion.messaging_user_subscribedCost per Messaging Subscriptions
The average cost per Messaging Subscriptions. This metric measures the efficiency of your spend, divided by Messaging Subscriptions.
fb_ads:spend_onsite_conversion.messaging_user_subscribedCost per Post Saves
The average cost per Post Saves. This metric measures the efficiency of your spend, divided by Post Saves.
fb_ads:spend_onsite_conversion.post_saveOn-Facebook Purchases
The total number of purchases made within the Facebook platform itself. This metric measures the success of sales or transactions within the Facebook ecosystem.
fb_ads:actions_onsite_conversion.purchaseCost per On-Facebook Purchases
The average cost per On-Facebook Purchases. This metric measures the efficiency of your spend, divided by On-Facebook Purchases.
fb_ads:spend_onsite_conversion.purchaseOutbound Clicks
The number of times users have clicked on links or elements that lead to external websites or destinations. This metric tracks user interactions that take them outside the current platform.
fb_ads:actions_outbound_clickCost per Outbound Clicks
The average cost per Outbound Clicks. This metric measures the efficiency of your spend, divided by Outbound Clicks.
fb_ads:spend_outbound_clickCost per Page Photo Views
The average cost per Page Photo Views. This metric measures the efficiency of your spend, divided by Page Photo Views.
fb_ads:spend_photo_viewCost per Post Shares
The average cost per Post Shares. This metric measures the efficiency of your spend, divided by Post Shares.
fb_ads:spend_postCost per Post Reactions
The average cost per Post Reactions. This metric measures the efficiency of your spend, divided by Post Reactions.
fb_ads:spend_post_reactionEvent Responses
The number of times users have responded to your Facebook events by indicating their attendance, such as "Going," "Interested," or "Not Going." This metric measures event engagement and attendance.
fb_ads:actions_rsvpCost per Event Responses
The average cost per Event Responses. This metric measures the efficiency of your spend, divided by Event Responses.
fb_ads:spend_rsvpCost per Contacts
The average cost per Contacts. This metric measures the efficiency of your spend, divided by Contacts.
fb_ads:spend_contact_totalCost per Mobile App Contacts
The average cost per Mobile App Contacts. This metric measures the efficiency of your spend, divided by Mobile App Contacts.
fb_ads:spend_contact_mobile_appCost per Offline Contacts
The average cost per Offline Contacts. This metric measures the efficiency of your spend, divided by Offline Contacts.
fb_ads:spend_contact_offlineProducts Customized
The total number of times users have customized products, such as apparel or merchandise, through various channels. This metric indicates user interest in personalized product offerings.
fb_ads:actions_customize_product_totalCost per Products Customized
The average cost per Products Customized. This metric measures the efficiency of your spend, divided by Products Customized.
fb_ads:spend_customize_product_totalWebsite Products Customized
The number of times users have customized products on your website. This metric measures user engagement with product customization features on your site.
fb_ads:actions_customize_product_websiteCost per Website Products Customized
The average cost per Website Products Customized. This metric measures the efficiency of your spend, divided by Website Products Customized.
fb_ads:spend_customize_product_websiteMobile App Products Customized
The number of times users have customized products through your mobile app. This metric reflects user interactions within your app that result in personalized product designs.
fb_ads:actions_customize_product_mobile_appCost per Mobile App Products Customized
The average cost per Mobile App Products Customized. This metric measures the efficiency of your spend, divided by Mobile App Products Customized.
fb_ads:spend_customize_product_mobile_appOffline Products Customized
The number of times users have customized products through offline methods, such as in-store or at events. This metric represents customization efforts outside of digital platforms.
fb_ads:actions_customize_product_offlineCost per Offline Products Customized
The average cost per Offline Products Customized. This metric measures the efficiency of your spend, divided by Offline Products Customized.
fb_ads:spend_customize_product_offlineDonations
The total number of donations received through various channels, including your website, mobile app, and offline methods. This metric represents the overall success of your fundraising efforts.
fb_ads:actions_donate_totalCost per Donations
The average cost per Donations. This metric measures the efficiency of your spend, divided by Donations.
fb_ads:spend_donate_totalWebsite Donations
The number of donations received specifically through your website. This metric measures the effectiveness of your website in collecting donations.
fb_ads:actions_donate_websiteCost per Website Donations
The average cost per Website Donations. This metric measures the efficiency of your spend, divided by Website Donations.
fb_ads:spend_donate_websiteOn Facebook Donations
The number of donations received directly on Facebook or through Facebookz's fundraising features. This metric tracks donations made within the Facebook ecosystem.
fb_ads:actions_donate_on_facebookCost per On Facebook Donations
The average cost per On Facebook Donations. This metric measures the efficiency of your spend, divided by On Facebook Donations.
fb_ads:spend_donate_on_facebookMobile App Donations
The number of donations received through your mobile app. This metric indicates user interactions within your app that result in donations.
fb_ads:actions_donate_mobile_appCost per Mobile App Donations
The average cost per Mobile App Donations. This metric measures the efficiency of your spend, divided by Mobile App Donations.
fb_ads:spend_donate_mobile_appOffline Donations
The number of donations received through offline methods, such as in-person events or direct interactions. This metric reflects donation collection efforts outside of digital channels.
fb_ads:actions_donate_offlineCost per Offline Donations
The average cost per Offline Donations. This metric measures the efficiency of your spend, divided by Offline Donations.
fb_ads:spend_donate_offlineLocation Searches
The total number of location searches conducted by users through various channels, including your website, mobile app, and offline methods. This metric represents user interest in finding specific locations.
fb_ads:actions_find_location_totalCost per Location Searches
The average cost per Location Searches. This metric measures the efficiency of your spend, divided by Location Searches.
fb_ads:spend_find_location_totalWebsite Location Searches
The number of location searches conducted by users specifically on your website. This metric measures the success of your website in helping users find specific locations.
fb_ads:actions_find_location_websiteCost per Website Location Searches
The average cost per Website Location Searches. This metric measures the efficiency of your spend, divided by Website Location Searches.
fb_ads:spend_find_location_websiteMobile App Location Searches
The number of location searches conducted by users through your mobile app. This metric indicates user interactions within your app related to location discovery.
fb_ads:actions_find_location_mobile_appCost per Mobile App Location Searches
The average cost per Mobile App Location Searches. This metric measures the efficiency of your spend, divided by Mobile App Location Searches.
fb_ads:spend_find_location_mobile_appOffline App Location Searches
The number of location searches conducted by users through offline methods, such as in-store or at events. This metric reflects location search efforts outside of digital platforms.
fb_ads:actions_find_location_offlineCost per Offline App Location Searches
The average cost per Offline App Location Searches. This metric measures the efficiency of your spend, divided by Offline App Location Searches.
fb_ads:spend_find_location_offlineAppointments Scheduled
The number of scheduling events attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_schedule_totalCost per Appointments Scheduled
The average cost per Appointments Scheduled. This metric measures the efficiency of your spend, divided by Appointments Scheduled.
fb_ads:spend_schedule_totalWebsite Appointments Scheduled
The number of appointment events tracked by the pixel or Conversions API on your website and attributed to your ads. If you have a standard appointment event implemented on your website, the metric counts when the Facebook pixel or Conversions API tracks this event attributed to your ads.
fb_ads:actions_schedule_websiteCost for Website Appointments Scheduled
The average cost of each hour booked on the website during the analyzed period. This metric is calculated as the total amount used divided by the hours booked on the website.
fb_ads:spend_schedule_websiteMobile App Appointments Scheduled
The number of appointment events that occurred in your mobile app and are attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_schedule_mobile_appCost for Mobile App Appointments Scheduled
The average cost of each appointment booked on the mobile app during the analyzed period. This metric is calculated as the total amount used divided by the hours booked on the mobile app.
fb_ads:spend_schedule_mobile_appOffline App Appointments Scheduled
The number of Appointments events that were recorded by your offline event data and attributed to your ads. If you're uploading offline data to Facebook (via the offline event manager or API) and have chosen to report this event offline, this metric will count when the event is reported and attributed to your ads.
fb_ads:actions_schedule_offlineCost for Offline App Appointments Scheduled
The average cost of each hour booked offline during the analyzed period. This metric is calculated as the total amount used divided by hours booked offline.
fb_ads:spend_schedule_offlineCost per Trials Started
The average cost per Trials Started. This metric measures the efficiency of your spend, divided by Trials Started.
fb_ads:spend_start_trial_totalWebsite Trials Started
The number of trials or free usage periods initiated specifically on your website. This metric measures the effectiveness of your website in encouraging trial sign-ups.
fb_ads:actions_start_trial_websiteCost per Website Trials Started
The average cost per Website Trials Started. This metric measures the efficiency of your spend, divided by Website Trials Started.
fb_ads:spend_start_trial_websiteMobile App Trials Started
The number of trials or free usage periods initiated through your mobile app. This metric indicates user interactions within your app that lead to trial activations.
fb_ads:actions_start_trial_mobile_appCost per Mobile App Trials Started
The average cost per Mobile App Trials Started. This metric measures the efficiency of your spend, divided by Mobile App Trials Started.
fb_ads:spend_start_trial_mobile_appOffline Trials Started
The number of trials or free usage periods initiated through offline methods, such as in-person interactions or events. This metric reflects trial activation efforts outside of digital platforms.
fb_ads:actions_start_trial_offlineCost per Offline Trials Started
The average cost per Offline Trials Started. This metric measures the efficiency of your spend, divided by Offline Trials Started.
fb_ads:spend_start_trial_offlineSubmitted applications
The number of application submission events attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_submit_application_totalCost per Entries sent
Cost per application submitted during the review period. This metric is calculated as the total amount used divided by entries submitted.
fb_ads:spend_submit_application_totalApplications submitted on the website
The number of submitted sign-up events tracked by the pixel or Conversions API on your website and attributed to your ads. If you have a standard Subscriptions sent event implemented on your website, the metric counts when the Facebook pixel or Conversions API tracks this event attributed to your ads.
fb_ads:actions_submit_application_websiteCost for applications submitted on the website
Cost per application submitted on the website during the analysis period. This metric is calculated as the total amount used divided by Submissions submitted on the site.
fb_ads:spend_submit_application_websiteApplications submitted on mobile apps
The number of submitted sign-up events that occurred in your mobile app and are attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_submit_application_mobile_appCost for entries submitted on mobile apps
Cost per application submitted via mobile apps during the analysis period. This metric is calculated as the total amount used divided by Subscriptions sent via mobile apps.
fb_ads:spend_submit_application_mobile_appApplications submitted offline
The number of Submissions sent events that were recorded by your offline events data and attributed to your ads. If you're uploading offline data to Facebook (via the offline event manager or API) and have chosen to report this event offline, this metric will count when the event is reported and attributed to your ads.
fb_ads:actions_submit_application_offlineCost for entries submitted offline
Cost per application submitted offline during the review period. This metric is calculated as the total amount used divided by Submissions submitted offline.
fb_ads:spend_submit_application_offlineApplications sent on Facebook
The number of applications sent on Facebook, taking into account the ads served on the Facebook platform during the analyzed period.
fb_ads:actions_submit_application_on_facebookCost for entries sent on Facebook
Cost per application submitted on Facebook during the analysis period. This metric is calculated as the total amount used divided by Submissions on Facebook.
fb_ads:spend_submit_application_on_facebookSubscriptions
The total number of subscriptions received through various channels, including your website, mobile app, and offline methods. This metric represents successful subscription sign-ups.
fb_ads:actions_subscribe_totalCost per Subscriptions
The average cost per Subscriptions. This metric measures the efficiency of your spend, divided by Subscriptions.
fb_ads:spend_subscribe_totalWebsite Subscriptions
The number of subscriptions received specifically through your website. This metric measures the effectiveness of your website in capturing subscription sign-ups.
fb_ads:actions_subscribe_websiteCost per Website Subscriptions
The average cost per Website Subscriptions. This metric measures the efficiency of your spend, divided by Website Subscriptions.
fb_ads:spend_subscribe_websiteMobile App Subscriptions
The number of subscriptions received through your mobile app. This metric indicates user interactions within your app related to subscription registrations.
fb_ads:actions_subscribe_mobile_appCost per Mobile App Subscriptions
The average cost per Mobile App Subscriptions. This metric measures the efficiency of your spend, divided by Mobile App Subscriptions.
fb_ads:spend_subscribe_mobile_appOffline Subscriptions
The number of subscriptions received through offline methods, such as in-person or phone interactions. This metric reflects subscription registration efforts outside of digital platforms.
fb_ads:actions_subscribe_offlineCost per Offline Subscriptions
The average cost per Offline Subscriptions. This metric measures the efficiency of your spend, divided by Offline Subscriptions.
fb_ads:spend_subscribe_offlineRecurring Subscription Payments
The number of recurring subscription payments based on information recorded through your use of Meta Tools for Business.
fb_ads:actions_recurring_subscription_payment_totalCost per Recurring Subscription Payments
The average cost of each recurring subscription payment during the period analyzed. This metric is calculated as the total amount used divided by the number of recurring subscription payments.
fb_ads:spend_recurring_subscription_payment_totalRecurring subscription payments on the website
Contagem dos pagamentos de assinaturas recorrentes no site com base nas informações registradas por meio do seu uso das Ferramentas da Meta para Empresas.
fb_ads:actions_recurring_subscription_payment_websiteCost for recurring subscription payments on the website
The average amount spent on advertising to acquire each recurring subscription payment through the website. This metric is calculated as the total amount used divided by the number of recurring subscription payments on the site.
fb_ads:spend_recurring_subscription_payment_websiteRecurring subscription payments on mobile apps
Counting payments for recurring subscriptions to mobile applications based on information recorded through your use of Meta Tools for Business.
fb_ads:actions_recurring_subscription_payment_mobile_appCost per Mobile App Recurring Subscription Payments
The average ad spend required to secure a recurring subscription payment on mobile apps. This metric is calculated as the total amount used divided by the number of recurring mobile app subscription payments
fb_ads:spend_recurring_subscription_payment_mobile_appOffline Recurring Subscription Payments
The average advertising cost associated with the acquisition of each recurring subscription payment in physical or offline locations, through Meta para Empresas tools. This metric is calculated as the total amount used divided by the number of offline recurring subscription payments.
fb_ads:actions_recurring_subscription_payment_offlineCost per Offline Recurring Subscription Payments
The average cost per Offline Recurring Subscription Payments. This metric measures the efficiency of your spend, divided by Offline Recurring Subscription Payments.
fb_ads:spend_recurring_subscription_payment_offlineCanceled Subscriptions
The total number of canceled subscriptions through various channels, including your website, mobile app, and offline methods. This metric represents the count of subscriptions that have been canceled.
fb_ads:actions_cancel_subscription_totalCost per Canceled Subscriptions
The average cost per Canceled Subscriptions. This metric measures the efficiency of your spend, divided by Canceled Subscriptions.
fb_ads:spend_cancel_subscription_totalWebsite Canceled Subscriptions
The number of canceled subscriptions specifically through your website. This metric measures the rate of subscription cancellations on your website.
fb_ads:actions_cancel_subscription_websiteCost per Website Canceled Subscriptions
The average cost per Website Canceled Subscriptions. This metric measures the efficiency of your spend, divided by Website Canceled Subscriptions.
fb_ads:spend_cancel_subscription_websiteMobile App Canceled Subscriptions
The number of canceled subscriptions through your mobile app. This metric indicates user interactions within your app related to subscription cancellations.
fb_ads:actions_cancel_subscription_mobile_appCost per Mobile App Canceled Subscriptions
The average cost per Mobile App Canceled Subscriptions. This metric measures the efficiency of your spend, divided by Mobile App Canceled Subscriptions.
fb_ads:spend_cancel_subscription_mobile_appOffline Canceled Subscriptions
The number of canceled subscriptions through offline methods, such as in-person or phone interactions. This metric reflects subscription cancellation efforts outside of digital platforms.
fb_ads:actions_cancel_subscription_offlineCost per Offline Canceled Subscriptions
The average cost per Offline Canceled Subscriptions. This metric measures the efficiency of your spend, divided by Offline Canceled Subscriptions.
fb_ads:spend_cancel_subscription_offlineIn-App Ad Clicks
The number of times users have clicked on ads displayed within a mobile app. This metric measures user interactions with ads while using a mobile app.
fb_ads:actions_ad_click_mobile_appCost per In-App Ad Clicks
The average cost per In-App Ad Clicks. This metric measures the efficiency of your spend, divided by In-App Ad Clicks.
fb_ads:spend_ad_click_mobile_appIn-App Ad Impressions
The total number of times ads have been displayed within a mobile app. This metric reflects the overall reach and visibility of ads shown in-app.
fb_ads:actions_ad_impression_mobile_appCost per In-App Ad Impressions
The average cost per In-App Ad Impressions. This metric measures the efficiency of your spend, divided by In-App Ad Impressions.
fb_ads:spend_ad_impression_mobile_appEstimated number of connection confirmation clicks
The estimated number of times the Call button is clicked in a call confirmation dialog after an ad with a call destination is clicked.
fb_ads:actions_click_to_call_call_confirmCost per Estimated Call Confirmation Clicks
The average cost per Estimated Call Confirmation Clicks. This metric measures the efficiency of your spend, divided by Estimated Call Confirmation Clicks.
fb_ads:spend_click_to_call_call_confirmCalls Placed (Only available in select countries)
The number of phone calls placed through native call functionality within the Facebook platform. This metric tracks completed phone calls initiated from ads.
fb_ads:actions_click_to_call_native_call_placedCost per Calls Placed (Only available in select countries)
The average cost per Calls Placed (Only available in select countries). This metric measures the efficiency of your spend, divided by Calls Placed (Only available in select countries).
fb_ads:spend_click_to_call_native_call_placed20s Calls Placed
The number of phone calls made through the native calling functionality on the Facebook platform that lasted at least 20 seconds. This metric measures longer phone call interactions. It is only available in selected countries
fb_ads:actions_click_to_call_native_20s_call_connectCost per 20s Calls Placed (Only available in select countries)
The average cost per 20s Calls Placed (Only available in select countries). This metric measures the efficiency of your spend, divided by 20s Calls Placed (Only available in select countries).
fb_ads:spend_click_to_call_native_20s_call_connect60s Calls Placed
The number of phone calls made through the native calling functionality on the Facebook platform that lasted at least 60 seconds. This metric measures longer phone call interactions. It is only available in selected countries
fb_ads:actions_click_to_call_native_60s_call_connectCost per 60s Calls Placed (Only available in select countries)
The average cost per 60s Calls Placed (Only available in select countries). This metric measures the efficiency of your spend, divided by 60s Calls Placed (Only available in select countries).
fb_ads:spend_click_to_call_native_60s_call_connectCost per Page Engagement
The average cost per Page Engagement. This metric measures the efficiency of your spend, divided by Page Engagement.
fb_ads:spend_page_engagementCost per Post Engagement
The average cost per Post Engagement. This metric measures the efficiency of your spend, divided by Post Engagement.
fb_ads:spend_post_engagementOn-Facebook Leads Coming from Messenger and Instant Forms
The total number of leads generated on Facebook through Messenger and Instant Forms. This metric represents lead generation efforts within the Facebook messaging ecosystem.
fb_ads:actions_leadgen_groupedCost per On-Facebook Leads Coming from Messenger and Instant Forms
The average cost per On-Facebook Leads Coming from Messenger and Instant Forms. This metric measures the efficiency of your spend, divided by On-Facebook Leads Coming from Messenger and Instant Forms.
fb_ads:spend_leadgen_groupedTotal App Installations
The number of app installs, tracking app installs across multiple Meta platforms such as Facebook, Instagram, and Audience Network. It offers an expanded view of the number of app installs occurring across different Facebook properties.
fb_ads:actions_omni_app_installCost per Purchases
The average cost per Purchases. This metric measures the efficiency of your spend, divided by Purchases.
fb_ads:spend_omni_purchaseContent views
Number of views of content on your website or app through Facebook Ads events. It can include content views across multiple platforms, such as Facebook, Instagram, and Audience Network.
fb_ads:actions_omni_view_contentAchievements Unlocked
The number of in-app achievements unlocked by users while using your mobile app or platform. This metric reflects user engagement with gamification elements.
fb_ads:actions_omni_achievement_unlockedCost per Achievements Unlocked
The average cost per Achievements Unlocked. This metric measures the efficiency of your spend, divided by Achievements Unlocked.
fb_ads:spend_omni_achievement_unlockedApp Activations
The number of times users have activated or launched your mobile app. This metric tracks user interactions with your app.
fb_ads:actions_omni_activate_appCost per App Activations
The average cost per App Activations. This metric measures the efficiency of your spend, divided by App Activations.
fb_ads:spend_omni_activate_appLevels Achieved
The number of in-app levels achieved by users while using your mobile app or platform. This metric measures user progression and engagement.
fb_ads:actions_omni_level_achievedCost per Levels Achieved
The average cost per Levels Achieved. This metric measures the efficiency of your spend, divided by Levels Achieved.
fb_ads:spend_omni_level_achievedRatings Submitted
The number of user ratings submitted for your mobile app or platform. This metric reflects user feedback and sentiment.
fb_ads:actions_omni_rateCost per Ratings Submitted
The average cost per Ratings Submitted. This metric measures the efficiency of your spend, divided by Ratings Submitted.
fb_ads:spend_omni_rateConversion value of credit expenses
The total amount of credit spending. This metric is calculated as the total amount used divided by credit spend.
fb_ads:actions_omni_spend_creditsCompleted tutorials
The number of tutorial completion events attributed to your ads, based on information received from one or more of your connected Business Goal Tools.
fb_ads:actions_omni_tutorial_completionCost per completed tutorials
The average cost of each completed tutorial. The metric is calculated as the total amount used divided by tutorials completed.
fb_ads:spend_omni_tutorial_completionCustom Events
Custom events defined by the advertiser to track specific user interactions or actions on their platform or app. This metric represents advertiser-defined custom events.
fb_ads:actions_omni_customCost per Custom Events
The average cost per Custom Events. This metric measures the efficiency of your spend, divided by Custom Events.
fb_ads:spend_omni_customCurrency
The currency of the account.
fads:account_currencyAccount ID
The ID of the account.
fads:account_idAccount Name
The name of the account.
fads:account_nameEstimated Ad Recall Lift
The number of people Meta estimates would remember seeing your ad if we asked them within two days.
fads:estimated_ad_recallers_upper_boundAction Values
The values associated with actions.
fads:action_values100% Watched Video Watched Actions
The number of actions taken during 100% watched videos.
fads:video_p100_watched_actionsConversions
The number of times a desired action was taken.
fads:conversionsCost Per Conversion
The cost per conversion for the campaign.
fads:cost_per_conversionInstagram Profile Visits
The number of times users visited your Instagram profile after interacting with your ads. This metric was introduced by Meta on October 29, 2025 and is not available for earlier periods.
fb_ads:instagram_profile_visitsCost per Instagram Profile Visit
The average cost per Instagram profile visit. This metric measures the efficiency of your spend, divided by Instagram Profile Visits. Available from October 29, 2025 onward.
fb_ads:cost_per_instagram_profile_visitsInstagram Followers gained
The number of Instagram followers gained through your ad campaigns. This metric counts the follows attributed to ads served on the Instagram platform.
fb_ads:instagram_profile_followCost per Instagram Follower
The average cost per Instagram follower gained through your campaigns. Calculated by dividing spend by the number of Instagram followers gained.
fb_ads:cost_per_instagram_profile_followLanding Page Conversion Rate
Estimated landing page conversion rate, calculated as Website Contacts divided by Landing Page Views. This is an estimated metric and may not reflect the exact conversion rate.
fb_ads:landing_page_conversion_rateEngagement Spend
Total amount spent on campaigns with the engagement objective, including post engagement, page likes, video views, and event responses.
fb_ads:spend_engagementVideo View Rate (3s)
The rate of 3-second video views per impression, calculated as 3-Second Video Views divided by Impressions. This metric shows how often people watched at least 3 seconds of your video when it was shown.
fb_ads:video_view_rateConnect Rate
The percentage of link clicks that resulted in a landing page view. Calculated as Landing Page Views divided by Link Clicks. A higher connect rate indicates that your landing page loads successfully for most visitors.
fb_ads:connect_rate
Charts
9 metrics
Impressions and reach by age
This graph shows the impressions and reach of your ads grouped by the age of the person who saw them
fb_ads:impressions_reach_by_ageImpressions and reach by gender
This graph shows the impressions and reach of your ads grouped by the gender of the people who saw them.
fb_ads:impressions_reach_by_genderImpressions and reach by hour
This graph show the impressions and reach of your ads, grouped by the hour of day that they were seen.
fb_ads:impressions_reach_by_hourReach by device platform
This graph shows reach of your ads grouped by the device of the person who saw them.
fb_ads:reach_by_device_platformAmount invested per day
This chart shows the amount invested per day during the analysis period.
fb_ads:spend_by_dateClicks and CTR over time
This graph shows the number of clicks and CTR percentage during the analyzed time period.
fb_ads:clicks_and_ctr_by_dateAmount spent and Purchases over time
This chart shows the amount spent and the number of purchases over the analyzed time period.
fb_ads:spend_and_purchases_by_dateInstagram Profile Visits per day
This chart shows the number of Instagram profile visits per day during the analysis period.
fb_ads:instagram_profile_visits_by_dateInstagram Followers gained per day
This chart shows the number of Instagram followers gained through your ads per day during the analysis period.
fb_ads:instagram_profile_follow_by_date
Tables
14 metrics
Featured Ads
Your ads in the specified time period.
fb_ads:adsCatalog Ads
Performance breakdown by product from your catalog ads, showing spend, impressions, clicks and purchases for each product.
fb_ads:catalog_adsConversions and actions by Type
The kind of actions taken on your ad, page, app or event after your ad was served to someone, even if they didn't click on it. Action types include page likes, app installs, conversions, event responses and more.
fb_ads:actions_by_typeConversions and actions by Platform
The kind of actions taken on your ad, Page, app or event after your ad was served to someone, grouped by the platform that it was served, even if they didn't click on it. Action types include Page likes, app installs, conversions, event responses and more.
fb_ads:actions_by_platformPerformance by Platform Position
Ad performance broken down by platform position (Feed, Stories, Reels, Right Column, etc.), showing where your ads are delivering the best results.
fb_ads:performance_by_positionRegions with greater reach
Regions (state or province) where your audience lives or was located at the time they viewed your ads for the analyzed period.
fb_ads:reach_by_regionFeatured campaigns
Campaigns that had the greatest impact on your audience, during the period analyzed.
fb_ads:insights_by_campaignFeatured ad set
Summary of key data for ad sets for the period analyzed.
fb_ads:adsetPerformance by Platform by device
Summary of key data for platform for the period analyzed.
fb_ads:performance_by_platformPerformance by Country
Ad performance broken down by country, showing where your audience is located and how your ads perform in each country.
fb_ads:reach_by_countryPerformance by text creative
Performance breakdown by dynamic creative text asset, showing how each copy variation performs across key metrics.
fb_ads:dynamic_creativePerformance by image creative
Performance breakdown by dynamic creative image asset, showing how each image variation performs across key metrics.
fb_ads:dynamic_creative_imageAds Grouped by Name
Ads aggregated by name, combining performance data from all ads that share the same name. Useful for analyzing creatives that run across multiple ad sets or campaigns.
fb_ads:grouped_adsPerformance by Platform
Ad performance broken down by publisher platform (Facebook, Instagram, Messenger, Audience Network), showing how your ads perform on each platform.
fb_ads:performance_by_publisher_platform
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
