When you connect Facebook Ads, you first choose the type of metrics: Regular or Reach and frequency. Then you pick a Level, the field groups you want and, optionally, a breakdown. If you are unsure, start with Regular metrics at the most detailed level, Campaign, Ad Set and Ad. The two metric types are not interchangeable: fields and totals can differ, so compare Funnel to the matching report in Meta Ads Manager.
Which report type should you choose?
Report type | When to use it |
Regular | Use this for spend, clicks, conversions and other metrics you can add up across days, campaigns and ads. Start here if you are unsure. |
Reach and frequency | Use this for reach and frequency over a time window you choose, such as 7 days or a calendar month. Reach counts unique people, so you can't add it up across days or campaigns. |
Level, field groups and attribution
Level: Choose how detailed the data is. For Regular metrics, the options are Account, Campaign, Campaign and Ad Set, or Campaign, Ad Set and Ad. For Reach and frequency, choose Account, Campaign, Ad Set or Ad.
Time Window: For Reach and frequency only. Choose 1 Day, 7 Day (Weekly), 14 Day, 30 Day, 90 Day, 1 Year or Calendar Month (Monthly).
Additional field groups: Standard fields are always included. Select more field groups to add the fields listed under them below. For Regular metrics, you can select Actions and conversions, Video metrics, Ad creative data, Shared Items and Ad relevance. For Reach and frequency, you can select Actions and conversions, Video metrics, Awareness, Ad creative data and Ad relevance.
Attribution options: Select Use Attribution Setting to use the attribution setting of each ad set, or Use Attribution Windows to choose click-through and view-through windows. See Facebook Ads: What is attribution setting?.
Custom conversions in your account are included when you select Actions and conversions.
Not all field groups work with all breakdowns. See Facebook Ads: Compatible field groups and breakdowns. Some metrics may not be available with some breakdowns. See the Meta Marketing API insights reference.
For more on connecting, see How to connect Facebook Ads.
Breakdowns
Under Breakdowns when you connect, select one breakdown or combination to add these dimensions. Meta estimates the values for most breakdowns.
Age: The age range of the people who saw your ads.
Gender: The gender of the people who saw your ads.
Country: The country where people lived or were located when they saw your ads, based on your location targeting.
Region: The region, such as state or province, where people lived or were located when they saw your ads.
DMA Region: The US designated marketing area (DMA), a media market reached by TV, radio, newspapers and other media. Ads delivered outside the US show as Non-DMA Region.
Comscore Market: The Comscore Market, Meta's US local market geography based on ZIP codes. Use it instead of, or as well as, DMA Region.
Comscore Market ID: The numeric ID of the Comscore Market. Available with the Comscore Market breakdown.
Impression Device: The device people were using when they saw your ads.
Device Platform: The device platform people were using when they saw your ads, for example Desktop or Mobile App.
Conversion Device: The device people were using when they took an action as a result of your ads.
Platform: Where your ad was shown, for example Facebook or Instagram.
Placement: The placement where your ad was shown, for example Facebook desktop News Feed or Instagram mobile News Feed.
Carousel Card ID: The ID of each card in a carousel ad. Regular metrics only.
Carousel Card Name: The name of each card in a carousel ad. Regular metrics only.
Destination: The URL people went to after clicking your ad.
Audience Segment: The user segment, for example new or existing, in Advantage+ shopping campaigns. Existing users are set by the custom audience in the campaign settings. Regular metrics only.
Product ID: The product ID. Only available for ads connected to a catalog.
Post Reaction Type: The reactions on your ads or boosted posts: Like, Love, Haha, Wow, Sad or Angry.
Time of Day (Viewer's Time Zone): The time of day in the time zone where the ad was viewed. Regular metrics only.
Time of Day (Ad Account Time Zone): The time of day in the ad account's time zone. Regular metrics only.
Note: Product ID only works with Dynamic Product Ads. If your ad account has other ads, you only see part of your data. Product ID is also very detailed, so Funnel may not be able to get historical data for it.
Note: Meta only provides Time of Day data, and Reach and frequency data with breakdowns, for the last 13 months.
Combining breakdowns with Ad creative data can create very large amounts of data. Consider creating separate data sources.
Dynamic Creative Asset breakdowns
These breakdowns only work with dynamic ads. If your ad account has other ads, you only see part of your data. With Reach and frequency, these breakdowns limit the metrics to Reach and Frequency.
Call To Action (Dynamic Creative Asset): The call to action of the dynamic creative asset.
Call To Action Asset ID (Dynamic Creative Asset): The asset ID of the call to action.
Description Text (Dynamic Creative Asset): The description text of the dynamic creative asset.
Description Asset ID (Dynamic Creative Asset): The asset ID of the description.
Headline Text (Dynamic Creative Asset): The headline (ad settings) text of the dynamic creative asset.
Headline Asset ID (Dynamic Creative Asset): The asset ID of the headline.
Image Asset ID (Dynamic Creative Asset): The ID of the image.
Image Hash (Dynamic Creative Asset): The image hash of the dynamic creative asset.
Image Name (Dynamic Creative Asset): The image name of the dynamic creative asset.
Image URL (Dynamic Creative Asset): The image URL of the dynamic creative asset.
Text (Dynamic Creative Asset): The body text of the dynamic creative asset.
Text Asset ID (Dynamic Creative Asset): The asset ID of the body text.
Video Asset ID (Dynamic Creative Asset): The asset ID of the video.
Video ID (Dynamic Creative Asset): The video ID of the dynamic creative asset.
Video Name (Dynamic Creative Asset): The video name of the dynamic creative asset.
Video Thumbnail Hash (Dynamic Creative Asset): The video thumbnail hash of the dynamic creative asset.
Video Thumbnail URL (Dynamic Creative Asset): The video thumbnail URL of the dynamic creative asset.
Video URL (Dynamic Creative Asset): The video URL of the dynamic creative asset.
Website URL (Dynamic Creative Asset): The website URL of the dynamic creative asset.
Website URL Asset ID (Dynamic Creative Asset): The asset ID of the website URL.
Regular metrics
Standard fields are always included. The other groups are only included if you select them under Additional field groups when you connect. Ad relevance and Ad creative data are dimension groups.
Dimensions
Standard
Ad Account ID: The ID of the ad account.
Ad Account Name: The name of the ad account.
Ad Account Status: The status of the ad account.
Ad Effective Status: The effective status of an ad at the time of download.
Ad End Time: An optional parameter that defines the end time of an individual ad. If no end time is defined, the ad will run on the campaign's schedule. This parameter is only available for sales and app promotion campaigns.
Ad ID: The unique ID of the ad you're viewing in reporting.
Ad Labels: Comma-separated list of the ad labels associated with the ad, used for categorisation and grouping.
Ad Name: The name of the ad you're viewing in reporting.
Ad Set Effective Status: The effective status of an ad set at the time of download.
Ad Set End Time: The end time of the ad set.
Ad Set ID: The unique ID of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
Ad Set Labels: Comma-separated list of the ad labels associated with the ad set, used for categorisation and grouping.
Ad Set Name: The name of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
Ad Set Start Time: The start time of the ad set.
Ad Start Time: An optional parameter that defines the start time of an individual ad. If no start time is defined, the ad will run on the campaign's schedule. This parameter is only available for sales and app promotion campaigns.
Attribution Setting: The attribution setting of the Ad/Ad set/Campaign. Available if "Use Attribution Setting" is chosen on connect.
Attribution Window: The attribution_window filter determines the lookback window over which Facebook aggregates Insights metrics. Available if attribution windows chosen on connect.
Buying Type: The method by which you pay for and target ads in your campaigns: through dynamic auction bidding, fixed-price bidding, or reach and frequency buying. This field is currently only visible at the campaign level.
Campaign Advantage State: Which Advantage+ campaign type, if any, is enabled for the campaign.
Campaign Effective Status: The effective status of a campaign at the time of download.
Campaign End Time: Merging of end times for the ad sets belonging to this campaign, if available.
Campaign ID: The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
Campaign Labels: A comma-separated list of the ad labels associated with the campaign. Use this field to categorize and group campaigns.
Campaign Name: The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
Campaign Objective: The objective reflecting the goal you want to achieve with your advertising. It may be different from the selected objective of the campaign in some cases.
Campaign Result Type: The type of the expected outcome of your ad, based on the objective and settings you selected.
Campaign Smart Promotion Type: The smart promotion creation flow used for the campaign, such as guided creation or smart app promotion.
Campaign Start Time: Merging of start_times for the ad sets belonging to this campaign.
Optimization Goal: The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.
Ad relevance
Ad Conversion Rate Ranking: A ranking of your ad's expected conversion rate. Your ad is ranked against ads with your optimization goal that competed for the same audience.
Ad Engagement Rate Ranking: A ranking of your ad's expected engagement rate. Engagement includes all clicks, likes, comments and shares. Your ad is ranked against ads that competed for the same audience.
Ad Quality Ranking: A ranking of your ad's perceived quality. Quality is measured using feedback on your ads and the post-click experience. Your ad is ranked against ads that competed for the same audience.
Ad creative data
Ad Created Time: The time of creation for an ad.
Ad Creative Asset Ad Formats: The ad formats of an asset ad creative.
Ad Creative Asset Body Texts: The body texts of an asset ad creative.
Ad Creative Asset Image Hashes: The Image Hashes of an asset ad creative Asset Image.
Ad Creative Asset Links: The Ad Asset Links of the ad creative.
Ad Creative Asset Title Texts: The title texts of an asset ad creative.
Ad Creative Boosted Post Carousel CTA Links: The Carousel Call-To-Action Links of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Carousel Links: The Carousel Links of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Descriptions: A list of descriptions of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post ID: The ID of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Instagram Actor Id: The Instagram Actor Id (Instagram Account Id) of the Boosted Post that the Ad Creative is linked to.
Ad Creative Boosted Post Instagram User Id: The Instagram User Id of the Boosted Post that the Ad Creative is linked to.
Ad Creative Boosted Post Link: The call-to-action link of the original Page post used to create a boosted ad. Funnel reads the creative's
effective_object_story_idto identify the source post and returns that post'scall_to_action.value.linkvalue unchanged. This field only appears when the Ad creative data field group is enabled in the connector configuration, and is only relevant for boosted post ad types.Ad Creative Boosted Post Message: The message of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Page Id: The Page Id of the Boosted Post that the Ad Creative is linked to.
Ad Creative Boosted Post Page Name: The name of the page where a boosted post was created.
Ad Creative Boosted Post Permalink URL: The permanent static URL to the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Source Platform: The source platform of the Boosted Post that the Ad Creative is linked to. Can be either Facebook or Instagram.
Ad Creative Boosted Post Titles: A list of titles of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Unshimmed URL: The Unshimmed URL of the boosted post that the ad creative is linked to.
Ad Creative Carousel Descriptions: The descriptions of a carousel ad creative.
Ad Creative Carousel Image Hashes: The Image Hashes of the carousel ad creative.
Ad Creative Carousel Links: The Carousel Links of the ad creative.
Ad Creative Carousel Names: The names of a carousel ad creative.
Ad Creative Carousel Template Links: The Carousel Links of the ad creative.
Ad Creative Image Asset Name: The asset-library file name of the image in the ad creative. This is often "untitled" if no name was set at upload. Available if Ad creative data was selected on connect.
Ad Creative Image Hash: The Image Hash of the ad creative.
Ad Creative Image Layer Hash: The Image Hash of the ad creative Image Layer.
Ad Creative Image Permalink URL: A permanent URL to the image belonging to the ad creative.
Ad Creative Image Permalink URLs: One or more permanent URLs to images belonging to the ad creative.
Ad Creative Image URL: The image URL of the ad creative.
Ad Creative Link: The link of the ad creative.
Ad Creative Link Call To Action Type: The call to action type of a link ad creative.
Ad Creative Link Description: The description of a link ad creative.
Ad Creative Link Message: The message of a link ad creative.
Ad Creative Link Name: The name of a link ad creative.
Ad Creative Page ID: The Page ID of this creative.
Ad Creative Page Name: The Page name of this creative.
Ad Creative Placement Image Hash: The hash of the image the creative's placement customization rules assign to this row's placement. Unlike the other image fields, which report one value per ad on every row of that ad, this field can differ between placements. It is empty when the rules assign no image to the placement, for example when they customize a video there, and whenever the row does not carry what a rule matches on. Requires the 'Platform' breakdown, which every rule is matched against, and the 'Placement' breakdown for the rules that name individual placements rather than a whole platform.
Ad Creative Placement Image Permalink URL: A permanent URL to the image the creative's placement customization rules assign to this row's placement. See Ad Creative Placement Image Hash for when the field is empty and which breakdowns it needs. Facebook signs this URL and returns a different one on every download, so join on Ad Creative Placement Image Hash instead.
Ad Creative Placement Image URL: The URL of the image the creative's placement customization rules assign to this row's placement. See Ad Creative Placement Image Hash for when the field is empty and which breakdowns it needs.
Ad Creative Source Instagram Media ID: The ID of an Instagram post for creating ads.
Ad Creative Template Link: The Template Link of the ad creative.
Ad Creative Thumbnail URL: The Thumbnail URL of the ad creative.
Ad Creative URL Parameters: The Tracking URL parameters (also known as URL tags) of the ad creative.
Ad Creative Video Asset Title: The asset-library title (filename) of the video, fetched from the video object via the video ID nested under
object_story_spec.video_data. This is distinct from Ad Creative Video Title, which readsobject_story_spec.video_data.titledirectly. For regular ads, this field may describe a different video than Ad Creative Video ID and other resolved-ID video columns. Available if Ad creative data was selected on connect.Ad Creative Video Call To Action Type: The call to action type of a video creative.
Ad Creative Video Content Categories: One or more categories of the videos in the creative.
Ad Creative Video Content Category: The category of the video in the creative.
Ad Creative Video Data Image Hash: The Image Hash of the ad creative video data.
Ad Creative Video ID: The ID of the video in the creative.
Ad Creative Video IDs: One or more IDs of the videos in the creative.
Ad Creative Video Length: The length of the video in the creative.
Ad Creative Video Lengths: One or more lengths of the videos in the creative.
Ad Creative Video Link: The Video Link of the ad creative.
Ad Creative Video Link Description: The link description of a video creative.
Ad Creative Video Message: The message of a video creative.
Ad Creative Video Permalink URL: The permanent URL for the video in the creative.
Ad Creative Video Permalink URLs: One or more permanent URLs for the videos in the creative.
Ad Creative Video Picture URL: The URL for the thumbnail picture of the video in the creative.
Ad Creative Video Picture URLs: One or more URLs for the thumbnail pictures of the videos in the creative.
Ad Creative Video Source URL: The direct file URL of the single video used in the creative. Available if Ad creative data was selected on connect.
Ad Creative Video Source URLs: One or more direct file URLs for all videos used in the creative. Available if Ad creative data was selected on connect.
Ad Creative Video Thumbnail URLs: A comma separated list of the thumbnail URLs of the videos in the creative, one element per video and in the same order as the videos. An element is empty if Facebook returns no thumbnail for that video. Facebook renders these thumbnails in the ad preview and in the delivered ad. Ad Creative Thumbnail URL gives one 64x64 crop for the whole creative, the icon Business Manager shows next to the ad name. This field gives one larger thumbnail per video.
Ad Creative Video Title: The title of a video creative.
Ad Preview Shareable Link: A link that enables users to preview an ad.
Creative ID: The ID of the creative.
Creative Media Type: View your data by Media Type.
Creative Object Type: The type of object that is being advertised.
Link: The destination URL that the call-to-action button or link in your ad sends people to. Funnel takes this from the first place it finds a link in the ad creative, so different ad formats (video, carousel, dynamic, boosted post) can get their link from different places.
Metrics
Standard
Amount Spent: The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.
Bid Amount: Bid cap or target cost for an ad or ad set.
Campaign Result value: The number of times your ad achieved an outcome, based on the objective and settings you selected. In some cases, this metric may be estimated and reported by a third party API.
Clicks (all): The number of clicks on your ads.
CPC (Cost per Link Click): The average cost for each link click.
CPM (Cost per 1,000 Impressions): The average cost for 1,000 impressions.
CTR (Link Click-Through Rate): The percentage of times people saw your ad and performed a link click.
Daily budget: The daily budget of the campaign. Available at both ad set and campaign levels.
Impressions: The number of times your ads were on screen.
Instagram Follows: The number of Instagram profile follows attributed to your ads.
Lifetime Budget: The lifetime budget of the campaign. Available at both ad set and campaign levels.
Net Reminders On: The number of reminders turned on for your event, attributed to your ads, not including reminders that were turned off before the event starts.
Outbound CPC (Cost per Outbound Click): The average cost for each outbound click.
Outbound CTR (Outbound Click-Through Rate): The percentage of times people saw your ad and performed an outbound click.
Actions and conversions
Some of these metrics might not be available if you select a breakdown by Dynamic Creative Asset.
100% In-View Impressions: The number of Full Views on your Page's posts as a result of your ad.
20s Calls placed: The number of 20 second calls placed.
3-Second Video Views: The number of times your video was watched for an aggregate of at least 3 seconds, or for nearly its total length, whichever happened first.
60s Calls placed: The number of 60 second calls placed.
Achievements Unlocked: The number of unlock achievement events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Achievements Unlocked Conversion Value: The total value of achievements unlocked tracked with the conversions objective.
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.
Adds of Payment Info Conversion Value: The total value of adds of payment info tracked with the conversions objective.
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.
Adds to Cart Conversion Value: The total value of adds to cart tracked with the conversions objective.
Adds to Wishlist: The number of add to wishlist events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Adds to Wishlist Conversion Value: The total value of adds to wishlist tracked with the conversions objective.
App Activations: The number of times your app was activated attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
App Activations Conversion Value: The total value of app activations tracked with the conversions objective.
App Installs: The number of app installs that were recorded as app events and attributed to your ads.
Applications Submitted: The number of submit application events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Appointment Schedule Conversion Value: The total value of appointment schedule conversions.
Appointments Scheduled: The number of schedule events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Blocked Messaging Connections: The number of times that people blocked a messaging connection with your business, attributed to your ads.
Calls placed: The number of calls placed.
Check-ins: The number of check-ins to your Page as a result of your ad. This is only available to Pages that are associated with a physical address.
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.
Checkouts Initiated Conversion Value: The total value of checkouts initiated tracked with the conversions objective.
Contact Conversion Value: The total value of contact conversions.
Contacts: The number of contact events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Content Views: The number of view content events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Content Views Conversion Value: The total value of content views tracked with the conversions objective.
Cost per 1,000 In-App Ad Impressions: The average cost for 1,000 in-app ad impressions.
Cost per 3-Second Video View: The average cost for each 3-second video view.
Cost per Achievement Unlocked: The average cost for each achievement unlocked.
Cost per Add to Cart: The average cost of each add to cart.
Cost per App Activation: The average cost for each app activation.
Cost per App Install: The average cost for each app install.
Cost Per Appointment Scheduled: The average Cost of each Appointment Scheduled.
Cost per Check-in: The average cost for each check-in as a result of your ad.
Cost per Checkout Initiated: The average cost of each checkout initiated.
Cost Per Contact: The average Cost of each Contact.
Cost per Content View: The average cost of each content view.
Cost per Credit Spend: The average cost of each credit spend.
Cost per Custom Event: The average cost of each custom event.
Cost per Desktop App Engagement: The average cost per action related to the application as a result of your ad.
Cost per Desktop App Install: The average cost per install of your app as a result of your ad.
Cost per Desktop App Story Engagement: The average cost per action related to the application story as a result of your ad.
Cost per Desktop App Use: The average cost for each app use as a result of your ad.
Cost Per Donation: The average Cost of each Donation.
Cost per Event Response: The average cost for each event response.
Cost per Game Play: The cost for each desktop game play.
Cost Per In-App Ad Click: The average cost for an in-app ad click from your Facebook ads.
Cost per Landing Page View: The average cost for each landing page view.
Cost per Lead: The average cost of each lead.
Cost per Level Achieved: The average cost for each level achieved.
Cost Per Location Search: The average Cost of each Location Search.
Cost per Mobile App Action: The average cost for each mobile app action.
Cost Per Mobile App Application Submitted: The average Cost of each Mobile App Application Submitted.
Cost Per Mobile App Appointment Scheduled: The average Cost of each Mobile App Appointment Scheduled.
Cost Per Mobile App Contact: The average Cost of each Mobile App Contact.
Cost per Mobile App Content View: The average cost for each mobile app content view.
Cost Per Mobile App Donation: The average Cost of each Mobile App Donation.
Cost per Mobile App Install: The average cost for each mobile app install as a result of your ad.
Cost Per Mobile App Location Search: The average Cost of each Mobile App Location Search.
Cost per Mobile App Purchase: The average cost for each mobile app purchase.
Cost per Mobile App Registration Completed: The average cost for each mobile app registration.
Cost per Mobile App Search: The average cost for each mobile app search.
Cost per Mobile App Session: The average cost for each mobile app session.
Cost Per Mobile App Subscription: The average Cost of each Mobile App Subscription.
Cost Per Mobile App Trial Started: The average Cost of each Mobile App Trial Started.
Cost Per New Messaging Connection: The average cost for each new messaging connection.
Cost per Offline Other Conversion: The average cost for each other (offline conversion).
Cost per offline purchase: The average cost for each purchase (offline conversion).
Cost per Other Mobile App Action: The average cost for each other mobile app action.
Cost per Page Engagement: The average cost per action related to your Page and your Page's posts as a result of your ad.
Cost per Page Like: The average cost for each Page like as a result of your ad.
Cost per Page Mention: The average cost for each Page mention as a result of your ad.
Cost per Page Tab View: The average cost of each Facebook Page tab view.
Cost per Photo View: The average cost for each photo view.
Cost per Post Comment: The average cost for each comment on your Page's posts as a result of your ad.
Cost per Post Engagement: The average cost per action related to your Page's posts as a result of your ad.
Cost per Post Reaction: The average cost for each post reaction.
Cost per Post Share: The average cost of each post share.
Cost per Purchase: The average cost of each purchase.
Cost per Rating Submitted: The average cost for each rating.
Cost per Registration Completed: The average cost of each registration completed.
Cost per Search: The average cost of each search.
Cost per Submit Application: The average cost of each submit application.
Cost Per Subscription: The average Cost of each Subscription.
Cost per ThruPlay: The average cost for each ThruPlay.
Cost Per Trial Started: The average Cost of each Trial Started.
Cost per Tutorial Completed: The average cost for each tutorial completion.
Cost per Website Add of Payment Info: The average cost for each payment information action tracked by your Facebook pixel on your website after people clicked on or viewed your ad.
Cost per Website Add to Cart: The average cost for each add-to-cart action tracked by your Facebook pixel on your website after people clicked on or viewed your ad.
Cost per Website Add to Wishlist: The average cost for each add-to-wishlist action tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost Per Website Application Submitted: The average Cost of each Website Application Submitted.
Cost Per Website Appointment Scheduled: The average Cost of each Website Appointment Scheduled.
Cost per Website Checkout Initiated: The average cost for each checkout action tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost Per Website Contact: The average Cost of each Website Contact.
Cost per Website Content Views: The average cost for each content view action tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost per Website Conversion: The average cost of each website conversion.
Cost Per Website Donation: The average Cost of each Website Donation.
Cost per Website Lead: The average cost for leads tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost Per Website Location Search: The average Cost of each Website Location Search.
Cost per Website Purchase: The average cost for each purchase tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost per Website Registration Completed: The average cost for each registration tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost per Website Search: The average cost for each search action tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Cost Per Website Subscription: The average Cost of each Website Subscription.
Cost Per Website Trial Started: The average Cost of each Website Trial Started.
Credit Spends: The number of spend credits events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools. This does not refer to the total value of credits spent.
Credit Spends Conversion Value: The total value of spend credits conversions.
Custom Events: The number of custom events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Customize Product Conversion Value: The total value of customize product conversions.
Desktop App Credit Spends: The number of credits used in your desktop game app that were recorded as app events and attributed to your ads.
Desktop App Engagement: The number of actions, including app installs, credit spends and uses as a result of your ad.
Desktop App Installs: The number of app installs as a result of your ad.
Desktop App Story Engagement: The number of actions related to the application story as a result of your ad.
Desktop App Uses: The number of uses of your app as a result of your ad. This includes number of times your app was used for a minimum of 4 minutes in the last 14 days, or at least twice by the same person with one of those times occurring in the past 14 days.
Desktop Credit Spends Conversion Value: The total value returned from credit spends that were attributed to your ads. This is based on the value that you assigned when you set up the app event.
Donate Conversion Value: The total value of donate conversions.
Donations: The number of donate events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Estimated Call Confirmation Clicks: The estimated number of times that the call button is clicked on a call confirmation dialogue after an ad with a call destination is clicked.
Event Responses: The number of people who responded Interested or Going to your Facebook event, attributed to your ads.
Find Location Conversion Value: The total value of find location conversions.
Game Plays: The number of game play events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
In-App Ad Clicks: The number of in-app ad click events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
In-App Ad Impressions: The number of in-app ad impression events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Landing Page Views: The number of times a person clicked on an ad link and then successfully loaded the destination webpage. To report on landing page views, you must have the Facebook pixel implemented on your webpage.
Leads: The number of leads attributed to your ads from Facebook-owned properties (including forms and Messenger) as well as off-Facebook leads tracked by one or more of your connected Facebook Business Tools.
Leads (Form): The number of form responses submitted after people clicked on Facebook lead ads.
Leads Conversion Value: The total value of leads tracked with the conversions objective.
Levels Achieved: The number of achieve level events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Levels Achieved Conversion Value: The total value of levels achieved tracked with the conversions objective.
Link Clicks: The number of clicks on ad links to select destinations or experiences, on or off Facebook-owned properties.
Location Searches: The number of find location events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Messaging Conversations Started: The number of times people started messaging your business after at least 7 days of inactivity, attributed to your ads.
Messaging Replies: The number of messaging replies that people sent to your business, attributed to your ads.
Mobile App Achievements Unlocked: The number of features, levels or achievements unlocked in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Achievements Unlocked Conversion Value
Mobile App Actions: The number of actions in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Actions Conversion Value: The total value returned from mobile app actions. This is based on the value that you assigned when you set up the app event.
Mobile App Adds of Payment Info: The number of times payment information was entered in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Adds of Payment Info Conversion Value: The total value returned from mobile app adds of payment info.
Mobile App Adds to Cart: The number of times items were added to a shopping cart in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Adds to Cart Conversion Value: The total value returned from mobile app adds to cart. This is based on the value that you assigned when you set up the app event.
Mobile App Adds to Wishlist: The number of times items were added to a wishlist in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Adds to Wishlist Conversion Value: The total value returned from mobile app adds to wishlist. This is based on the value that you assigned when you set up the app event.
Mobile App Applications Submitted: The number of submit application events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Appointments Scheduled: The number of schedule events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Checkouts Initiated: The number of checkouts started in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Checkouts Initiated Conversion Value
Mobile App Contact Conversion Value: The total value of contact conversions that occurred on your mobile app.
Mobile App Contacts: The number of contact events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Content Views: The number of content views in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Content Views Conversion Value: The total value returned other from content views in your mobile app. This is based on the value that you assigned when you set up the app event.
Mobile App Credits Spent: The number of credits spent in your mobile game app that were recorded as app events and attributed to your ads.
Mobile App Credits Spent Conversion Value: The total value returned from mobile app credit spends. This is based on the value that you assigned when you set up the app event.
Mobile App Customize Product Conversion Value: The total value of customize product conversions that occurred on your mobile app.
Mobile App D2 Retention: The number of people who opened your app 24 - 48 hours after installing it. This metric is only available for 7-day and 28-day attribution windows.
Mobile App D7 Retention: The number of people who opened your app 6 - 7 days after installing it. This metric is only available for a 28-day attribution window.
Mobile App Donate Conversion Value: The total value of donate conversions that occurred on your mobile app.
Mobile App Donations: The number of donate events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Find Location Conversion Value: The total value of find location conversions that occurred on your mobile app.
Mobile app installs: The number of installs from a mobile device as a result of your ad.
Mobile App Levels Completed: The number of levels achieved in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Levels Completed Conversion Value
Mobile App Location Searches: The number of find location events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Products Customized: The number of customize product events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Purchases: The number of purchases made in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Purchases Conversion Value: The total value returned from mobile app purchases. This is based on the value that you assigned when you set up the app event.
Mobile App Ratings Submitted: The number of ratings submitted in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Ratings Submitted Conversion Value: The total value returned from mobile app ratings. This is based on the value that you assigned when you set up the app event.
Mobile App Registrations Completed: The number of registrations in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Registrations Completed Conversion Value: The total value returned from mobile app registrations. This is based on the value that you assigned when you set up the app event.
Mobile App Schedule Conversion Value: The total value of schedule conversions that occurred on your mobile app.
Mobile App Searches: The number of searches in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Searches Conversion Value: The total value returned from mobile app searches. This is based on the value that you assigned when you set up the app event.
Mobile App Sessions: The number of new app sessions on a mobile device that were recorded as app events and attributed to your ads.
Mobile App Sessions Conversion Value
Mobile App Start Trial Conversion Value: The total value of start trial conversions that occurred on your mobile app.
Mobile App Submit Application Conversion Value: The total value of submit application conversions that occurred on your mobile app.
Mobile App Subscribe Conversion Value: The total value of subscribe conversions on your mobile app.
Mobile App Subscriptions: The number of subscribe events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Trials Started: The number of start trial events that occurred on your mobile app and are attributed to your ads, based on information received from your Facebook SDK.
Mobile App Tutorials Completed: The number of tutorials completed in your mobile app that were recorded as app events and attributed to your ads.
Mobile App Tutorials Completed Conversion Value: The total value returned from tutorials completed.
New Messaging Connections: The number of people your business added as messaging connections, attributed to your ads.
Offline Other Conversion Value: The total value returned from other (offline conversion) conversions. This is based on the value that you assigned when you set up the offline event.
Offline Other Conversions: The number of other events that were recorded by your offline events data and attributed to your ads.
Offline purchases: The number of purchase events that were recorded by your offline events data and attributed to your adverts.
Offline purchases conversion value: The total value returned from purchase (offline conversion) conversions. This is based on the value you assigned when you set up the offline event.
On Facebook Applications Submitted: The number of submit application events that occurred within a Facebook-owned property (such as Pages or Messenger) and are attributed to your ads.
On Facebook Submit Application Conversion Value: The total value of on-Facebook submit applications that occurred within a Facebook-owned property (such as Pages or Messenger).
On-Facebook Add to Cart: The number of add to cart actions within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads.
On-Facebook Add to Cart Conversion Value: The total value of on-Facebook add to cart actions.
On-Facebook Leads: The number of leads submitted on Facebook-owned property (including forms and Messenger) and attributed to your ads.
On-Facebook Leads Conversion Value: The total value of on-Facebook lead conversions.
On-Facebook Purchase Conversion Value: The total value of on-Facebook purchase conversions.
On-Facebook Purchases: The number of purchases made within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads. Purchases on Facebook may include conversions such as event ticket sales, travel bookings or movie ticket sales that happen directly on Facebook-owned properties.
On-Facebook View Content: The number of product views within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads.
On-Facebook View Content Conversion Value: The total value of content views within a Facebook-owned property.
On-Facebook Workflow Completion Conversion Value: The total value of on-Facebook workflow completion conversions.
On-Facebook Workflow Completions: The number of times a workflow was completed within a Facebook-owned property (such as Pages or Messenger) and attributed to your ads.
Other Mobile App Actions: The number of other actions in your mobile app that were recorded as app events and attributed to your ads.
Other Mobile App Actions Conversion Value: The total value returned other from mobile app actions. This is based on the value that you assigned when you set up the app event.
Outbound Clicks: The number of clicks on links that take people off Facebook-owned properties.
Page Engagement: The number of actions related to the Page and your Page's posts as a result of your ad.
Page Likes: The number of likes on your Page as a result of your ad.
Page Mentions: The number of mentions of your Page as a result of your ad.
Page Tab Views: The number of views of tabs on your Facebook Page that are attributed to your ads. Tabs are customizable navigation located under the Page's cover photo. Page tab views measures how many times people clicked these tabs to view additional content and apps within your Facebook Page.
Photo Views: The number of views of photos on your Page or posts that are attributed to your ads. Photo views are counted when people click on photos to view them.
Post Comments: The number of comments on your Page's posts as a result of your ad.
Post Engagement: The number of actions related to your Page's posts as a result of your ad.
Post Reactions: The number of reactions on your ads. The reactions button on an ad allows people to share different reactions to its content: Like, Love, Haha, Wow, Sad or Angry.
Post Saves: The total number of times your ad has been saved.
Post 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.
Products Customized: The number of customize product events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Purchases: The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Purchases Conversion Value: The total value of purchases tracked with the conversions objective.
Purchases Margin: The total profit margin value of purchases tracked with the conversions objective.
Ratings Submitted: The number of ratings submitted events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Ratings Submitted Conversion Value: The total value returned from ratings submitted. This is based on the value that you assigned when you set up the app event.
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.
Registrations Completed Conversion Value: The total value of registrations completed tracked with the conversions objective.
Searches: The number of search events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Searches Conversion Value: The total value of search conversions.
Start Trial Conversion Value: The total value of start trial conversions.
Submit Application Conversion Value: The total value of applications submitted tracked with the conversions objective.
Subscribe Conversion Value: The total value of subscribe conversions.
Subscriptions: The number of subscribe events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Trials Started: The number of start trial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Tutorials Completed: The number of completed tutorial events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools.
Tutorials Completed Conversion Value: The total value of tutorials completed conversions.
Website Adds of Payment Info: The number of times payment information was entered tracked by your Facebook pixel on your website after people clicked or viewed your ad.
Website Adds of Payment Info Conversion Value: The total value of website adds of payment info conversions.
Website Adds to Cart: The number of times an item was added to a shopping cart tracked by your Facebook pixel on your website after people clicked or viewed your ad.
Website Adds to Cart Conversion Value: The total value of the adds-to-cart tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the adds-to-cart event in your Facebook pixel code.
Website Adds to Wishlist: The number of times an item was added to a wishlist tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Adds to Wishlist Conversion Value: The total value of all website add to wishlist conversions.
Website Applications Submitted: The number of submit application events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Appointments Scheduled: The number of schedule events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Checkouts Initiated: The number of checkout initiations tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Checkouts Initiated Conversion Value: The total value of the checkout actions tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the checkout event in your Facebook pixel code.
Website Contact Conversion Value: The total value of contact conversions that occurred on your website.
Website Contacts: The number of contact events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Content Views: The number of content views tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Content Views Conversion Value: The total value of the content views tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the content view event in your Facebook pixel code.
Website Conversion Value: The total value of website conversions.
Website Conversions: The number of events or conversions recorded by the pixel on your website and attributed to your ads.
Website Customize Product Conversion Value: The total value of customize product conversions that occurred on your website.
Website Donate Conversion Value: The total value of donate conversions that occurred on your website.
Website Donations: The number of donate events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Find Location Conversion Value: The total value of find location conversions that occurred on your website.
Website Leads: The number of leads tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Leads Conversion Value: The total value of the leads tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the website lead event in your Facebook pixel code.
Website Location Searches: The number of find location events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Products Customized: The number of customize product events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Purchases: The number of times a purchase was made tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Purchases Conversion Value: The total value of the purchase actions tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the purchase detail event in your Facebook pixel code.
Website Registrations Completed: The number of registrations tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Registrations Completed Conversion Value: The total value of the registrations tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the registration event in your Facebook pixel code.
Website Schedule Conversion Value: The total value of schedule conversions that occurred on your website.
Website Searches: The number of searches tracked by your Facebook pixel on your website after people viewed or clicked on your ad.
Website Searches Conversion Value: The total value of the searches tracked by your Facebook pixel on your website after people viewed or clicked on your ad. This is based on the value assigned to the search event in your Facebook pixel code.
Website Start Trial Conversion Value: The total value of start trial conversions that occurred on your website.
Website Submit Application Conversion Value: The total value of submit application conversions that occurred on your website.
Website Subscribe Conversion Value: The total value of subscribe conversions that occurred on your website.
Website Subscriptions: The number of subscribe events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Website Trials Started: The number of start trial events that occurred on your website and are attributed to your ads, based on information received from your Facebook pixel.
Video metrics
2-Second Continuous Video Plays: The number of times that your video was played for two continuous seconds or more.
30-Second Video Views: The number of times your video was watched for an aggregate of at least 30 seconds, or for nearly its total length, whichever happened first.
Cost per 2-Second Continuous Video Plays: The average cost for each 2-second video view.
Cost per ThruPlay: The average cost for each ThruPlay.
Cost per Video Play: The average cost for each video play.
Video Plays: The number of times your video starts to play. This is counted for each impression of a video, and excludes replays.
Video thruplay: The number of times your video was played to completion, or for at least 15 seconds.
Video Watches at 100%: The number of times your video was watched at 100% of its length, including watches that skipped to this point.
Video Watches at 25%: The number of times your video was watched at 25% of its length, including watches that skipped to this point.
Video Watches at 50%: The number of times your video was watched at 50% of its length, including watches that skipped to this point.
Video Watches at 75%: The number of times your video was watched at 75% of its length, including watches that skipped to this point.
Video Watches at 95%: The number of times your video was watched at 95% of its length, including watches that skipped to this point.
Shared items
Adds to Cart Conversion Value for Shared Items Only: The total value of the shared items contained in adds to cart with shared items conversions.
Adds to Cart with Shared Items: The number of add to cart events that contain at least one shared item attributed to your ads based on information from one or more of your partner's connected Facebook Business Tools.
Content Views Conversion Value for Shared Items Only: The total value of the shared items contained in content views with shared items conversions.
Content Views with Shared Items: The number of content views events that contain at least one shared item, based on information received from one or more of your partner's connected Facebook Business Tools.
Purchases Conversion Value for Shared Items Only: The total value of the shared items contained in purchases with shared items conversions.
Purchases with Shared Items: The number of purchase events that contain at least one shared item, based on information received from one or more of your partner's connected Facebook Business Tools.
Reach and frequency metrics
Standard fields are always included. The other groups are only included if you select them under Additional field groups when you connect.
Dimensions
Standard
Ad Account ID: The ID of the ad account.
Ad Effective Status: The effective status of an ad at the time of download.
Ad ID: The unique ID of the ad you're viewing in reporting.
Ad Name: The name of the ad you're viewing in reporting.
Ad Set Effective Status: The effective status of an ad set at the time of download.
Ad Set ID: The unique ID of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
Ad Set Name: The name of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.
Attribution Setting: The attribution setting of the Ad/Ad set/Campaign. Available if "Use Attribution Setting" is chosen on connect.
Attribution Window: The attribution_window filter determines the lookback window over which Facebook aggregates Insights metrics. Available if attribution windows are selected on connect.
Buying Type: The method by which you pay for and target ads in your campaigns: through dynamic auction bidding, fixed-price bidding, or reach and frequency buying. This field is currently only visible at the campaign level.
Campaign Advantage State: Which Advantage+ campaign type, if any, is enabled for the campaign.
Campaign Effective Status: The effective status of a campaign at the time of download.
Campaign ID: The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
Campaign Labels: A comma-separated list of the ad labels associated with the campaign. Use this field to categorize and group campaigns.
Campaign Name: The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.
Campaign Objective: The objective reflecting the goal you want to achieve with your advertising. It may be different from the selected objective of the campaign in some cases.
Campaign Smart Promotion Type: The smart promotion creation flow used for the campaign, such as guided creation or smart app promotion.
Optimization Goal: The optimization goal you selected for your ad or ad set. Your optimization goal reflects what you want to optimize for the ads.
Ad relevance
Ad Conversion Rate Ranking: A ranking of your ad's expected conversion rate. Your ad is ranked against ads with your optimization goal that competed for the same audience.
Ad Engagement Rate Ranking: A ranking of your ad's expected engagement rate. Engagement includes all clicks, likes, comments and shares. Your ad is ranked against ads that competed for the same audience.
Ad Quality Ranking: A ranking of your ad's perceived quality. Quality is measured using feedback on your ads and the post-click experience. Your ad is ranked against ads that competed for the same audience.
Ad creative data
Ad Created Time: The time of creation for an ad.
Ad Creative Asset Ad Formats: The ad formats of an asset ad creative.
Ad Creative Asset Body Texts: The body texts of an asset ad creative.
Ad Creative Asset Image Hashes: The Image Hashes of an asset ad creative Asset Image.
Ad Creative Asset Links: The Ad Asset Links of the ad creative.
Ad Creative Asset Title Texts: The title texts of an asset ad creative.
Ad Creative Boosted Post Carousel CTA Links: The Carousel Call-To-Action Links of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Carousel Links: The Carousel Links of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Descriptions: A list of descriptions of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post ID: The ID of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Link: The call-to-action link of the original Page post used to create a boosted ad. Funnel reads the creative's
effective_object_story_idto identify the source post and returns that post'scall_to_action.value.linkvalue unchanged. This field only appears when the Ad creative data field group is enabled in the connector configuration, and is only relevant for boosted post ad types.Ad Creative Boosted Post Message: The message of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Page Name: The name of the page where a boosted post was created.
Ad Creative Boosted Post Titles: A list of titles of the boosted post that the ad creative is linked to.
Ad Creative Boosted Post Unshimmed URL: The Unshimmed URL of the boosted post that the ad creative is linked to.
Ad Creative Carousel Descriptions: The descriptions of a carousel ad creative.
Ad Creative Carousel Image Hashes: The Image Hashes of the carousel ad creative.
Ad Creative Carousel Links: The Carousel Links of the ad creative.
Ad Creative Carousel Names: The names of a carousel ad creative.
Ad Creative Carousel Template Links: The Carousel Links of the ad creative.
Ad Creative Image Asset Name: The asset-library file name of the image in the ad creative. This is often "untitled" if no name was set at upload. Available if Ad creative data was selected on connect.
Ad Creative Image Hash: The Image Hash of the ad creative.
Ad Creative Image Layer Hash: The Image Hash of the ad creative Image Layer.
Ad Creative Image URL: The image URL of the ad creative.
Ad Creative Link: The link of the ad creative.
Ad Creative Link Call To Action Type: The call to action type of a link ad creative.
Ad Creative Link Description: The description of a link ad creative.
Ad Creative Link Message: The message of a link ad creative.
Ad Creative Link Name: The name of a link ad creative.
Ad Creative Template Link: The Template Link of the ad creative.
Ad Creative Thumbnail URL: The Thumbnail URL of the ad creative.
Ad Creative URL Parameters: The Tracking URL parameters (also known as URL tags) of the ad creative.
Ad Creative Video Asset Title: The asset-library title (filename) of the video, fetched from the video object via the video ID nested under
object_story_spec.video_data. This is distinct from Ad Creative Video Title, which readsobject_story_spec.video_data.titledirectly. For regular ads, this field may describe a different video than Ad Creative Video ID and other resolved-ID video columns. Available if Ad creative data was selected on connect.Ad Creative Video Call To Action Type: The call to action type of a video creative.
Ad Creative Video Data Image Hash: The Image Hash of the ad creative video data.
Ad Creative Video ID: The ID of the video in the creative.
Ad Creative Video Link: The Video Link of the ad creative.
Ad Creative Video Link Description: The link description of a video creative.
Ad Creative Video Message: The message of a video creative.
Ad Creative Video Picture URL: The URL for the thumbnail picture of the video in the creative.
Ad Creative Video Source URL: The direct file URL of the single video used in the creative. Available if Ad creative data was selected on connect.
Ad Creative Video Source URLs: One or more direct file URLs for all videos used in the creative. Available if Ad creative data was selected on connect.
Ad Creative Video Title: The title of a video creative.
Ad Preview Shareable Link: A link that enables users to preview an ad.
Creative ID: The ID of the creative.
Creative Object Type: The type of object that is being advertised.
Link: The destination URL that the call-to-action button or link in your ad sends people to. Funnel takes this from the first place it finds a link in the ad creative, so different ad formats (video, carousel, dynamic, boosted post) can get their link from different places.
Metrics
Standard
Cost per unique click (all): The average cost for each unique click (all)
Frequency: The average number of times each person saw your ad. This metric is estimated.
Reach: The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people. This metric is estimated.
Reach (Monthly): The number of people who saw your ads at least once during the time period of one month. It will be outputted on the last day of the month. For the ongoing month, it will be outputted on the current date. Available if calendar month was chosen as time window. This metric is estimated.
Reach (Weekly): The number of people who saw your ads at least once during the time period of one week. It will be outputted on the last day of the week (Information on how to adjust the value for the first day of the week can be found here). For the ongoing week, it will be outputted on the current date. Available if 7 day was chosen as time window. This metric is estimated.
Unique clicks (all): The number of people who performed a click (all). (This metric is estimated.)
Actions and conversions
Some of these metrics might not be available if you select a breakdown by Dynamic Creative Asset.
100% In-View Reach: The number of people who performed a Full View on your Page's post as a result of your ad.
Cost per unique link click: The average cost for each unique link click.
Cost per unique outbound click: The average cost for each unique outbound click.
Unique link clicks: The number of people who performed a link click. (This metric is estimated.)
Unique outbound clicks: The number of people who performed an outbound click. (This metric is estimated.)
Video metrics
Video Average Play Time: The average time a video was played, including any time spent replaying the video for a single impression.
Awareness
Cost per Estimated Ad Recall Lift (People): The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives.
Estimated Ad Recall Lift (People): An estimate of the number of additional people who may remember seeing your ads, if asked, within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives.
Estimated Ad Recall Lift Rate: The rate at which an estimated number of additional people, when asked, would remember seeing your ads within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives.
Related articles
API documentation
For full field definitions and updates, see the Meta Marketing API Insights documentation.
Change history
Added Instagram Follows
From 23 Oct, 2026, the Instagram Follows metric is available in Regular metrics. It shows the number of Instagram profile follows attributed to your ads.
Time of Day breakdowns limited to 13 months
From 19 Oct, 2026, data sources with a Time of Day breakdown only get data for the last 13 months, which matches what Meta provides. The same limit applies to Reach and frequency data sources with breakdowns.
Added image and video asset names
From 8 Sep, 2026, Ad Creative Image Asset Name and Ad Creative Video Asset Title are available in the Ad creative data field group.
Added video source URLs
From 4 Sep, 2026, Ad Creative Video Source URL and Ad Creative Video Source URLs are available in the Ad creative data field group. They link directly to the video files.
Added SKAN click attribution window
From 19 Aug, 2026, you can select SKAN Click as a click-through attribution window. It shows SKAdNetwork click-through conversions for iOS app install campaigns.
Added placement image fields
From 14 Aug, 2026, Ad Creative Placement Image Hash, Ad Creative Placement Image URL and Ad Creative Placement Image Permalink URL are available in the Ad creative data field group. They show the image Meta uses for the placement on each row, so they can differ between the rows of one ad.
