Facebook Ads Metrics and Dimensions

Field group
Field
Type
Data type
Description
PerformanceClicks
METRIC
INTEGERThe number of clicks on your ads. It counts multiple types of clicks on your ad, including certain types of interactions with the ad container, links to other destinations, and links to expanded ad experiences.
PerformanceReach
METRIC
INTEGERThe 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
PerformanceImpressions
METRIC
INTEGERThe number of times your ads were on screen
PerformanceActions
METRIC
INTEGERThe total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions.
PerformanceConversions
METRIC
INTEGERThe total number of conversions attributed to your ads, including contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe.
PerformanceConversion Values
METRIC
FLOATThe total value of all conversions attributed to your ads, including contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe.
PerformanceAction values
METRIC
FLOATThe total value of all conversions attributed to your ads.
PerformancePurchase (ROAS) (all)
METRIC
FLOATThe total return on ad spend (ROAS) from purchases across all channels. This is based on information received from one or more of your connected Facebook Business Tools and attributed to your ads.
PerformancePurchase (ROAS) (all) (Collab ads)
METRIC
FLOATTotal return on ad spend (ROAS) from purchases of items shared between Brand and Retailer
PerformancePurchase (ROAS) (Website) (Collab ads)
METRIC
FLOATTotal return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer.
PerformancePurchase (ROAS) (Mobile) (Collab ads)
METRIC
FLOATThe total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer.
PerformanceFrequency
METRIC
FLOATThe average number of times each person saw your ad
PerformanceQuality ranking
METRIC
STRINGAd's perceived quality compared with ads competing for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic and does not apply to campaigns or ad sets, only ads.
PerformanceEngagement Rate Ranking
METRIC
STRINGAd's expected engagement rate compared with ads competing for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic and does not apply to campaigns or ad sets, only ads.
PerformanceConversion Rate Ranking
METRIC
STRINGAd's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is an ad relevance diagnostic and does not apply to campaigns or ad sets, only ads.
PerformanceQuality score (deprecated)
METRIC
FLOATAd's perceived quality compared with ads competing for the same audience
PerformanceEngagement Rate Ranking score (deprecated)
METRIC
FLOATAd's expected engagement rate compared with ads competing for the same audience
PerformanceConversion Rate Ranking score (deprecated)
METRIC
FLOATAd's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience
CostAmount spent
METRIC
CURRENCYThe estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated.
CostAmount spent (social)
METRIC
CURRENCYThe total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this).
CostCPP
METRIC
CURRENCYThe average cost to reach 1,000 people.
CostCPM
METRIC
CURRENCYThe average cost for 1,000 impressions.
CostCPC
METRIC
CURRENCYThe average cost for each click (all).
CostCost Per any Action
METRIC
CURRENCYThe average cost of any action like like, post save, click, etc.
CostCost per conversion
METRIC
CURRENCYThe average cost of a conversion across all channels (i.e. website, mobile app, offline, and on-facebook). Conversions include contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe.
CostCost per thruplay
METRIC
CURRENCYThe average cost for each ThruPlay.
CostCost per unique click (all)
METRIC
CURRENCYThe average cost for each unique click (all).
CostCPC (link)
METRIC
CURRENCYThe average cost of each link click.
CostCost per unique link click
METRIC
CURRENCYThe average cost of each unique link click
CostCost per outbound click
METRIC
CURRENCYThe average cost for each outbound click.
CostCost per unique outbound click
METRIC
CURRENCYThe average cost for each unique outbound click.
Clicks (more)Unique clicks
METRIC
INTEGERThe number of people who performed a click (all). This metric is estimated.
Clicks (more)Link clicks
METRIC
INTEGERThe number of clicks on links to select destinations
Clicks (more)Link clicks (inline)
METRIC
INTEGERThe number of clicks on links to select destinations or experiences, on or off Facebook-owned properties. Link clicks use a fixed 1-day-click attribution window.
Clicks (more)Unique link clicks
METRIC
INTEGERThe number of people who performed a link click. This metric is estimated.
Clicks (more)Outbound clicks
METRIC
INTEGERThe number of clicks on links that take people off Facebook-owned properties.
Clicks (more)Unique outbound clicks
METRIC
INTEGERThe number of people who performed an outbound click. This metric is estimated.
Clicks (more)CTR (all)
METRIC
FLOATThe percentage of times people saw your ad and performed a click (all).
Clicks (more)Unique CTR (all)
METRIC
FLOATThe percentage of people who saw your ad and performed a unique click (all).
Clicks (more)Links CTR
METRIC
FLOATThe percentage of time people saw your ads and performed a link click.
Clicks (more)Outbound CTR
METRIC
FLOATThe percentage of times people saw your ad and performed an outbound click
Clicks (more)Unique Links CTR
METRIC
FLOATThe percentage of times people saw your ad and performed a link click. Links click-through rate uses a fixed 1-day-click attribution window. This metric is estimated.
Clicks (more)Unique Outbound CTR
METRIC
FLOATThe percentage of people who saw your ad and performed an outbound click.
Clicks (more)Estimated Call Confirmation Clicks
METRIC
INTEGERThe estimated number of times that the call button is clicked on a call confirmation dialogue after an ad with a call destination is clicked.
Action / EngagementPage engagements
METRIC
INTEGERThe number of interactions your page received. This can include likes, comments, shares, and clicks on links and call-to-action buttons.
Action / EngagementPage likes
METRIC
INTEGERThe number of likes received in your page.
Action / EngagementPage subscribes
METRIC
INTEGERThe number of people who have subscribed to receive notifications from your facebook page.
Action / EngagementPost comments
METRIC
INTEGERThe number of comments on the posts.
Action / EngagementPost engagements
METRIC
INTEGERThe number of interactions on your posts. This can include likes, comments, shares, and clicks on links and call-to-action buttons.
Action / EngagementPost reactions
METRIC
INTEGERThe number of times people have reacted to your post on your facebook page.
Action / EngagementPost saves
METRIC
INTEGERThe number of times people have saved your post on your facebook page.
Action / EngagementPost shares
METRIC
INTEGERThe number of times people have shared your post on your facebook page.
Action / EngagementPhoto views
METRIC
INTEGERThe number of times a photo has been viewed on your facebook page.
Action / EngagementEvent responses
METRIC
INTEGERThe number of people who have responded to an event on a Facebook page
Action / EngagementLeads (all)
METRIC
INTEGERAll offsite leads plus all On-Facebook leads
Action / EngagementLeads (messenger & forms)
METRIC
INTEGEROn-Facebook leads coming from Messenger and Instant Forms
Action / EngagementLeads (On Facebook)
METRIC
INTEGERAll On-Facebook Leads
Action / EngagementApp Installs (all)
METRIC
INTEGERThe estimated completed app installs across all channels
Action / EngagementAdd to cart (all)
METRIC
INTEGERThe estimated added to carts across all channels
Action / EngagementInitiated Checkouts (all)
METRIC
INTEGERThe estimated checkouts across all channels
Action / EngagementPurchases (all)
METRIC
FLOATThe estimated purchases across all channels
Action / EngagementOn-Facebook purchases
METRIC
FLOATThe number of purchases made through facebook.
Action / EngagementOn-Facebook purchase value
METRIC
FLOATThe total value of on-Facebook purchase conversions.
Action / EngagementPurchases (offline)
METRIC
FLOATThe number of purchases made in a physical store or through other offline channels that are attributed to a facebook ad campaign.
Action / EngagementOn-Facebook workflow completion
METRIC
INTEGEROn-Facebook Workflow Completions
Action / EngagementRegistrations (all)
METRIC
INTEGERThe estimated registrations across all channels.
Action / EngagementApplication submits (all)
METRIC
INTEGERThe number of applications that are submitted through all channels.
Action / EngagementApplication submits (website)
METRIC
INTEGERThe number of applications that are submitted through a website.
Action / EngagementApplication submits (mobile app)
METRIC
INTEGERThe number of applications that are submitted through a mobile app.
Action / EngagementApplication submits (offline)
METRIC
INTEGERThe number of applications that are submitted through offline channels.
Action / EngagementApplication submits (facebook)
METRIC
INTEGERThe number of applications that are submitted through Facebook.
Action / EngagementAppointments Scheduled (all)
METRIC
INTEGERThe number of appointments that are scheduled through all channels.
Action / EngagementAppointments Scheduled (website)
METRIC
INTEGERThe number of appointments that are scheduled through a website.
Action / EngagementAppointments Scheduled (mobile app)
METRIC
INTEGERThe number of appointments that are scheduled through a mobile app.
Action / EngagementAppointments Scheduled (offline)
METRIC
INTEGERThe number of appointments that are scheduled through offline channels.
Action / EngagementTrials Started (all)
METRIC
INTEGERThe number of trials that are started through all channels.
Action / EngagementTrials Started (website)
METRIC
INTEGERThe number of trials that are started through a website.
Action / EngagementTrials Started (mobile app)
METRIC
INTEGERThe number of trials that are started through a mobile app.
Action / EngagementTrials Started (offline)
METRIC
INTEGERThe number of trials that are started through offline channels.
Action / EngagementLocation Searches (total)
METRIC
INTEGERThe number of location searches that are conducted through all channels.
Action / EngagementLocation Searches (website)
METRIC
INTEGERThe number of location searches that are conducted through a website.
Action / EngagementLocation Searches (mobile app)
METRIC
INTEGERThe number of location searches that are conducted through a mobile app.
Action / EngagementLocation Searches (offline)
METRIC
INTEGERThe number of location searches that are conducted through offline channels.
Action / EngagementDonations (all)
METRIC
INTEGERThe number of donations that are made through all channels.
Action / EngagementDonations (website)
METRIC
INTEGERThe number of donations that are made through a website.
Action / EngagementDonations (mobile app)
METRIC
INTEGERThe number of donations that are made through a mobile app.
Action / EngagementDonations (offline)
METRIC
INTEGERThe number of donations that are made through offline channels.
Action / EngagementProducts Customized (all)
METRIC
INTEGERThe number of products that are customized through all channels.
Action / EngagementProducts Customized (website)
METRIC
INTEGERThe number of products that are customized through a website.
Action / EngagementProducts Customized (mobile app)
METRIC
INTEGERThe number of products that are customized through a mobile app.
Action / EngagementProducts Customized (offline)
METRIC
INTEGERThe number of products that are customized through offline channels.
Action / EngagementContacts (all)
METRIC
INTEGERThe number of contacts that are made through all channels.
Action / EngagementContacts (website)
METRIC
INTEGERThe number of contacts that are made through a website.
Action / EngagementContacts (mobile app)
METRIC
INTEGERThe number of contacts that are made through a mobile app.
Action / EngagementContacts (offline)
METRIC
INTEGERThe number of contacts that are made through offline channels.
Action / EngagementContent Views (all)
METRIC
INTEGERThe estimated content viewed across all channels.
Action / EngagementLevels Achieved (all)
METRIC
INTEGERThe estimated Levels Achieved across all channels.
Action / EngagementAchievements Unlocked (all)
METRIC
INTEGERThe estimated Achievements Unlocked across all channels.
Action / EngagementApp Activations (all)
METRIC
INTEGERThe estimated App Activations across all channels.
Action / EngagementRatings Submitted (all)
METRIC
INTEGERThe estimated Ratings Submitted across all channels.
Action / EngagementCredit Spends (all)
METRIC
FLOATThe estimated Credit Spends across all channels.
Action / EngagementTutorials Completed (all)
METRIC
INTEGERThe estimated Tutorials Completed across all channels.
Action / EngagementSearches (all)
METRIC
INTEGERThe estimated Searches across all channels.
Action / EngagementCheck-ins
METRIC
INTEGERThe number of times people have checked in to a location using Facebook
Action / EngagementSubscriptions
METRIC
INTEGERThe number of people who have subscribed to a page or profile on facebook.
Action / EngagementWebsite subscriptions
METRIC
INTEGERThe number of people who have subscribed to receive notifications or updates from a website through facebook.
Action / EngagementMobile app subscriptions
METRIC
INTEGERThe number of people who have subscribed to receive notifications or updates from a mobile app.
Action / EngagementOffline subscriptions
METRIC
INTEGERThe number of subscriptions that are attributed to a facebook ad campaign, but that take place offline in a physical location or through other offline channels.
Action / EngagementPhone number clicks (On Facebook)
METRIC
INTEGERThe number of times your phone number or Call Now button was clicked.
Action / EngagementPhone calls placed
METRIC
INTEGERThe number of times that a phone call was made to your business from an action taken on an ad
Action / EngagementPhone calls placed (20s)
METRIC
INTEGERThe number of times that phone calls placed resulted in successful connections lasting at least 20 seconds
Action / EngagementPhone calls placed (60s)
METRIC
INTEGERThe number of times that phone calls placed resulted in successful connections lasting at least 60 seconds
Action / EngagementGet directions clicks (On Facebook)
METRIC
INTEGERThe number of times your address or the Get Directions button was clicked.
Conversions ValuePurchases value (offline)
METRIC
FLOATThe total value of purchases made in a physical store or through other offline channels that are attributed to a facebook ad campaign.
Conversions ValuePurchases value (all)
METRIC
FLOATThe total value of the purchases made.
Conversions ValueSubscribe value (total)
METRIC
CURRENCYThe total value of subscribe conversions.
Conversions ValueSubscribe value (website)
METRIC
CURRENCYThe total value of subscribe conversions that occurred on your website.
Conversions ValueSubscribe value (mobile)
METRIC
CURRENCYThe total value of subscribe conversions on your mobile app.
Conversions ValueSubscribe value (offline)
METRIC
CURRENCYThe total value of subscribe conversions that occurred offline.
Conversions ValueDonation value (total)
METRIC
CURRENCYThe total value of donate conversions.
Conversions ValueDonation value (website)
METRIC
CURRENCYThe total value of donate conversions that occurred on your website.
Conversions ValueDonation value (on facebook)
METRIC
CURRENCYThe total value of on-Facebook donations that occurred within a Facebook-owned property (such as Pages or Messenger).
Conversions ValueDonation value (mobile)
METRIC
CURRENCYThe total value of donate conversions that occurred on your mobile app.
Conversions ValueDonation value (offline)
METRIC
CURRENCYThe total value of donate conversions that occurred offline.
Action / Engagement costCost per page engagement
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of page engagements it receives.
Action / Engagement costCost per link click
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of link clicks it receives.
Action / Engagement costCost per page like
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of likes that it receives on a facebook page.
Action / Engagement costCost per post comment
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of comments that it receives on a post.
Action / Engagement costCost per post engagement
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of engagements that it receives on a post
Action / Engagement costCost per post reaction
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of post reactions made.
Action / Engagement costCost per post save
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of post saves.
Action / Engagement costCost per post share
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of post shares.
Action / Engagement costCost per photo view
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of views received on the photos your facebook page.
Action / Engagement costCost per video view
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of view views on your facebook page.
Action / Engagement costCost per event response
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of event responses received.
Action / Engagement costCost per Lead (all)
METRIC
CURRENCYAll offsite leads plus all On-Facebook leads
Action / Engagement costCost per Lead (messenger & forms)
METRIC
CURRENCYOn-Facebook leads coming from Messenger and Instant Forms
Action / Engagement costCost per Lead (On Facebook)
METRIC
CURRENCYThe cost of all On-Facebook Leads
Action / Engagement costCost per App Install (all)
METRIC
CURRENCYThe cost of an estimated completed app install across all channels
Action / Engagement costCost per Add to cart (all)
METRIC
CURRENCYThe cost of an estimated added to cart across all channels
Action / Engagement costCost per Initiated Checkout (all)
METRIC
CURRENCYThe cost of an estimated checkout across all channels
Action / Engagement costCost per Purchase (all)
METRIC
CURRENCYThe cost of an estimated purchases across all channels
Action / Engagement costCost per Purchase (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of purchases made in a physical store or through other offline channels that are attributed to the campaign.
Action / Engagement costCost per Registration (all)
METRIC
CURRENCYCost per registration across all channels.
Action / Engagement costCost per Content View (all)
METRIC
CURRENCYCost per content viewed across all channels.
Action / Engagement costCost per Level Achieved (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of levels that are achieved in a game or app.
Action / Engagement costCost per Achievement Unlocked (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of achievements that are unlocked in a game or app.
Action / Engagement costCost per App Activation (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of times that an app is activated or downloaded.
Action / Engagement costCost per Rating Submitted (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of ratings that are submitted for a game or app.
Action / Engagement costCost per Credit Spend (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the amount of in-game or in-app credits that are spent.
Action / Engagement costCost per Tutorial Completed (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of tutorials that are completed in a game or app.
Action / Engagement costCost per Search (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of searches that are conducted within a game or app.
Action / Engagement costCost per check-in
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of check-ins that are made at a location.
Action / Engagement costCost per Subscription (all)
METRIC
CURRENCYThe cost of each subscription.
Action / Engagement costCost per Subscription (website)
METRIC
CURRENCYThe cost of each website subscription.
Action / Engagement costCost per Application (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of applications that are submitted through all channels.
Action / Engagement costCost per Application (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of applications that are submitted through a website.
Action / Engagement costCost per Application (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of applications that are submitted through a mobile app.
Action / Engagement costCost per Application (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of applications that are submitted through offline channels.
Action / Engagement costCost per Application (facebook)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of applications submitted through Facebook.
Action / Engagement costCost per Appointment Scheduled (all)
METRIC
CURRENCYCost per Appointment Scheduled all
Action / Engagement costCost per Appointment Scheduled (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of appointments that are scheduled through a website.
Action / Engagement costCost per Appointment Scheduled (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of appointments that are scheduled through a mobile app.
Action / Engagement costCost per Appointment Scheduled (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of appointments that are scheduled through offline channels.
Action / Engagement costCost per Trial Started (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of trials that are started through all channels.
Action / Engagement costCost per Trial Started (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of trials that are started through a website.
Action / Engagement costCost per Trial Started (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of trials that are started through a mobile app.
Action / Engagement costCost per Trial Started (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of trials that are started through offline channels.
Action / Engagement costCost per Location Searches (total)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of location searches that are conducted through all channels.
Action / Engagement costCost per Location Searches (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of location searches that are conducted through a website.
Action / Engagement costCost per Location Searches (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of location searches that are conducted through a mobile app.
Action / Engagement costCost per Location Searches (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of location searches that are conducted through offline channels.
Action / Engagement costCost per Donation (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of donations that are made through all channels.
Action / Engagement costCost per Donation (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of donations that are made through a website.
Action / Engagement costCost per Donation (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of donations that are made through a mobile app.
Action / Engagement costCost per Donation (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of donations that are made through offline channels.
Action / Engagement costCost per Product Customized (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of products that are customized through all channels.
Action / Engagement costCost per Product Customized (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of products that are customized through a website.
Action / Engagement costCost per Product Customized (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of products that are customized through a mobile app.
Action / Engagement costCost per Product Customized (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of products that are customized through offline channels.
Action / Engagement costCost per contacts (all)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of contacts that are made through all channels.
Action / Engagement costCost per contacts (website)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of contacts that are made through a website.
Action / Engagement costCost per contacts (mobile app)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of contacts that are made through a mobile app.
Action / Engagement costCost per contacts (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of contacts that are made through offline channels.
Unique Action / EngagementUnique Page engagements
METRIC
FLOATThe number of users who have engaged with a Facebook page.
Unique Action / EngagementUnique Page likes
METRIC
FLOATThe number of users who have liked a Facebook page.
Unique Action / EngagementUnique Page subscribes
METRIC
FLOATThe number of users who have subscribed to receive notifications from a Facebook page.
Unique Action / EngagementUnique Post engagements
METRIC
FLOATThe number of users who have engaged with a post on a Facebook page, including actions such as likes, comments, and shares.
Unique Action / EngagementUnique Post comments
METRIC
FLOATThe number of users who have commented on a post on a Facebook page.
Unique Action / EngagementUnique Post reactions
METRIC
FLOATThe number of users who have reacted to a post on a Facebook page.
Unique Action / EngagementUnique Post saves
METRIC
FLOATThe number of users who have saved a post on a Facebook page.
Unique Action / EngagementUnique Post shares
METRIC
FLOATThe number of users who have shared a post on a Facebook page.
Unique Action / EngagementUnique Photo views
METRIC
FLOATThe number of users who have viewed a photo on a Facebook page.
Unique Action / EngagementUnique Event responses
METRIC
FLOATThe number of users who have responded to an event on a Facebook page.
Unique Action / EngagementUnique landing views
METRIC
FLOATUnique Landing Page Views
Unique Action / EngagementUnique Leads (all)
METRIC
FLOATAll offsite leads plus all On-Facebook leads
Unique Action / EngagementUnique Leads (messenger & forms)
METRIC
FLOATOn-Facebook leads coming from Messenger and Instant Forms
Unique Action / EngagementUnique Leads (On Facebook)
METRIC
FLOATAll On-Facebook Leads
Unique Action / EngagementUnique App Installs (all)
METRIC
FLOATThe estimated completed app installs across all channels
Unique Action / EngagementUnique Add to cart (all)
METRIC
FLOATThe estimated added to carts across all channels
Unique Action / EngagementUnique Initiated Checkouts (all)
METRIC
FLOATThe estimated checkouts across all channels
Unique Action / EngagementUnique Purchases (all)
METRIC
FLOATThe estimated purchases across all channels
Unique Action / EngagementUnique Levels Achieved (all)
METRIC
FLOATThe number of users who have achieved levels in a game or app.
Unique Action / EngagementUnique Achievements Unlocked (all)
METRIC
FLOAT The number of users who have unlocked achievements in a game or app.
Unique Action / EngagementUnique App Activations (all)
METRIC
FLOATThe number of users who have activated or downloaded an app.
Unique Action / EngagementUnique Ratings Submitted (all)
METRIC
FLOATThe number of users who have submitted ratings for a game or app.
Unique Action / EngagementUnique Credit Spends (all)
METRIC
FLOATThe number of users who have spent in-game or in-app credits.
Unique Action / EngagementUnique Tutorials Completed (all)
METRIC
FLOATThe number of users who have completed tutorials in a game or app.
Unique Action / EngagementUnique Searches (all)
METRIC
FLOATThe number of users who have conducted searches within a game or app.
Unique Action / EngagementUnique Check-ins
METRIC
FLOATThe number of users who have checked in at a location.
Unique Action / Engagement CostCost per unique page like
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have liked a Facebook page.
Unique Action / Engagement CostCost per unique event response
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have responded to an event on a Facebook page.
Unique Action / Engagement CostCost per unique post engagement
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have engaged with a post on a Facebook page.
Unique Action / Engagement CostCost per unique page engagement
METRIC
CURRENCYCost per unique page engagement is a metric that measures the cost of an ad campaign in relation to the number of users who have engaged with a Facebook page.
Unique Action / Engagement CostCost per unique landing view
METRIC
CURRENCYLanding Page Views
Unique Action / Engagement CostCost per unique Lead (all)
METRIC
CURRENCYAll offsite leads plus all On-Facebook leads
Unique Action / Engagement CostCost per unique Lead (messenger & forms)
METRIC
CURRENCYOn-Facebook leads coming from Messenger and Instant Forms
Unique Action / Engagement CostCost per unique Lead (On Facebook)
METRIC
CURRENCYAll On-Facebook Leads
Unique Action / Engagement CostCost per Unique App Install (all)
METRIC
CURRENCYThe estimated completed app installs across all channels
Unique Action / Engagement CostCost per Unique Add to cart (all)
METRIC
CURRENCYThe estimated added to carts across all channels
Unique Action / Engagement CostCost per Unique Initiated Checkout (all)
METRIC
CURRENCYThe estimated checkouts across all channels
Unique Action / Engagement CostCost per Unique Purchase (all)
METRIC
CURRENCYThe estimated purchases across all channels
Unique Action / Engagement CostCost per Unique Purchase (offline)
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have made purchases in a physical store or through other offline channels that are attributed to the campaign.
Unique Action / Engagement CostCost per Unique On-Facebook purchase
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have made purchases on a Facebook page.
Unique Action / Engagement CostCost per Unique On-Facebook workflow completion
METRIC
CURRENCYOn-Facebook Workflow Completions
Unique Action / Engagement CostCost per Unique Registration (all)
METRIC
CURRENCYThe estimated registrations across all channels.
Unique Action / Engagement CostCost per Unique Content View (all)
METRIC
CURRENCYThe estimated content viewed across all channels.
Unique Action / Engagement CostCost per Unique Check-in
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of users who have checked in at a location.
Collaborative Ads ValuePurchase value (all) (collab ads)
METRIC
FLOATThe total value of purchases made through all channels as a result of collaborative ads.
Collaborative Ads ValuePurchase value (mobile) (collab ads)
METRIC
FLOATThe total value of purchases made through mobile channels as a result of collaborative ads.
Collaborative Ads ValuePurchase value (website) (collab ads)
METRIC
FLOATOnsite Web app purchase value of collab ads
Collaborative Ads ValueAdd to cart value (collab ads)
METRIC
FLOATThe total value of items added to carts as a result of collaborative ads.
Collaborative Ads ValueContent views value (website) (collab ads)
METRIC
FLOATThe total value of content views on a website as a result of collaborative ads.
Collaborative Ads ValueContent views value (offsite) (collab ads)
METRIC
FLOATThe total value of content views on external websites as a result of collaborative ads.
Collaborative Ads ValueContent views value (collab ads)
METRIC
FLOATThe total value of content views as a result of collaborative ads.
Collaborative Ads ValueContent views value (all) (Collab ads)
METRIC
FLOATThe total value of content views through all channels as a result of collaborative ads.
Collaborative Ads ValueCustom event value (collab ads)
METRIC
FLOATThe total value of custom events as a result of collaborative ads.
Collaborative Ads ActionsPurchases (collab ads)
METRIC
INTEGERThe number of purchases made as a result of collaborative ads.
Collaborative Ads ActionsPurchases (all) (collab ads)
METRIC
INTEGERThe number of purchases made through all channels as a result of collaborative ads.
Collaborative Ads ActionsPurchases (mobile) (collab ads)
METRIC
INTEGERThe number of purchases made through mobile channels as a result of collaborative ads.
Collaborative Ads ActionsAdds to cart (collab ads)
METRIC
INTEGERThe number of items added to carts as a result of collaborative ads.
Collaborative Ads ActionsAdds to cart (all) (collab ads)
METRIC
INTEGERThe number of items added to carts through all channels as a result of collaborative ads.
Collaborative Ads ActionsAdds to cart (mobile) (collab ads)
METRIC
INTEGERThe number of items added to carts through mobile channels as a result of collaborative ads.
Collaborative Ads ActionsContent views (collab ads)
METRIC
INTEGERThe number of content views as a result of collaborative ads.
Collaborative Ads ActionsContent views (all) (collab ads)
METRIC
INTEGERThe number of content views through all channels as a result of collaborative ads.
Collaborative Ads ActionsContent views (offsite) (collab ads)
METRIC
INTEGERThe number of content views on external websites as a result of collaborative ads.
Collaborative Ads ActionsContent views (mobile) (collab ads)
METRIC
INTEGERThe number of content views on mobile devices as a result of collaborative ads.
Converted Product ValueContent views (mobile) (product value)
METRIC
INTEGERThe total value of content views on mobile devices as a result of product ads.
Converted Product ValueContent views (offsite) (product value)
METRIC
INTEGERThe total value of content views on external websites as a result of product ads.
Converted Product ValueContent views (product value)
METRIC
INTEGERThe total value of content views as a result of product ads.
Converted Product ValueContent views (all) (product value)
METRIC
INTEGERThe total value of content views through all channels as a result of product ads.
Converted Product ValueCustom event (product value)
METRIC
INTEGERThe total value of custom events as a result of product ads.
Converted Product ValueAdds to cart (mobile) (product value)
METRIC
INTEGERThe total value of items added to carts on mobile devices as a result of product ads.
Converted Product ValueAdds to cart (all) (product value)
METRIC
INTEGERThe total value of items added to carts through all channels as a result of product ads.
Converted Product ValueAdds to cart (product value)
METRIC
INTEGERThe total value of items added to carts as a result of product ads.
Converted Product ValuePurchases (mobile) (product Value)
METRIC
INTEGERThe total value of purchases made on mobile devices as a result of product ads.
Converted Product ValuePurchases (all) (product value)
METRIC
INTEGERThe total value of purchases made through all channels as a result of product ads.
Converted Product QuantityContent views (mobile) (product quantity)
METRIC
INTEGERContent views (mobile) (product quantity)
Converted Product QuantityContent views (offsite) (product quantity)
METRIC
INTEGERContent views (offsite) (product quantity)
Converted Product QuantityContent views (product quantity)
METRIC
INTEGERContent views (product quantity)
Converted Product QuantityContent views (all) (product quantity)
METRIC
INTEGERContent view (all) (product quantity)
Converted Product QuantityCustom event (product quantity)
METRIC
INTEGERCustom event (product quantity)
Converted Product QuantityAdds to cart (mobile) (product quantity)
METRIC
INTEGERAdds to cart (mobile) (product quantity)
Converted Product QuantityAdds to cart (all) (product quantity)
METRIC
INTEGERAdds to cart (all) (product quantity)
Converted Product QuantityAdds to cart (product quantity)
METRIC
INTEGERAdds to cart (product quantity)
Converted Product QuantityPurchases (mobile) (product quantity)
METRIC
INTEGERPurchases (mobile) (product quantity)
Converted Product QuantityPurchases (all) (product quantity)
METRIC
INTEGERPurchases (all) (product quantity)
MessagingNew Messaging Conversations
METRIC
INTEGERThe number of new messaging conversations that are initiated as a result of an ad campaign.
MessagingNew messaging conversations within 7 days
METRIC
INTEGERThe number of times people started messaging your business after at least seven days of inactivity, attributed to your ads
MessagingBlocked Messaging Conversations
METRIC
INTEGERThe number of messaging conversations that are blocked as a result of an ad campaign.
Messaging CostCost per new Messaging Conversation
METRIC
CURRENCYCost per New Messaging Conversation started
Messaging CostCost per New Messaging Conversation within 7 days
METRIC
CURRENCYCost per New Messaging Conversation started including conversations started after at least seven days of inactivity, attributed to your ads
AwarenessEstimated ad recall lift (people)
METRIC
INTEGERAn 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.
AwarenessEstimated ad recall lift rate (%)
METRIC
FLOATThe 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.
Awareness CostCost per estimated ad recall lift (people)
METRIC
FLOATThe 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.
Website Conversions (Facebook Pixel)Website leads
METRIC
INTEGERLeads
Website Conversions (Facebook Pixel)Website adds payment info
METRIC
INTEGERAdds Payment Info
Website Conversions (Facebook Pixel)Website adds to wishlist
METRIC
INTEGERAdds To Wishlist
Website Conversions (Facebook Pixel)Website adds to cart
METRIC
INTEGERAdds To Cart
Website Conversions (Facebook Pixel)Website registrations completed
METRIC
INTEGERCompleted Registrations
Website Conversions (Facebook Pixel)Website custom conversions
METRIC
INTEGERCustom pixel events defined by the advertiser
Website Conversions (Facebook Pixel)Website checkouts initiated
METRIC
INTEGERThe number of initiated checkouts on a website as a result of an ad campaign.
Website Conversions (Facebook Pixel)Website purchases
METRIC
FLOATThe number of purchases made on a website as a result of an ad campaign.
Website Conversions (Facebook Pixel)Website purchase (ROAS)
METRIC
FLOATThe 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.
Website Conversions (Facebook Pixel)Website searches
METRIC
INTEGERThe number of searches made on a website as a result of an ad campaign.
Website Conversions (Facebook Pixel)Website content views
METRIC
INTEGERThe number of content views on a website as a result of an ad campaign.
Website Conversions (Facebook Pixel)Landing page views
METRIC
INTEGERThe number of views on a landing page as a result of an ad campaign.
Website Conversions Cost (Facebook Pixel)Cost per website lead
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of leads that are generated from a website.
Website Conversions Cost (Facebook Pixel)Cost per website adds payment info
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of times that payment information is added to a website.
Website Conversions Cost (Facebook Pixel)Cost per website adds to wishlist
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of times that items are added to a wishlist on a website.
Website Conversions Cost (Facebook Pixel)Cost per website adds to cart
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of times that items are added to a shopping cart on a website.
Website Conversions Cost (Facebook Pixel)Cost per website registrations completed
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of completed website registrations.
Website Conversions Cost (Facebook Pixel)Cost per website custom conversion
METRIC
CURRENCYThe cost of an ad campaign in relation to custom conversions that are defined and tracked on a website.
Website Conversions Cost (Facebook Pixel)Cost per website checkouts initiated
METRIC
CURRENCYThe cost of an ad campaign in relation to the number of initiated checkouts on a website.
Website Conversions Cost (Facebook Pixel)Cost per website search
METRIC
CURRENCYThe cost of an ad campaign in relation to searches conducted on a website.
Website Conversions Cost (Facebook Pixel)Cost per website content view
METRIC
CURRENCYThe cost of an ad campaign in relation to views of specific content on a website.
Website Conversions Cost (Facebook Pixel)Cost per landing page view
METRIC
CURRENCYThe cost of an ad campaign in relation to views of a landing page.
Website Conversions Value (Facebook Pixel)Website leads conversions value
METRIC
FLOATLeads
Website Conversions Value (Facebook Pixel)Website adds payment info conversions value
METRIC
FLOATAdds Payment Info
Website Conversions Value (Facebook Pixel)Website adds to wishlist conversions value
METRIC
FLOATAdds To Wishlist
Website Conversions Value (Facebook Pixel)Website adds to cart conversions value
METRIC
FLOATAdds To Cart
Website Conversions Value (Facebook Pixel)Website registrations completed conversions value
METRIC
FLOATCompleted Registrations
Website Conversions Value (Facebook Pixel)Website custom conversions conversions value
METRIC
FLOATCustom pixel events defined by the advertiser
Website Conversions Value (Facebook Pixel)Website checkouts initiated conversions value
METRIC
FLOATWebsite checkouts initiated
Website Conversions Value (Facebook Pixel)Website purchases conversions value
METRIC
FLOATWebsite purchases
Website Conversions Value (Facebook Pixel)Website searches conversions value
METRIC
FLOATWebsite searches
Website Conversions Value (Facebook Pixel)Website content views conversions value
METRIC
FLOATWebsite content views
Website Conversions Value (Facebook Pixel)Landing page views conversions value
METRIC
FLOATLanding page views
Mobile ConversionsAchievements Unlocked (mobile app)
METRIC
INTEGERMobile App Feature Unlocks
Mobile ConversionsApp Activations (mobile app)
METRIC
INTEGERMobile App Starts
Mobile ConversionsPayment Details added (mobile app)
METRIC
INTEGERMobile App Payment Details
Mobile ConversionsAdds to Cart (mobile app)
METRIC
INTEGERMobile App Adds To Cart
Mobile ConversionsAdds to Wishlist (mobile app)
METRIC
INTEGERMobile App Adds to Wishlist
Mobile ConversionsRegistrations (mobile app)
METRIC
INTEGERMobile App Registrations
Mobile ConversionsContent Views (mobile app)
METRIC
INTEGERMobile App Content Views
Mobile ConversionsInitiated Checkouts (mobile app)
METRIC
INTEGERMobile App Checkouts
Mobile ConversionsLevels Achieved (mobile app)
METRIC
INTEGERMobile App Achievements
Mobile ConversionsPurchases (mobile app)
METRIC
INTEGERMobile App Purchases
Mobile ConversionsRatings (mobile app)
METRIC
INTEGERMobile App Ratings
Mobile ConversionsSearches (mobile app)
METRIC
INTEGERMobile App Searches
Mobile ConversionsCredit Spends (mobile app)
METRIC
FLOATMobile App Credit Spends
Mobile ConversionsTutorial Completions (mobile app)
METRIC
INTEGERMobile App Tutorial Completions
Mobile ConversionsOther App Actions (mobile app)
METRIC
INTEGEROther Mobile App Actions
Mobile Conversion ValueAchievements Unlocked value (mobile app)
METRIC
INTEGERMobile App Feature Unlocks
Mobile Conversion ValueApp Activations value (mobile app)
METRIC
INTEGERMobile App Starts
Mobile Conversion ValuePayment Details added value (mobile app)
METRIC
INTEGERMobile App Payment Details
Mobile Conversion ValueAdds to Cart value (mobile app)
METRIC
INTEGERMobile App Adds To Cart
Mobile Conversion ValueAdds to Wishlist value (mobile app)
METRIC
INTEGERMobile App Adds to Wishlist
Mobile Conversion ValueRegistrations value (mobile app)
METRIC
INTEGERMobile App Registrations
Mobile Conversion ValueContent Views value (mobile app)
METRIC
INTEGERMobile App Content Views
Mobile Conversion ValueInitiated Checkouts value (mobile app)
METRIC
INTEGERMobile App Checkouts
Mobile Conversion ValueLevels Achieved value (mobile app)
METRIC
INTEGERMobile App Achievements
Mobile Conversion ValuePurchases value (mobile app)
METRIC
INTEGERMobile App Purchases
Mobile Conversion ValueRatings value (mobile app)
METRIC
INTEGERMobile App Ratings
Mobile Conversion ValueSearches value (mobile app)
METRIC
INTEGERMobile App Searches
Mobile Conversion ValueCredit Spends value (mobile app)
METRIC
FLOATMobile App Credit Spends
Mobile Conversion ValueTutorial Completions value (mobile app)
METRIC
INTEGERMobile App Tutorial Completions
Mobile Conversion ValueOther App Actions value (mobile app)
METRIC
INTEGEROther Mobile App Actions
MediaVideo avg. watch time
METRIC
FLOATThe number of times your video starts to play. This is counted for each impression of a video, and excludes replays.
MediaVideo views
METRIC
FLOATThe average time a video was played, including any time spent replaying the video for a single impression.
MediaVideo thruplay views
METRIC
FLOATThe number of times your video was played to completion, or for at least 15 seconds. Learn more. This metric is in development.
MediaVideo views (3s)
METRIC
INTEGER3 second video views
MediaVideo views (30s)
METRIC
INTEGERThe number of times your video was watched for an aggregate of at least 30 seconds, or for nearly its total length, whichever happened first
MediaVideo views upto 25%
METRIC
INTEGERThe number of times your video was played at 25% of its length, including plays that skipped to this point.
MediaVideo views upto 50%
METRIC
INTEGERThe number of times your video was played at 50% of its length, including plays that skipped to this point.
MediaVideo views upto 75%
METRIC
INTEGERThe number of times your video was played at 75% of its length, including plays that skipped to this point.
MediaVideo views upto 95%
METRIC
INTEGERThe number of times your video was played at 95% of its length, including plays that skipped to this point.
MediaVideo views upto 100%
METRIC
INTEGERThe number of times your video was played at 100% of its length, including plays that skipped to this point.
MediaAvg. Instant Experience / Canvas view time
METRIC
INTEGERPreviously known as Canvas. The average total time, in seconds, that people spent viewing a Facebook Canvas. Canvas is a screen that opens on mobile after a person clicks the Canvas link in your ad. It may include a series of interactive or multimedia components, including video, images, product catalogs and more.
MediaAvg. Instant Experience / Canvas view %
METRIC
FLOATPreviously known as Canvas. The average percentage of the Facebook Canvas that people saw. Canvas is a screen that opens on mobile after a person clicks the Canvas link in your ad. It may include a series of interactive or multimedia components, including video, images, product catalogs and more.
TimeYear
DIMENSION
YEARYear in the format 2020
TimeYear month
DIMENSION
YEARMONTHYear & Month in the format 2020-Nov
TimeYear month number
DIMENSION
YEAR_MONTH_NUMBERYear & Month in the format 2020-09
TimeMonth
DIMENSION
MONTHNAMEYou will get one result set for each calendar month in the given period.
TimeMonth number
DIMENSION
MONTHYou will get one result set for each calendar month in the given period.
TimeWeek number(sun-sat)
DIMENSION
WEEK_NUMBERWeek number. You will get one result set for every 7 Days in the given period
TimeWeek number(mon-sun)
DIMENSION
WEEK_ISO_NUMBERISO week number, where each week starts on Monday.
TimeWeek (sun - sat)
DIMENSION
DATEStart date of the week.
TimeWeek (mon - sun)
DIMENSION
DATEStart date of the ISO week.
TimeDate
DIMENSION
DATEYou will get one result set for each day in the given period
TimeHour
DIMENSION
HOURHour based on the time zone of the advertising account.
TimeHour (viewer's tz)
DIMENSION
HOURHour based on the time zone of viewer/audience.
Account DetailsAccount name
DIMENSION
STRINGThe name of the ad account.
Account DetailsAccount ID
DIMENSION
STRINGUnique ID of the ad account.
Account DetailsAccount currency
DIMENSION
STRINGThe currency used for the account, based on the corresponding value in the account settings.
Account DetailsAccount edit link
DIMENSION
STRINGLink to edit the Facebook Ads account
Account DetailsBusiness name
DIMENSION
STRINGThe business name for the account
Account DetailsBusiness city
DIMENSION
CITYCity for business address
Account DetailsBusiness country code
DIMENSION
COUNTRY_CODECountry code for the business address
Account DetailsAccount status code
DIMENSION
STRINGStatus of the account: 1 = ACTIVE, 2 = DISABLED, 3 = UNSETTLED, 7 = PENDING_RISK_REVIEW, 8 = PENDING_SETTLEMENT, 9 = IN_GRACE_PERIOD, 100 = PENDING_CLOSURE, 101 = CLOSED, 201 = ANY_ACTIVE, 202 = ANY_CLOSED
Account DetailsAccount status
DIMENSION
ENUMStatus of the account
Account DetailsAttribution setting
DIMENSION
STRINGThe default attribution window to be used when the attribution result is calculated. Each ad set has its own attribution setting value. The attribution setting for a campaign or an account is calculated based on existing ad sets. Returns mixed, indicating multiple attribution settings, skan, indicating SKAdNetwork attribution of iOS 14 app install campaigns, and na, indicating no ad set in a campaign or account. Note: This dimension only returns values when "use unified attribution setting is ON in Facebook Report Configuration.
Account DetailsAccount Timezone
DIMENSION
STRINGName for the time zone
Account DetailsAccount Timezone ID
DIMENSION
STRINGThe timezone ID of this ad account
Account DetailsTimezone offset hours utc
DIMENSION
STRINGTime zone difference from UTC (Coordinated Universal Time).
Account DetailsSpend cap
DIMENSION
STANDARD_CURRENCY_UNITThe maximum amount that can be spent by this Ad Account. When the amount is reached, related Ad Campaigns are paused. A value of 0 means no spending-cap. Setting a new spend cap only applies to spend AFTER the time at which you set it. Value specified in basic unit of the currency, for example 'cents' for USD
Account DetailsTotal account amount spent
DIMENSION
STANDARD_CURRENCY_UNITCurrent total amount spent by the account for the lifetime of the account
Account DetailsDue Amount
DIMENSION
STANDARD_CURRENCY_UNITBill amount due for this Ad Account.
Account DetailsFunding source
DIMENSION
STRINGID of the payment method. If the account does not have a payment method it will still be possible to create ads but these ads will get no delivery. Not available if the account is disabled
Campaign DetailsCampaign name
DIMENSION
STRINGThe name of the campaign.
Campaign DetailsCampaign ID
DIMENSION
STRINGUnique ID of the campaign.
Campaign DetailsCampaign tags
DIMENSION
STRINGList of tags assigned to campaign.
Campaign DetailsCampaign start date
DIMENSION
DATEStart date of the campaign.
Campaign DetailsCampaign end date
DIMENSION
DATEEnd date of the campaign
Campaign DetailsCampaign start datetime
DIMENSION
DATETIMEMerging of start_times for the ad sets belonging to this campaign. At the campaign level, start_time is a read only field. You can setup start_time at the ad set level.
Campaign DetailsCampaign end datetime
DIMENSION
DATETIMEMerging of stop_times for the ad sets belonging to this campaign, if available. At the campaign level, stop_time is a read only field. You can setup stop_time at the ad set level.
Campaign DetailsCampaign created date
DIMENSION
DATEThe date at which the campaign was created.
Campaign DetailsCampaign updated date
DIMENSION
DATEThe date at which the campaign was last updated. NOTE: If you update spend_cap or daily budget or lifetime budget, this will not automatically update this field.
Campaign DetailsCampaign created datetime
DIMENSION
DATETIMEThe date & time at which the campaign was created.
Campaign DetailsCampaign updated datetime
DIMENSION
DATETIMEThe date & time at which the campaign was last updated. NOTE: If you update spend_cap or daily budget or lifetime budget, this will not automatically update this field.
Campaign DetailsCampaign Objective
DIMENSION
STRINGCampaign's objective
Campaign DetailsCampaign Status (effective status)
DIMENSION
STRINGThe status of the campaign. The Possible values are ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES
Campaign DetailsCampaign status (configured status)
DIMENSION
STRINGIf this status is PAUSED, all its active ad sets and ads will be paused and have an effective status CAMPAIGN_PAUSED. The field returns the same value as 'configured_status', and is the suggested one to use.
Campaign DetailsCampaign edit link
DIMENSION
STRINGLink to edit the campaign in Facebook Ads
Campaign DetailsBuying type
DIMENSION
STRINGBuying type, possible values are: AUCTION: default & RESERVED: for reach and frequency ads. Reach and Frequency is disabled for housing, employment and credit ads.
Campaign DetailsIs Campaign using SKAdNetwork
DIMENSION
STRINGWill return true when the campaign will include SKAdNetwork, used for targeting iOS 14+.
Campaign DetailsCampaign Daily budget
DIMENSION
STANDARD_CURRENCY_UNITThe daily budget of the campaign
Campaign DetailsCampaign Lifetime budget
DIMENSION
STANDARD_CURRENCY_UNITThe lifetime budget of the campaign
Campaign DetailsCampaign Budget remaining
DIMENSION
STANDARD_CURRENCY_UNITRemaining budget
AdSet DetailsAdSet name
DIMENSION
STRINGThe name of the adset.
AdSet DetailsAdSet ID
DIMENSION
STRINGUnique ID of the adset.
AdSet DetailsAdSet start date
DIMENSION
DATEThe start date of the adset, e.g. 2015-03-12 or 2015-03-12.
AdSet DetailsAdSet end date
DIMENSION
DATEThe end date of the adset.
AdSet DetailsAdSet start datetime
DIMENSION
DATETIMEThe start time of the adset, e.g. 2015-03-12 23:59:59-07:00 or 2015-03-12 23:59:59 PDT. UTC UNIX timestamp. If not set, the copied adset will inherit the start time from the original set.
AdSet DetailsAdSet end datetime
DIMENSION
DATETIMEEnd time, in UTC UNIX timestamp.
AdSet DetailsAdSet created date
DIMENSION
DATEThe date at which the adset was created.
AdSet DetailsAdSet updated date
DIMENSION
DATEThe date at which the adset last updated.
AdSet DetailsAdSet created datetime
DIMENSION
DATETIMEThe date & time at which the adset was created.
AdSet DetailsAdSet updated datetime
DIMENSION
DATETIMEThe date & time at which the adset was last updated.
AdSet DetailsAdSet Status (effective status)
DIMENSION
STRINGThe effective status of the adset. The status could be effective either because of its own status, or the status of its parent campaign. The Possible values are ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES
AdSet DetailsAdSet Status (configured status)
DIMENSION
STRINGThe status set at the ad set level. It can be different from the effective status due to its parent campaign. Prefer using 'effective status' instead of this.
AdSet DetailsAdSet edit link
DIMENSION
STRINGLink to edit the ad set in Facebook Ads
AdSet DetailsBid amount
DIMENSION
CURRENCYBid cap or target cost for this ad set. The bid cap used in a lowest cost bid strategy is defined as the maximum bid you want to pay for a result based on your optimization_goal. The target cost used in a target cost bid strategy lets Facebook bid on your behalf to meet your target on average and keep costs stable as you raise budget. The bid amount's unit is cents for currencies like USD, EUR, and the basic unit for currencies like JPY, KRW. The bid amount for ads with IMPRESSION or REACH as billing_event is per 1,000 occurrences of that event, and the bid amount for ads with other billing_events is for each occurrence.
AdSet DetailsBid info
DIMENSION
STRINGMap of bid objectives.
AdSet DetailsBilling Event amount
DIMENSION
STRINGThe billing event for this ad set: APP_INSTALLS: Pay when people install your app. CLICKS: Pay when people click anywhere in the ad. IMPRESSIONS: Pay when the ads are shown to people. LINK_CLICKS: Pay when people click on the link of the ad. OFFER_CLAIMS: Pay when people claim the offer. PAGE_LIKES: Pay when people like your page. POST_ENGAGEMENT: Pay when people engage with your post. VIDEO_VIEWS: Pay when people watch your video ads for at least 10 seconds. THRUPLAY: Pay for ads that are played to completion, or played for at least 15 seconds.
AdSet DetailsAdSet Daily budget
DIMENSION
STANDARD_CURRENCY_UNITThe daily budget of the set defined in your account currency.
AdSet DetailsLifetime budget
DIMENSION
STANDARD_CURRENCY_UNITThe lifetime budget of the set defined in your account currency.
AdSet DetailsLifetime min spend target
DIMENSION
FLOATLifetime minimum spend target of the ad set defined in your account currency. To use this field, lifetime budget must be specified in the Campaign. This target is not a guarantee but our best effort.
AdSet DetailsLifetime spend cap
DIMENSION
FLOATLifetime spend cap of the ad set defined in your account currency. To use this field, lifetime budget must be specified in the Campaign.
AdSet DetailsAdSet Targeting
DIMENSION
STRINGThe targeting information of this adset. Includes age ranges, DMA, Gender used in the targeting.
AdSet DetailsAdSet targeting minimum age
DIMENSION
INTEGERMinimum age defined by user for adset targeting.
AdSet DetailsAdSet targeting maximum age
DIMENSION
INTEGERMaximum age defined by user for adset targeting.
AdSet DetailsAdSet targeting geo location
DIMENSION
STRINGAll location targeting information of this adset like countries, location types, country groups etc.
AdSet DetailsAdSet targeting countries
DIMENSION
STRINGCountries defined by user for adset targeting.
AdSet DetailsAdSet targeting location types
DIMENSION
STRINGLocation types defined by user for adset targeting.
AdSet DetailsAdSet targeting country groups
DIMENSION
STRINGCountry groups defined by user for adset targeting.
AdSet DetailsAdSet targeting in-stream videos level
DIMENSION
STRINGThis specifies the brand safety restrictions for where your ad can appear within Facebook in-stream videos and Reels.
AdSet DetailsAdSet targeting audience network level
DIMENSION
STRINGThis indicates the brand safety restrictions for where your ad can be shown on apps and websites within the Audience Network.
AdSet DetailsPromoted Object
DIMENSION
STRINGThe object this ad set is promoting across all its ads.
Ad DetailsAd name
DIMENSION
STRINGThe name of the ad.
Ad DetailsAd ID
DIMENSION
STRINGUnique ID of the ad.
Ad DetailsAd created date
DIMENSION
DATEThe date at which the ad was created.
Ad DetailsAd updated date
DIMENSION
DATEThe date at which the ad was last updated.
Ad DetailsAd created datetime
DIMENSION
DATETIMEThe date & time at which the ad was created.
Ad DetailsAd updated datetime
DIMENSION
DATETIMEThe date & time at which the ad was last updated.
Ad DetailsAd Status (effective status)
DIMENSION
STRINGThe effective status of the ad. The status could be effective either because of its own status, or the status of its parent units. The Possible values are ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES
Ad DetailsAd Status (configured status)
DIMENSION
STRINGThe configured status of the ad.
Ad DetailsAd Preview Link
DIMENSION
STRINGA link that enables users to preview ads in different placements.
Ad DetailsAd Bid Amount
DIMENSION
FLOATBid amount for this ad which will be used in auction instead of the ad set bid_amount, if specified. Any updates to the ad set bid_amount will overwrite this value with the new ad set value.
Ad DetailsAd review feedback
DIMENSION
STRINGThe review feedback for this ad after it is reviewed.
Ad Creative DetailsCreative Id
DIMENSION
STRINGUnique ID for an ad creative, numeric string.
Ad Creative DetailsCreative Name
DIMENSION
STRINGName of this ad creative as seen in the ad account's library.
Ad Creative DetailsAd Title
DIMENSION
STRINGTitle for link ad, which does not belong to a page.
Ad Creative DetailsAd Body
DIMENSION
STRINGThe body of the ad. Not supported for video post creatives
Ad Creative DetailsImage url
DIMENSION
IMAGE_URLA URL for the image creative.
Ad Creative DetailsCreative Object type
DIMENSION
STRINGThe type of Facebook object you want to advertise. Allowed values are: PAGE, DOMAIN, EVENT, STORE_ITEM: refers to an iTunes or Google Play store destination, SHARE: from a page, PHOTO, STATUS: of a page, VIDEO, APPLICATION: app on Facebook, INVALID: when an invalid object_id was specified such as a deleted object or if you do not have permission to see the object. In very few cases, this field may be empty if Facebook is unable to identify the type of advertised object, PRIVACY_CHECK_FAIL: you are missing the permission to load this object type, POST_DELETED: this object_type has been deleted
Ad Creative DetailsCall to action type
DIMENSION
STRINGType of call to action button in your ad. This determines the button text and header text for your ad.
Ad Creative DetailsThumbnail url
DIMENSION
STRINGURL for a thumbnail image for this ad creative.
Ad Creative DetailsLink url
DIMENSION
STRINGIdentify a specific landing tab on your Facebook page by the Page tab's URL
Ad Creative DetailsObject url
DIMENSION
STRINGURL that opens if someone clicks your link on a link ad. This URL is not connected to a Facebook page.
Ad Creative DetailsLink to Promoted Post
DIMENSION
STRINGThe URL directing to the promoted post.
Ad Creative DetailsObject link url
DIMENSION
STRINGURL that opens if someone clicks your link on a link ad.
Ad Creative DetailsObject message
DIMENSION
STRINGThe main body of the post linked to the ad creative.
Ad Creative DetailsObject name
DIMENSION
STRINGCan be name of the link provided / title of the video creative.
Ad Creative DetailsObject link caption
DIMENSION
STRINGA link caption that reflects to the advertisor / business.
Ad Creative DetailsObject description
DIMENSION
STRINGThe description for the link.
Ad Creative DetailsObject CTA type
DIMENSION
STRINGThe type of the call-to-action. Eg., OPEN_LINK, BOOK_TRAVEL, CALL.
Ad Creative DetailsUrl tags
DIMENSION
STRINGA set of query string parameters which will replace or be appended to urls clicked from page post ads, message of the post, and canvas app install creatives only
Ad Creative DetailsTemplate url
DIMENSION
STRINGUsed by Dynamic Ads when you want to use third-party click tracking.
Ad Creative DetailsTemplate url spec
DIMENSION
STRINGUsed for Dynamic Ads when you want to use third-party click tracking.
Ad Creative DetailsPage name
DIMENSION
STRINGThe Facebook Page associated with the business your ad is promoting.
Lead AdsLead ID
DIMENSION
STRINGUnique ID of the lead.
Lead AdsLead created time
DIMENSION
DATETIMETime the lead was created
Lead AdsLead field data
DIMENSION
STRINGForm field data submitted by the user
Lead AdsLead form ID
DIMENSION
STRINGForm ID used for the lead
Lead AdsLead email
DIMENSION
STRINGEmail submitted by the user
Lead AdsLead phone number
DIMENSION
STRINGPhone number submitted by the user
Lead AdsLead full name
DIMENSION
STRINGFull name submitted by the user
Lead AdsLead company name
DIMENSION
STRINGCompany name submitted by the user
Lead AdsLead country
DIMENSION
COUNTRYCountry submitted by the user
Lead AdsLead state
DIMENSION
STRINGState submitted by the user
Lead AdsLead field 1 name
DIMENSION
STRINGName of the form field 1 submitted by the user
Lead AdsLead field 1 value
DIMENSION
STRINGValue of the form field 1 submitted by the user
Lead AdsLead field 2 name
DIMENSION
STRINGName of the form field 2 submitted by the user
Lead AdsLead field 2 value
DIMENSION
STRINGValue of the form field 2 submitted by the user
Lead AdsLead field 3 name
DIMENSION
STRINGName of the form field 3 submitted by the user
Lead AdsLead field 3 value
DIMENSION
STRINGValue of the form field 3 submitted by the user
Lead AdsLead field 4 name
DIMENSION
STRINGName of the form field 4 submitted by the user
Lead AdsLead field 4 value
DIMENSION
STRINGValue of the form field 4 submitted by the user
Lead AdsLead field 5 name
DIMENSION
STRINGName of the form field 5 submitted by the user
Lead AdsLead field 5 value
DIMENSION
STRINGValue of the form field 5 submitted by the user
Lead AdsLead field 6 name
DIMENSION
STRINGName of the form field 6 submitted by the user
Lead AdsLead field 6 value
DIMENSION
STRINGValue of the form field 6 submitted by the user
Lead AdsLead field 7 name
DIMENSION
STRINGName of the form field 7 submitted by the user
Lead AdsLead field 7 value
DIMENSION
STRINGValue of the form field 7 submitted by the user
Lead AdsLead field 8 name
DIMENSION
STRINGName of the form field 8 submitted by the user
Lead AdsLead field 8 value
DIMENSION
STRINGValue of the form field 8 submitted by the user
Lead AdsLead field 9 name
DIMENSION
STRINGName of the form field 9 submitted by the user
Lead AdsLead field 9 value
DIMENSION
STRINGValue of the form field 9 submitted by the user
Lead AdsLead field 10 name
DIMENSION
STRINGName of the form field 10 submitted by the user
Lead AdsLead field 10 value
DIMENSION
STRINGValue of the form field 10 submitted by the user
Impression/Platform/DeviceImpression device
DIMENSION
STRINGThe device where your last ad was served to someone on Facebook. For example "iPhone" if someone viewed your ad on an iPhone.
Impression/Platform/DevicePlace page id
DIMENSION
STRINGThe ID of the place page involved in impression or click.
Impression/Platform/DevicePublisher platform
DIMENSION
STRINGWhich platform your ad was shown, for example on Facebook, Instagram, or Audience Network.
Impression/Platform/DevicePublisher position
DIMENSION
STRINGWhere your ad was shown within a platform, for example on Facebook desktop News Feed, or Instagram Mobile News Feed.
Impression/Platform/DeviceDevice platform
DIMENSION
STRINGThe type of device, mobile or desktop, used by people when they viewed or clicked on an ad, as shown in ads reporting.
Impression/Platform/DeviceAction Device
DIMENSION
STRINGThe device on which the conversion event you're tracking occurred. For example, 'Desktop' if someone converted on a desktop computer.
UserGender
DIMENSION
STRINGGender of people you've reached. People who don't list their gender are shown as 'not specified'.
UserAge
DIMENSION
STRINGThe age range of the people you've reached.
UserCountry code
DIMENSION
COUNTRY_CODEThe countries where the people you've reached are located. This is based on information such as a person's hometown, their current city and the geographical location where they tend to be when they visit Facebook.
UserCountry
DIMENSION
COUNTRYThe countries where the people you've reached are located. This is based on information such as a person's hometown, their current city and the geographical location where they tend to be when they visit Facebook.
UserRegion/State
DIMENSION
REGIONThe regions where the people you've reached are located. This is based on information such as a person's hometown, their current city and the geographical location where they tend to be when they visit Facebook.
UserDMA region
DIMENSION
STRINGDMA (Designated Market Area) regions are the 210 geographic areas in the United States in which local television viewing is measured by The Nielsen Company.
UserUser segment
DIMENSION
STRINGUser segment (ex: new, existing) of Advantage+ Shopping Campaigns (ASC). Existing user is specified by the custom audience in ASC settings.
ProductProduct ID
DIMENSION
STRINGThe ID and name of the product involved in impression, click, or action.