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"
      ]
    }
  ]
}
Example: "Total Average CPC" in October, compared to September.

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:cpc
  • Total Reach

    Total number of people who saw your ad at least once during the selected review period. This metric is estimated.

    fb_ads:reach
  • Reach on Facebook

    Reach of your Ads, taking in consideration the Ads served on Facebook

    fb_ads:reach_facebook
  • Reach on Messenger

    Reach of your Ads, taking in consideration the Ads served on Messenger

    fb_ads:reach_messenger
  • Reach on Audience Networks

    Reach of your Ads, taking in consideration the Ads served on Audience Networks

    fb_ads:reach_audience_network
  • Reach on Instagram

    Reach of your Ads, taking in consideration the Ads served on Instagram

    fb_ads:reach_instagram
  • Total Impressions

    The number of times your ads were on screen of your target audience.

    fb_ads:impressions
  • Impressions on Facebook

    Number of impressions on your Ads, taking in consideration the Ads served on Facebook

    fb_ads:impressions_facebook
  • Impressions on Messenger

    Number of impressions on your Ads, taking in consideration the Ads served on Messenger

    fb_ads:impressions_messenger
  • Impressions on Audience Networks

    Number of impressions on your Ads, taking in consideration the Ads served on Audience Networks

    fb_ads:impressions_audience_network
  • Impressions on Instagram

    Number of impressions on your Ads, taking in consideration the Ads served on Instagram

    fb_ads:impressions_instagram
  • Total 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:clicks
  • Clicks on Facebook

    The number of clicks on your ads, taking in consideration the Ads served on Facebook

    fb_ads:clicks_facebook
  • Clicks on Instagram

    The number of clicks on your ads, taking in consideration the Ads served on Instagram

    fb_ads:clicks_instagram
  • CTR (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:ctr
  • CTR (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_facebook
  • CTR (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_instagram
  • Frequency

    The average number of times each person saw your ad.

    fb_ads:frequency
  • Frequency 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_facebook
  • Frequency on Instagram

    The average number of times each person saw your ad, taking in consideration the Ads served on Instagram

    fb_ads:frequency_instagram
  • Amount spent

    The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule.

    fb_ads:spend
  • Amount 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_network
  • Amount invested in Messenger

    Total amount invested in Messenger during the analyzed period.

    fb_ads:spend_messenger
  • Amount 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_facebook
  • Amount 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_instagram
  • CPC 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_facebook
  • CPC 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_instagram
  • Average 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:cpm
  • Cost 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_reach
  • Average 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_facebook
  • Average 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_instagram
  • Total 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_clicks
  • Instagram 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_clicks
  • Facebook 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_clicks
  • CTR (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_ctr
  • CTR (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_instagram
  • CTR (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_facebook
  • Average 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_click
  • Ads count

    Number of page ads published by the page.

    fb_ads:count_ads
  • Campaigns count

    Number of page campaigns published by the page.

    fb_ads:count_campaigns
  • Page 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_engagement
  • Post 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_engagement
  • Post 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_facebook
  • Post 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_instagram
  • Comments

    Post comments metric counts all the comments people made to your ads while they were running.

    fb_ads:actions_comment
  • 3-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_view
  • Photo 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_view
  • Landing 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_view
  • Total 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_lead
  • Total Contacts

    The number of contact events attributed to your ads, in the analysis period.

    fb_ads:actions_contacts
  • Website Contacts

    The number of website contact events attributed to your ads, in the analysis period.

    fb_ads:actions_contacts_website
  • App Contacts

    The number of mobile apps contact events attributed to your ads, in the analysis period.

    fb_ads:actions_contacts_mobile_app
  • Actions 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_content
  • Offline Contacts

    The number of offline contact events attributed to your ads, in the analysis period.

    fb_ads:actions_contacts_offline
  • Reactions 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_reaction
  • Facebook Page likes

    The number of likes on your Facebook Page attributed to your ads during the analysis period.

    fb_ads:actions_like
  • Posts 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_post
  • Check-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_checkin
  • Adds 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_cart
  • Searches

    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_search
  • Registrations 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_registration
  • Cost per Completed Registration

    .

    fb_ads:cost_per_actions_omni_complete_registration
  • 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_omni_purchase
  • Instagram 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_purchase
  • Total 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_rate
  • Instagram 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_instagram
  • Facebook 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_facebook
  • Facebook 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_purchase
  • Trials Started

    The start of a free trial of a product or service you offer. For example, trial subscription.

    fb_ads:actions_start_trial_total
  • Offline 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_cart
  • Messaging 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_7d
  • Messaging 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_instagram
  • Messaging 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_facebook
  • Post 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_save
  • Website 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_lead
  • Website 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_cart
  • Website 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_search
  • Adds 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_info
  • Checkouts 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_checkout
  • Cost 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_purchase
  • Cost 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_view
  • Costs 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_cart
  • Add to cart Conversion Value

    The total value of adds to cart tracked with the sales objective.

    fb_ads:actions_conversion_value_omni_add_to_cart
  • Cost 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_cart
  • Cost 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_cart
  • Cost 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_view
  • Cost 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_lead
  • Cost 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_lead
  • Cost 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_info
  • Cost 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_purchase
  • Website 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_purchase
  • Cost 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_checkout
  • Checkout Initiated Conversion Value

    The total value of initiated checkouts tracked with the sales objective

    fb_ads:actions_conversion_omni_initiated_checkout
  • Videos 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_watched
  • Cost 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_watched
  • Video 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_actions
  • Videos 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_watched
  • Cost 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_watched
  • Videos 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_watched
  • Cost 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_watched
  • Videos 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_watched
  • Video 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_watched
  • Cost 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_watched
  • Thruplays

    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:thruplays
  • Cost per Thruplay

    The average cost of each ThruPlay. The metric is calculated by dividing the total amount spent by ThruPlays.

    fb_ads:cost_per_thruplays
  • Cost 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_total
  • Current 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_balance
  • Available 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_balance
  • Website 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_roas
  • Website 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_instagram
  • Website 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_facebook
  • Purchase 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_roas
  • Purchase 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_instagram
  • Purchase 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_facebook
  • Purchase Conversion Value

    The total value of purchases tracked with the conversions objective. In some cases, this metric may be estimated.

    fb_ads:purchase_conversion_value
  • Average Ticket

    The average value per purchase, calculated by dividing the total purchase conversion value by the number of purchases.

    fb_ads:average_ticket
  • Website 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_value
  • Total 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_value
  • Website Subscription Conversion Value

    The total value of website subscription conversions attributed to your ads, tracked through the Meta pixel.

    fb_ads:subscribe_website_conversion_value
  • Mobile App Subscription Conversion Value

    The total value of mobile app subscription conversions attributed to your ads.

    fb_ads:subscribe_mobile_app_conversion_value
  • Offline Subscription Conversion Value

    The total value of offline subscription conversions attributed to your ads, based on offline event data.

    fb_ads:subscribe_offline_conversion_value
  • Cost per Website Contacts

    The number of website contact events attributed to your ads, in the analysis period.

    fb_ads:spend_contacts_website
  • Cost 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_7d
  • Cost 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_campaigns
  • Meta leads

    The number of leads submitted via Meta technologies (including forms and Messenger) and attributed to your ads.

    fb_ads:facebook_leads
  • Cost per Meta leads

    The cost per number of leads submitted on Facebook properties attributed to your ads.

    fb_ads:facebook_leads_cost
  • Mobile 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_unlocked
  • Cost 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_unlocked
  • Mobile 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_app
  • Cost 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_app
  • Mobile 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_info
  • Cost 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_info
  • Mobile 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_cart
  • Cost 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_cart
  • Mobile 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_wishlist
  • Cost 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_wishlist
  • Mobile 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_registration
  • Cost 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_registration
  • Mobile 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_view
  • Cost 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_view
  • Mobile 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_checkout
  • Cost 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_checkout
  • Mobile 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_achieved
  • Cost 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_achieved
  • Mobile 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_purchase
  • Cost 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_purchase
  • Mobile 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_rate
  • Cost 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_rate
  • Mobile 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_search
  • Cost 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_search
  • Mobile 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_credits
  • Cost 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_credits
  • Mobile 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_completion
  • Cost 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_completion
  • Other 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.other
  • Cost 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.other
  • App Installations

    The number of app installs recorded as app events and attributed to your ads.

    fb_ads:actions_app_install
  • Cost 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_install
  • App 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_use
  • Cost 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_use
  • Cost per Check-ins

    The average cost per Check-ins. This metric measures the efficiency of your spend, divided by Check-ins.

    fb_ads:spend_checkin
  • Cost per Post Comments

    The average cost per Post Comments. This metric measures the efficiency of your spend, divided by Post Comments.

    fb_ads:spend_comment
  • Credit 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_spent
  • Cost 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_spent
  • Game 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.plays
  • Cost 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.plays
  • Adds 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_wishlist
  • Cost 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_wishlist
  • Cost per Facebook Page like

    The average cost per Facebook Page like attributed to your ads (ad spend divided by Page likes).

    fb_ads:spend_like
  • Link 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_click
  • Cost 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_click
  • Cost 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_install
  • Completed 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_registration
  • Custom 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_custom
  • Cost 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_custom
  • Cost 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_checkout
  • Cost 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_search
  • Content 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_content
  • Cost 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_content
  • On-Meta Workflow Completions

    The number of workflow completions that occurred across Meta technologies, attributed to your ads.

    fb_ads:actions_onsite_conversion.flow_complete
  • Cost 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_complete
  • Blocked 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_block
  • Cost 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_block
  • New 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_reply
  • Cost 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_reply
  • Messaging 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_subscribed
  • Cost 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_subscribed
  • Cost 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_save
  • On-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.purchase
  • Cost 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.purchase
  • Outbound 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_click
  • Cost 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_click
  • Cost 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_view
  • Cost per Post Shares

    The average cost per Post Shares. This metric measures the efficiency of your spend, divided by Post Shares.

    fb_ads:spend_post
  • Cost 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_reaction
  • Event 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_rsvp
  • Cost per Event Responses

    The average cost per Event Responses. This metric measures the efficiency of your spend, divided by Event Responses.

    fb_ads:spend_rsvp
  • Cost per Contacts

    The average cost per Contacts. This metric measures the efficiency of your spend, divided by Contacts.

    fb_ads:spend_contact_total
  • Cost 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_app
  • Cost 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_offline
  • Products 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_total
  • Cost 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_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Donations

    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_total
  • Cost per Donations

    The average cost per Donations. This metric measures the efficiency of your spend, divided by Donations.

    fb_ads:spend_donate_total
  • Website 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_website
  • Cost 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_website
  • On 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_facebook
  • Cost 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_facebook
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Location 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_total
  • Cost 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_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Appointments 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_total
  • Cost 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_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Cost 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_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Submitted 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_total
  • Cost 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_total
  • Applications 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_website
  • Cost 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_website
  • Applications 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_app
  • Cost 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_app
  • Applications 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_offline
  • Cost 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_offline
  • Applications 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_facebook
  • Cost 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_facebook
  • Subscriptions

    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_total
  • Cost per Subscriptions

    The average cost per Subscriptions. This metric measures the efficiency of your spend, divided by Subscriptions.

    fb_ads:spend_subscribe_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Recurring 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_total
  • Cost 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_total
  • Recurring 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_website
  • Cost 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_website
  • Recurring 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • Canceled 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_total
  • Cost 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_total
  • Website 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_website
  • Cost 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_website
  • Mobile 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_app
  • Cost 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_app
  • Offline 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_offline
  • Cost 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_offline
  • In-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_app
  • Cost 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_app
  • In-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_app
  • Cost 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_app
  • Estimated 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_confirm
  • Cost 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_confirm
  • Calls 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_placed
  • Cost 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_placed
  • 20s 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_connect
  • Cost 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_connect
  • 60s 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_connect
  • Cost 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_connect
  • Cost 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_engagement
  • Cost 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_engagement
  • On-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_grouped
  • Cost 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_grouped
  • Total 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_install
  • Cost per Purchases

    The average cost per Purchases. This metric measures the efficiency of your spend, divided by Purchases.

    fb_ads:spend_omni_purchase
  • Content 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_content
  • Achievements 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_unlocked
  • Cost 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_unlocked
  • App 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_app
  • Cost 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_app
  • Levels 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_achieved
  • Cost 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_achieved
  • Ratings Submitted

    The number of user ratings submitted for your mobile app or platform. This metric reflects user feedback and sentiment.

    fb_ads:actions_omni_rate
  • Cost 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_rate
  • Conversion 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_credits
  • Completed 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_completion
  • Cost 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_completion
  • Custom 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_custom
  • Cost 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_custom
  • Currency

    The currency of the account.

    fads:account_currency
  • Account ID

    The ID of the account.

    fads:account_id
  • Account Name

    The name of the account.

    fads:account_name
  • Estimated 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_bound
  • Action Values

    The values associated with actions.

    fads:action_values
  • 100% Watched Video Watched Actions

    The number of actions taken during 100% watched videos.

    fads:video_p100_watched_actions
  • Conversions

    The number of times a desired action was taken.

    fads:conversions
  • Cost Per Conversion

    The cost per conversion for the campaign.

    fads:cost_per_conversion
  • Instagram 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_visits
  • Cost 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_visits
  • Instagram 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_follow
  • Cost 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_follow
  • Landing 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_rate
  • Engagement Spend

    Total amount spent on campaigns with the engagement objective, including post engagement, page likes, video views, and event responses.

    fb_ads:spend_engagement
  • Video 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_rate
  • Connect 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_age
  • Impressions 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_gender
  • Impressions 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_hour
  • Reach 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_platform
  • Amount invested per day

    This chart shows the amount invested per day during the analysis period.

    fb_ads:spend_by_date
  • Clicks 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_date
  • Amount 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_date
  • Instagram 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_date
  • Instagram 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:ads
  • Catalog Ads

    Performance breakdown by product from your catalog ads, showing spend, impressions, clicks and purchases for each product.

    fb_ads:catalog_ads
  • Conversions 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_type
  • Conversions 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_platform
  • Performance 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_position
  • Regions 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_region
  • Featured campaigns

    Campaigns that had the greatest impact on your audience, during the period analyzed.

    fb_ads:insights_by_campaign
  • Featured ad set

    Summary of key data for ad sets for the period analyzed.

    fb_ads:adset
  • Performance by Platform by device

    Summary of key data for platform for the period analyzed.

    fb_ads:performance_by_platform
  • Performance 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_country
  • Performance by text creative

    Performance breakdown by dynamic creative text asset, showing how each copy variation performs across key metrics.

    fb_ads:dynamic_creative
  • Performance by image creative

    Performance breakdown by dynamic creative image asset, showing how each image variation performs across key metrics.

    fb_ads:dynamic_creative_image
  • Ads 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_ads
  • Performance 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.