Field group | Field | Type | Data type | Description |
---|---|---|---|---|
Performance | Clicks | METRIC | INTEGER | The 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. |
Performance | Reach | METRIC | INTEGER | 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 |
Performance | Impressions | METRIC | INTEGER | The number of times your ads were on screen |
Performance | Actions | METRIC | INTEGER | The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions. |
Performance | Conversions | METRIC | INTEGER | The total number of conversions attributed to your ads, including contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe. |
Performance | Conversion Values | METRIC | FLOAT | The total value of all conversions attributed to your ads, including contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe. |
Performance | Action values | METRIC | FLOAT | The total value of all conversions attributed to your ads. |
Performance | Purchase (ROAS) (all) | METRIC | FLOAT | The 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. |
Performance | Purchase (ROAS) (all) (Collab ads) | METRIC | FLOAT | Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer |
Performance | Purchase (ROAS) (Website) (Collab ads) | METRIC | FLOAT | Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. |
Performance | Purchase (ROAS) (Mobile) (Collab ads) | METRIC | FLOAT | The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. |
Performance | Frequency | METRIC | FLOAT | The average number of times each person saw your ad |
Performance | Quality ranking | METRIC | STRING | Ad'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. |
Performance | Engagement Rate Ranking | METRIC | STRING | Ad'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. |
Performance | Conversion Rate Ranking | METRIC | STRING | Ad'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. |
Performance | Quality score (deprecated) | METRIC | FLOAT | Ad's perceived quality compared with ads competing for the same audience |
Performance | Engagement Rate Ranking score (deprecated) | METRIC | FLOAT | Ad's expected engagement rate compared with ads competing for the same audience |
Performance | Conversion Rate Ranking score (deprecated) | METRIC | FLOAT | Ad's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience |
Cost | Amount spent | METRIC | CURRENCY | The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule. This metric is estimated. |
Cost | Amount spent (social) | METRIC | CURRENCY | The total amount you've spent so far for your ads showed with social information. (ex: Jane Doe likes this). |
Cost | CPP | METRIC | CURRENCY | The average cost to reach 1,000 people. |
Cost | CPM | METRIC | CURRENCY | The average cost for 1,000 impressions. |
Cost | CPC | METRIC | CURRENCY | The average cost for each click (all). |
Cost | Cost Per any Action | METRIC | CURRENCY | The average cost of any action like like, post save, click, etc. |
Cost | Cost per conversion | METRIC | CURRENCY | The 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. |
Cost | Cost per thruplay | METRIC | CURRENCY | The average cost for each ThruPlay. |
Cost | Cost per unique click (all) | METRIC | CURRENCY | The average cost for each unique click (all). |
Cost | CPC (link) | METRIC | CURRENCY | The average cost of each link click. |
Cost | Cost per unique link click | METRIC | CURRENCY | The average cost of each unique link click |
Cost | Cost per outbound click | METRIC | CURRENCY | The average cost for each outbound click. |
Cost | Cost per unique outbound click | METRIC | CURRENCY | The average cost for each unique outbound click. |
Clicks (more) | Unique clicks | METRIC | INTEGER | The number of people who performed a click (all). This metric is estimated. |
Clicks (more) | Link clicks | METRIC | INTEGER | The number of clicks on links to select destinations |
Clicks (more) | Link clicks (inline) | METRIC | INTEGER | The 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 | INTEGER | The number of people who performed a link click. This metric is estimated. |
Clicks (more) | Outbound clicks | METRIC | INTEGER | The number of clicks on links that take people off Facebook-owned properties. |
Clicks (more) | Unique outbound clicks | METRIC | INTEGER | The number of people who performed an outbound click. This metric is estimated. |
Clicks (more) | CTR (all) | METRIC | FLOAT | The percentage of times people saw your ad and performed a click (all). |
Clicks (more) | Unique CTR (all) | METRIC | FLOAT | The percentage of people who saw your ad and performed a unique click (all). |
Clicks (more) | Links CTR | METRIC | FLOAT | The percentage of time people saw your ads and performed a link click. |
Clicks (more) | Outbound CTR | METRIC | FLOAT | The percentage of times people saw your ad and performed an outbound click |
Clicks (more) | Unique Links CTR | METRIC | FLOAT | The 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 | FLOAT | The percentage of people who saw your ad and performed an outbound click. |
Clicks (more) | Estimated Call Confirmation Clicks | METRIC | INTEGER | 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. |
Action / Engagement | Page engagements | METRIC | INTEGER | The number of interactions your page received. This can include likes, comments, shares, and clicks on links and call-to-action buttons. |
Action / Engagement | Page likes | METRIC | INTEGER | The number of likes received in your page. |
Action / Engagement | Page subscribes | METRIC | INTEGER | The number of people who have subscribed to receive notifications from your facebook page. |
Action / Engagement | Post comments | METRIC | INTEGER | The number of comments on the posts. |
Action / Engagement | Post engagements | METRIC | INTEGER | The number of interactions on your posts. This can include likes, comments, shares, and clicks on links and call-to-action buttons. |
Action / Engagement | Post reactions | METRIC | INTEGER | The number of times people have reacted to your post on your facebook page. |
Action / Engagement | Post saves | METRIC | INTEGER | The number of times people have saved your post on your facebook page. |
Action / Engagement | Post shares | METRIC | INTEGER | The number of times people have shared your post on your facebook page. |
Action / Engagement | Photo views | METRIC | INTEGER | The number of times a photo has been viewed on your facebook page. |
Action / Engagement | Event responses | METRIC | INTEGER | The number of people who have responded to an event on a Facebook page |
Action / Engagement | Leads (all) | METRIC | INTEGER | All offsite leads plus all On-Facebook leads |
Action / Engagement | Leads (messenger & forms) | METRIC | INTEGER | On-Facebook leads coming from Messenger and Instant Forms |
Action / Engagement | Leads (On Facebook) | METRIC | INTEGER | All On-Facebook Leads |
Action / Engagement | App Installs (all) | METRIC | INTEGER | The estimated completed app installs across all channels |
Action / Engagement | Add to cart (all) | METRIC | INTEGER | The estimated added to carts across all channels |
Action / Engagement | Initiated Checkouts (all) | METRIC | INTEGER | The estimated checkouts across all channels |
Action / Engagement | Purchases (all) | METRIC | FLOAT | The estimated purchases across all channels |
Action / Engagement | On-Facebook purchases | METRIC | FLOAT | The number of purchases made through facebook. |
Action / Engagement | On-Facebook purchase value | METRIC | FLOAT | The total value of on-Facebook purchase conversions. |
Action / Engagement | Purchases (offline) | METRIC | FLOAT | The number of purchases made in a physical store or through other offline channels that are attributed to a facebook ad campaign. |
Action / Engagement | On-Facebook workflow completion | METRIC | INTEGER | On-Facebook Workflow Completions |
Action / Engagement | Registrations (all) | METRIC | INTEGER | The estimated registrations across all channels. |
Action / Engagement | Application submits (all) | METRIC | INTEGER | The number of applications that are submitted through all channels. |
Action / Engagement | Application submits (website) | METRIC | INTEGER | The number of applications that are submitted through a website. |
Action / Engagement | Application submits (mobile app) | METRIC | INTEGER | The number of applications that are submitted through a mobile app. |
Action / Engagement | Application submits (offline) | METRIC | INTEGER | The number of applications that are submitted through offline channels. |
Action / Engagement | Application submits (facebook) | METRIC | INTEGER | The number of applications that are submitted through Facebook. |
Action / Engagement | Appointments Scheduled (all) | METRIC | INTEGER | The number of appointments that are scheduled through all channels. |
Action / Engagement | Appointments Scheduled (website) | METRIC | INTEGER | The number of appointments that are scheduled through a website. |
Action / Engagement | Appointments Scheduled (mobile app) | METRIC | INTEGER | The number of appointments that are scheduled through a mobile app. |
Action / Engagement | Appointments Scheduled (offline) | METRIC | INTEGER | The number of appointments that are scheduled through offline channels. |
Action / Engagement | Trials Started (all) | METRIC | INTEGER | The number of trials that are started through all channels. |
Action / Engagement | Trials Started (website) | METRIC | INTEGER | The number of trials that are started through a website. |
Action / Engagement | Trials Started (mobile app) | METRIC | INTEGER | The number of trials that are started through a mobile app. |
Action / Engagement | Trials Started (offline) | METRIC | INTEGER | The number of trials that are started through offline channels. |
Action / Engagement | Location Searches (total) | METRIC | INTEGER | The number of location searches that are conducted through all channels. |
Action / Engagement | Location Searches (website) | METRIC | INTEGER | The number of location searches that are conducted through a website. |
Action / Engagement | Location Searches (mobile app) | METRIC | INTEGER | The number of location searches that are conducted through a mobile app. |
Action / Engagement | Location Searches (offline) | METRIC | INTEGER | The number of location searches that are conducted through offline channels. |
Action / Engagement | Donations (all) | METRIC | INTEGER | The number of donations that are made through all channels. |
Action / Engagement | Donations (website) | METRIC | INTEGER | The number of donations that are made through a website. |
Action / Engagement | Donations (mobile app) | METRIC | INTEGER | The number of donations that are made through a mobile app. |
Action / Engagement | Donations (offline) | METRIC | INTEGER | The number of donations that are made through offline channels. |
Action / Engagement | Products Customized (all) | METRIC | INTEGER | The number of products that are customized through all channels. |
Action / Engagement | Products Customized (website) | METRIC | INTEGER | The number of products that are customized through a website. |
Action / Engagement | Products Customized (mobile app) | METRIC | INTEGER | The number of products that are customized through a mobile app. |
Action / Engagement | Products Customized (offline) | METRIC | INTEGER | The number of products that are customized through offline channels. |
Action / Engagement | Contacts (all) | METRIC | INTEGER | The number of contacts that are made through all channels. |
Action / Engagement | Contacts (website) | METRIC | INTEGER | The number of contacts that are made through a website. |
Action / Engagement | Contacts (mobile app) | METRIC | INTEGER | The number of contacts that are made through a mobile app. |
Action / Engagement | Contacts (offline) | METRIC | INTEGER | The number of contacts that are made through offline channels. |
Action / Engagement | Content Views (all) | METRIC | INTEGER | The estimated content viewed across all channels. |
Action / Engagement | Levels Achieved (all) | METRIC | INTEGER | The estimated Levels Achieved across all channels. |
Action / Engagement | Achievements Unlocked (all) | METRIC | INTEGER | The estimated Achievements Unlocked across all channels. |
Action / Engagement | App Activations (all) | METRIC | INTEGER | The estimated App Activations across all channels. |
Action / Engagement | Ratings Submitted (all) | METRIC | INTEGER | The estimated Ratings Submitted across all channels. |
Action / Engagement | Credit Spends (all) | METRIC | FLOAT | The estimated Credit Spends across all channels. |
Action / Engagement | Tutorials Completed (all) | METRIC | INTEGER | The estimated Tutorials Completed across all channels. |
Action / Engagement | Searches (all) | METRIC | INTEGER | The estimated Searches across all channels. |
Action / Engagement | Check-ins | METRIC | INTEGER | The number of times people have checked in to a location using Facebook |
Action / Engagement | Subscriptions | METRIC | INTEGER | The number of people who have subscribed to a page or profile on facebook. |
Action / Engagement | Website subscriptions | METRIC | INTEGER | The number of people who have subscribed to receive notifications or updates from a website through facebook. |
Action / Engagement | Mobile app subscriptions | METRIC | INTEGER | The number of people who have subscribed to receive notifications or updates from a mobile app. |
Action / Engagement | Offline subscriptions | METRIC | INTEGER | The 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 / Engagement | Phone number clicks (On Facebook) | METRIC | INTEGER | The number of times your phone number or Call Now button was clicked. |
Action / Engagement | Phone calls placed | METRIC | INTEGER | The number of times that a phone call was made to your business from an action taken on an ad |
Action / Engagement | Phone calls placed (20s) | METRIC | INTEGER | The number of times that phone calls placed resulted in successful connections lasting at least 20 seconds |
Action / Engagement | Phone calls placed (60s) | METRIC | INTEGER | The number of times that phone calls placed resulted in successful connections lasting at least 60 seconds |
Action / Engagement | Get directions clicks (On Facebook) | METRIC | INTEGER | The number of times your address or the Get Directions button was clicked. |
Conversions Value | Purchases value (offline) | METRIC | FLOAT | The total value of purchases made in a physical store or through other offline channels that are attributed to a facebook ad campaign. |
Conversions Value | Purchases value (all) | METRIC | FLOAT | The total value of the purchases made. |
Conversions Value | Subscribe value (total) | METRIC | CURRENCY | The total value of subscribe conversions. |
Conversions Value | Subscribe value (website) | METRIC | CURRENCY | The total value of subscribe conversions that occurred on your website. |
Conversions Value | Subscribe value (mobile) | METRIC | CURRENCY | The total value of subscribe conversions on your mobile app. |
Conversions Value | Subscribe value (offline) | METRIC | CURRENCY | The total value of subscribe conversions that occurred offline. |
Conversions Value | Donation value (total) | METRIC | CURRENCY | The total value of donate conversions. |
Conversions Value | Donation value (website) | METRIC | CURRENCY | The total value of donate conversions that occurred on your website. |
Conversions Value | Donation value (on facebook) | METRIC | CURRENCY | The total value of on-Facebook donations that occurred within a Facebook-owned property (such as Pages or Messenger). |
Conversions Value | Donation value (mobile) | METRIC | CURRENCY | The total value of donate conversions that occurred on your mobile app. |
Conversions Value | Donation value (offline) | METRIC | CURRENCY | The total value of donate conversions that occurred offline. |
Action / Engagement cost | Cost per page engagement | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of page engagements it receives. |
Action / Engagement cost | Cost per link click | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of link clicks it receives. |
Action / Engagement cost | Cost per page like | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of likes that it receives on a facebook page. |
Action / Engagement cost | Cost per post comment | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of comments that it receives on a post. |
Action / Engagement cost | Cost per post engagement | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of engagements that it receives on a post |
Action / Engagement cost | Cost per post reaction | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of post reactions made. |
Action / Engagement cost | Cost per post save | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of post saves. |
Action / Engagement cost | Cost per post share | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of post shares. |
Action / Engagement cost | Cost per photo view | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of views received on the photos your facebook page. |
Action / Engagement cost | Cost per video view | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of view views on your facebook page. |
Action / Engagement cost | Cost per event response | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of event responses received. |
Action / Engagement cost | Cost per Lead (all) | METRIC | CURRENCY | All offsite leads plus all On-Facebook leads |
Action / Engagement cost | Cost per Lead (messenger & forms) | METRIC | CURRENCY | On-Facebook leads coming from Messenger and Instant Forms |
Action / Engagement cost | Cost per Lead (On Facebook) | METRIC | CURRENCY | The cost of all On-Facebook Leads |
Action / Engagement cost | Cost per App Install (all) | METRIC | CURRENCY | The cost of an estimated completed app install across all channels |
Action / Engagement cost | Cost per Add to cart (all) | METRIC | CURRENCY | The cost of an estimated added to cart across all channels |
Action / Engagement cost | Cost per Initiated Checkout (all) | METRIC | CURRENCY | The cost of an estimated checkout across all channels |
Action / Engagement cost | Cost per Purchase (all) | METRIC | CURRENCY | The cost of an estimated purchases across all channels |
Action / Engagement cost | Cost per Purchase (offline) | METRIC | CURRENCY | The 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 cost | Cost per Registration (all) | METRIC | CURRENCY | Cost per registration across all channels. |
Action / Engagement cost | Cost per Content View (all) | METRIC | CURRENCY | Cost per content viewed across all channels. |
Action / Engagement cost | Cost per Level Achieved (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of levels that are achieved in a game or app. |
Action / Engagement cost | Cost per Achievement Unlocked (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of achievements that are unlocked in a game or app. |
Action / Engagement cost | Cost per App Activation (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of times that an app is activated or downloaded. |
Action / Engagement cost | Cost per Rating Submitted (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of ratings that are submitted for a game or app. |
Action / Engagement cost | Cost per Credit Spend (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the amount of in-game or in-app credits that are spent. |
Action / Engagement cost | Cost per Tutorial Completed (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of tutorials that are completed in a game or app. |
Action / Engagement cost | Cost per Search (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of searches that are conducted within a game or app. |
Action / Engagement cost | Cost per check-in | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of check-ins that are made at a location. |
Action / Engagement cost | Cost per Subscription (all) | METRIC | CURRENCY | The cost of each subscription. |
Action / Engagement cost | Cost per Subscription (website) | METRIC | CURRENCY | The cost of each website subscription. |
Action / Engagement cost | Cost per Application (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of applications that are submitted through all channels. |
Action / Engagement cost | Cost per Application (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of applications that are submitted through a website. |
Action / Engagement cost | Cost per Application (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of applications that are submitted through a mobile app. |
Action / Engagement cost | Cost per Application (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of applications that are submitted through offline channels. |
Action / Engagement cost | Cost per Application (facebook) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of applications submitted through Facebook. |
Action / Engagement cost | Cost per Appointment Scheduled (all) | METRIC | CURRENCY | Cost per Appointment Scheduled all |
Action / Engagement cost | Cost per Appointment Scheduled (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of appointments that are scheduled through a website. |
Action / Engagement cost | Cost per Appointment Scheduled (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of appointments that are scheduled through a mobile app. |
Action / Engagement cost | Cost per Appointment Scheduled (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of appointments that are scheduled through offline channels. |
Action / Engagement cost | Cost per Trial Started (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of trials that are started through all channels. |
Action / Engagement cost | Cost per Trial Started (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of trials that are started through a website. |
Action / Engagement cost | Cost per Trial Started (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of trials that are started through a mobile app. |
Action / Engagement cost | Cost per Trial Started (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of trials that are started through offline channels. |
Action / Engagement cost | Cost per Location Searches (total) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of location searches that are conducted through all channels. |
Action / Engagement cost | Cost per Location Searches (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of location searches that are conducted through a website. |
Action / Engagement cost | Cost per Location Searches (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of location searches that are conducted through a mobile app. |
Action / Engagement cost | Cost per Location Searches (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of location searches that are conducted through offline channels. |
Action / Engagement cost | Cost per Donation (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of donations that are made through all channels. |
Action / Engagement cost | Cost per Donation (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of donations that are made through a website. |
Action / Engagement cost | Cost per Donation (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of donations that are made through a mobile app. |
Action / Engagement cost | Cost per Donation (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of donations that are made through offline channels. |
Action / Engagement cost | Cost per Product Customized (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of products that are customized through all channels. |
Action / Engagement cost | Cost per Product Customized (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of products that are customized through a website. |
Action / Engagement cost | Cost per Product Customized (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of products that are customized through a mobile app. |
Action / Engagement cost | Cost per Product Customized (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of products that are customized through offline channels. |
Action / Engagement cost | Cost per contacts (all) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of contacts that are made through all channels. |
Action / Engagement cost | Cost per contacts (website) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of contacts that are made through a website. |
Action / Engagement cost | Cost per contacts (mobile app) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of contacts that are made through a mobile app. |
Action / Engagement cost | Cost per contacts (offline) | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of contacts that are made through offline channels. |
Unique Action / Engagement | Unique Page engagements | METRIC | FLOAT | The number of users who have engaged with a Facebook page. |
Unique Action / Engagement | Unique Page likes | METRIC | FLOAT | The number of users who have liked a Facebook page. |
Unique Action / Engagement | Unique Page subscribes | METRIC | FLOAT | The number of users who have subscribed to receive notifications from a Facebook page. |
Unique Action / Engagement | Unique Post engagements | METRIC | FLOAT | The number of users who have engaged with a post on a Facebook page, including actions such as likes, comments, and shares. |
Unique Action / Engagement | Unique Post comments | METRIC | FLOAT | The number of users who have commented on a post on a Facebook page. |
Unique Action / Engagement | Unique Post reactions | METRIC | FLOAT | The number of users who have reacted to a post on a Facebook page. |
Unique Action / Engagement | Unique Post saves | METRIC | FLOAT | The number of users who have saved a post on a Facebook page. |
Unique Action / Engagement | Unique Post shares | METRIC | FLOAT | The number of users who have shared a post on a Facebook page. |
Unique Action / Engagement | Unique Photo views | METRIC | FLOAT | The number of users who have viewed a photo on a Facebook page. |
Unique Action / Engagement | Unique Event responses | METRIC | FLOAT | The number of users who have responded to an event on a Facebook page. |
Unique Action / Engagement | Unique landing views | METRIC | FLOAT | Unique Landing Page Views |
Unique Action / Engagement | Unique Leads (all) | METRIC | FLOAT | All offsite leads plus all On-Facebook leads |
Unique Action / Engagement | Unique Leads (messenger & forms) | METRIC | FLOAT | On-Facebook leads coming from Messenger and Instant Forms |
Unique Action / Engagement | Unique Leads (On Facebook) | METRIC | FLOAT | All On-Facebook Leads |
Unique Action / Engagement | Unique App Installs (all) | METRIC | FLOAT | The estimated completed app installs across all channels |
Unique Action / Engagement | Unique Add to cart (all) | METRIC | FLOAT | The estimated added to carts across all channels |
Unique Action / Engagement | Unique Initiated Checkouts (all) | METRIC | FLOAT | The estimated checkouts across all channels |
Unique Action / Engagement | Unique Purchases (all) | METRIC | FLOAT | The estimated purchases across all channels |
Unique Action / Engagement | Unique Levels Achieved (all) | METRIC | FLOAT | The number of users who have achieved levels in a game or app. |
Unique Action / Engagement | Unique Achievements Unlocked (all) | METRIC | FLOAT | The number of users who have unlocked achievements in a game or app. |
Unique Action / Engagement | Unique App Activations (all) | METRIC | FLOAT | The number of users who have activated or downloaded an app. |
Unique Action / Engagement | Unique Ratings Submitted (all) | METRIC | FLOAT | The number of users who have submitted ratings for a game or app. |
Unique Action / Engagement | Unique Credit Spends (all) | METRIC | FLOAT | The number of users who have spent in-game or in-app credits. |
Unique Action / Engagement | Unique Tutorials Completed (all) | METRIC | FLOAT | The number of users who have completed tutorials in a game or app. |
Unique Action / Engagement | Unique Searches (all) | METRIC | FLOAT | The number of users who have conducted searches within a game or app. |
Unique Action / Engagement | Unique Check-ins | METRIC | FLOAT | The number of users who have checked in at a location. |
Unique Action / Engagement Cost | Cost per unique page like | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of users who have liked a Facebook page. |
Unique Action / Engagement Cost | Cost per unique event response | METRIC | CURRENCY | The 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 Cost | Cost per unique post engagement | METRIC | CURRENCY | The 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 Cost | Cost per unique page engagement | METRIC | CURRENCY | Cost 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 Cost | Cost per unique landing view | METRIC | CURRENCY | Landing Page Views |
Unique Action / Engagement Cost | Cost per unique Lead (all) | METRIC | CURRENCY | All offsite leads plus all On-Facebook leads |
Unique Action / Engagement Cost | Cost per unique Lead (messenger & forms) | METRIC | CURRENCY | On-Facebook leads coming from Messenger and Instant Forms |
Unique Action / Engagement Cost | Cost per unique Lead (On Facebook) | METRIC | CURRENCY | All On-Facebook Leads |
Unique Action / Engagement Cost | Cost per Unique App Install (all) | METRIC | CURRENCY | The estimated completed app installs across all channels |
Unique Action / Engagement Cost | Cost per Unique Add to cart (all) | METRIC | CURRENCY | The estimated added to carts across all channels |
Unique Action / Engagement Cost | Cost per Unique Initiated Checkout (all) | METRIC | CURRENCY | The estimated checkouts across all channels |
Unique Action / Engagement Cost | Cost per Unique Purchase (all) | METRIC | CURRENCY | The estimated purchases across all channels |
Unique Action / Engagement Cost | Cost per Unique Purchase (offline) | METRIC | CURRENCY | The 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 Cost | Cost per Unique On-Facebook purchase | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of users who have made purchases on a Facebook page. |
Unique Action / Engagement Cost | Cost per Unique On-Facebook workflow completion | METRIC | CURRENCY | On-Facebook Workflow Completions |
Unique Action / Engagement Cost | Cost per Unique Registration (all) | METRIC | CURRENCY | The estimated registrations across all channels. |
Unique Action / Engagement Cost | Cost per Unique Content View (all) | METRIC | CURRENCY | The estimated content viewed across all channels. |
Unique Action / Engagement Cost | Cost per Unique Check-in | METRIC | CURRENCY | The cost of an ad campaign in relation to the number of users who have checked in at a location. |
Collaborative Ads Value | Purchase value (all) (collab ads) | METRIC | FLOAT | The total value of purchases made through all channels as a result of collaborative ads. |
Collaborative Ads Value | Purchase value (mobile) (collab ads) | METRIC | FLOAT | The total value of purchases made through mobile channels as a result of collaborative ads. |
Collaborative Ads Value | Purchase value (website) (collab ads) | METRIC | FLOAT | Onsite Web app purchase value of collab ads |
Collaborative Ads Value | Add to cart value (collab ads) | METRIC | FLOAT | The total value of items added to carts as a result of collaborative ads. |
Collaborative Ads Value | Content views value (website) (collab ads) | METRIC | FLOAT | The total value of content views on a website as a result of collaborative ads. |
Collaborative Ads Value | Content views value (offsite) (collab ads) | METRIC | FLOAT | The total value of content views on external websites as a result of collaborative ads. |
Collaborative Ads Value | Content views value (collab ads) | METRIC | FLOAT | The total value of content views as a result of collaborative ads. |
Collaborative Ads Value | Content views value (all) (Collab ads) | METRIC | FLOAT | The total value of content views through all channels as a result of collaborative ads. |
Collaborative Ads Value | Custom event value (collab ads) | METRIC | FLOAT | The total value of custom events as a result of collaborative ads. |
Collaborative Ads Actions | Purchases (collab ads) | METRIC | INTEGER | The number of purchases made as a result of collaborative ads. |
Collaborative Ads Actions | Purchases (all) (collab ads) | METRIC | INTEGER | The number of purchases made through all channels as a result of collaborative ads. |
Collaborative Ads Actions | Purchases (mobile) (collab ads) | METRIC | INTEGER | The number of purchases made through mobile channels as a result of collaborative ads. |
Collaborative Ads Actions | Adds to cart (collab ads) | METRIC | INTEGER | The number of items added to carts as a result of collaborative ads. |
Collaborative Ads Actions | Adds to cart (all) (collab ads) | METRIC | INTEGER | The number of items added to carts through all channels as a result of collaborative ads. |
Collaborative Ads Actions | Adds to cart (mobile) (collab ads) | METRIC | INTEGER | The number of items added to carts through mobile channels as a result of collaborative ads. |
Collaborative Ads Actions | Content views (collab ads) | METRIC | INTEGER | The number of content views as a result of collaborative ads. |
Collaborative Ads Actions | Content views (all) (collab ads) | METRIC | INTEGER | The number of content views through all channels as a result of collaborative ads. |
Collaborative Ads Actions | Content views (offsite) (collab ads) | METRIC | INTEGER | The number of content views on external websites as a result of collaborative ads. |
Collaborative Ads Actions | Content views (mobile) (collab ads) | METRIC | INTEGER | The number of content views on mobile devices as a result of collaborative ads. |
Converted Product Value | Content views (mobile) (product value) | METRIC | INTEGER | The total value of content views on mobile devices as a result of product ads. |
Converted Product Value | Content views (offsite) (product value) | METRIC | INTEGER | The total value of content views on external websites as a result of product ads. |
Converted Product Value | Content views (product value) | METRIC | INTEGER | The total value of content views as a result of product ads. |
Converted Product Value | Content views (all) (product value) | METRIC | INTEGER | The total value of content views through all channels as a result of product ads. |
Converted Product Value | Custom event (product value) | METRIC | INTEGER | The total value of custom events as a result of product ads. |
Converted Product Value | Adds to cart (mobile) (product value) | METRIC | INTEGER | The total value of items added to carts on mobile devices as a result of product ads. |
Converted Product Value | Adds to cart (all) (product value) | METRIC | INTEGER | The total value of items added to carts through all channels as a result of product ads. |
Converted Product Value | Adds to cart (product value) | METRIC | INTEGER | The total value of items added to carts as a result of product ads. |
Converted Product Value | Purchases (mobile) (product Value) | METRIC | INTEGER | The total value of purchases made on mobile devices as a result of product ads. |
Converted Product Value | Purchases (all) (product value) | METRIC | INTEGER | The total value of purchases made through all channels as a result of product ads. |
Converted Product Quantity | Content views (mobile) (product quantity) | METRIC | INTEGER | Content views (mobile) (product quantity) |
Converted Product Quantity | Content views (offsite) (product quantity) | METRIC | INTEGER | Content views (offsite) (product quantity) |
Converted Product Quantity | Content views (product quantity) | METRIC | INTEGER | Content views (product quantity) |
Converted Product Quantity | Content views (all) (product quantity) | METRIC | INTEGER | Content view (all) (product quantity) |
Converted Product Quantity | Custom event (product quantity) | METRIC | INTEGER | Custom event (product quantity) |
Converted Product Quantity | Adds to cart (mobile) (product quantity) | METRIC | INTEGER | Adds to cart (mobile) (product quantity) |
Converted Product Quantity | Adds to cart (all) (product quantity) | METRIC | INTEGER | Adds to cart (all) (product quantity) |
Converted Product Quantity | Adds to cart (product quantity) | METRIC | INTEGER | Adds to cart (product quantity) |
Converted Product Quantity | Purchases (mobile) (product quantity) | METRIC | INTEGER | Purchases (mobile) (product quantity) |
Converted Product Quantity | Purchases (all) (product quantity) | METRIC | INTEGER | Purchases (all) (product quantity) |
Messaging | New Messaging Conversations | METRIC | INTEGER | The number of new messaging conversations that are initiated as a result of an ad campaign. |
Messaging | New messaging conversations within 7 days | METRIC | INTEGER | The number of times people started messaging your business after at least seven days of inactivity, attributed to your ads |
Messaging | Blocked Messaging Conversations | METRIC | INTEGER | The number of messaging conversations that are blocked as a result of an ad campaign. |
Messaging Cost | Cost per new Messaging Conversation | METRIC | CURRENCY | Cost per New Messaging Conversation started |
Messaging Cost | Cost per New Messaging Conversation within 7 days | METRIC | CURRENCY | Cost per New Messaging Conversation started including conversations started after at least seven days of inactivity, attributed to your ads |
Awareness | Estimated ad recall lift (people) | METRIC | INTEGER | 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. |
Awareness | Estimated ad recall lift rate (%) | METRIC | FLOAT | 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. |
Awareness Cost | Cost per estimated ad recall lift (people) | METRIC | FLOAT | 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. |
Website Conversions (Facebook Pixel) | Website leads | METRIC | INTEGER | Leads |
Website Conversions (Facebook Pixel) | Website adds payment info | METRIC | INTEGER | Adds Payment Info |
Website Conversions (Facebook Pixel) | Website adds to wishlist | METRIC | INTEGER | Adds To Wishlist |
Website Conversions (Facebook Pixel) | Website adds to cart | METRIC | INTEGER | Adds To Cart |
Website Conversions (Facebook Pixel) | Website registrations completed | METRIC | INTEGER | Completed Registrations |
Website Conversions (Facebook Pixel) | Website custom conversions | METRIC | INTEGER | Custom pixel events defined by the advertiser |
Website Conversions (Facebook Pixel) | Website checkouts initiated | METRIC | INTEGER | The number of initiated checkouts on a website as a result of an ad campaign. |
Website Conversions (Facebook Pixel) | Website purchases | METRIC | FLOAT | The number of purchases made on a website as a result of an ad campaign. |
Website Conversions (Facebook Pixel) | Website purchase (ROAS) | METRIC | FLOAT | The total return on ad spend (ROAS) from website purchases. This is based on the value of all conversions recorded by the Facebook pixel on your website and attributed to your ads. |
Website Conversions (Facebook Pixel) | Website searches | METRIC | INTEGER | The number of searches made on a website as a result of an ad campaign. |
Website Conversions (Facebook Pixel) | Website content views | METRIC | INTEGER | The number of content views on a website as a result of an ad campaign. |
Website Conversions (Facebook Pixel) | Landing page views | METRIC | INTEGER | The number of views on a landing page as a result of an ad campaign. |
Website Conversions Cost (Facebook Pixel) | Cost per website lead | METRIC | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The 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 | CURRENCY | The cost of an ad campaign in relation to searches conducted on a website. |
Website Conversions Cost (Facebook Pixel) | Cost per website content view | METRIC | CURRENCY | The 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 | CURRENCY | The cost of an ad campaign in relation to views of a landing page. |
Website Conversions Value (Facebook Pixel) | Website leads conversions value | METRIC | FLOAT | Leads |
Website Conversions Value (Facebook Pixel) | Website adds payment info conversions value | METRIC | FLOAT | Adds Payment Info |
Website Conversions Value (Facebook Pixel) | Website adds to wishlist conversions value | METRIC | FLOAT | Adds To Wishlist |
Website Conversions Value (Facebook Pixel) | Website adds to cart conversions value | METRIC | FLOAT | Adds To Cart |
Website Conversions Value (Facebook Pixel) | Website registrations completed conversions value | METRIC | FLOAT | Completed Registrations |
Website Conversions Value (Facebook Pixel) | Website custom conversions conversions value | METRIC | FLOAT | Custom pixel events defined by the advertiser |
Website Conversions Value (Facebook Pixel) | Website checkouts initiated conversions value | METRIC | FLOAT | Website checkouts initiated |
Website Conversions Value (Facebook Pixel) | Website purchases conversions value | METRIC | FLOAT | Website purchases |
Website Conversions Value (Facebook Pixel) | Website searches conversions value | METRIC | FLOAT | Website searches |
Website Conversions Value (Facebook Pixel) | Website content views conversions value | METRIC | FLOAT | Website content views |
Website Conversions Value (Facebook Pixel) | Landing page views conversions value | METRIC | FLOAT | Landing page views |
Mobile Conversions | Achievements Unlocked (mobile app) | METRIC | INTEGER | Mobile App Feature Unlocks |
Mobile Conversions | App Activations (mobile app) | METRIC | INTEGER | Mobile App Starts |
Mobile Conversions | Payment Details added (mobile app) | METRIC | INTEGER | Mobile App Payment Details |
Mobile Conversions | Adds to Cart (mobile app) | METRIC | INTEGER | Mobile App Adds To Cart |
Mobile Conversions | Adds to Wishlist (mobile app) | METRIC | INTEGER | Mobile App Adds to Wishlist |
Mobile Conversions | Registrations (mobile app) | METRIC | INTEGER | Mobile App Registrations |
Mobile Conversions | Content Views (mobile app) | METRIC | INTEGER | Mobile App Content Views |
Mobile Conversions | Initiated Checkouts (mobile app) | METRIC | INTEGER | Mobile App Checkouts |
Mobile Conversions | Levels Achieved (mobile app) | METRIC | INTEGER | Mobile App Achievements |
Mobile Conversions | Purchases (mobile app) | METRIC | INTEGER | Mobile App Purchases |
Mobile Conversions | Ratings (mobile app) | METRIC | INTEGER | Mobile App Ratings |
Mobile Conversions | Searches (mobile app) | METRIC | INTEGER | Mobile App Searches |
Mobile Conversions | Credit Spends (mobile app) | METRIC | FLOAT | Mobile App Credit Spends |
Mobile Conversions | Tutorial Completions (mobile app) | METRIC | INTEGER | Mobile App Tutorial Completions |
Mobile Conversions | Other App Actions (mobile app) | METRIC | INTEGER | Other Mobile App Actions |
Mobile Conversion Value | Achievements Unlocked value (mobile app) | METRIC | INTEGER | Mobile App Feature Unlocks |
Mobile Conversion Value | App Activations value (mobile app) | METRIC | INTEGER | Mobile App Starts |
Mobile Conversion Value | Payment Details added value (mobile app) | METRIC | INTEGER | Mobile App Payment Details |
Mobile Conversion Value | Adds to Cart value (mobile app) | METRIC | INTEGER | Mobile App Adds To Cart |
Mobile Conversion Value | Adds to Wishlist value (mobile app) | METRIC | INTEGER | Mobile App Adds to Wishlist |
Mobile Conversion Value | Registrations value (mobile app) | METRIC | INTEGER | Mobile App Registrations |
Mobile Conversion Value | Content Views value (mobile app) | METRIC | INTEGER | Mobile App Content Views |
Mobile Conversion Value | Initiated Checkouts value (mobile app) | METRIC | INTEGER | Mobile App Checkouts |
Mobile Conversion Value | Levels Achieved value (mobile app) | METRIC | INTEGER | Mobile App Achievements |
Mobile Conversion Value | Purchases value (mobile app) | METRIC | INTEGER | Mobile App Purchases |
Mobile Conversion Value | Ratings value (mobile app) | METRIC | INTEGER | Mobile App Ratings |
Mobile Conversion Value | Searches value (mobile app) | METRIC | INTEGER | Mobile App Searches |
Mobile Conversion Value | Credit Spends value (mobile app) | METRIC | FLOAT | Mobile App Credit Spends |
Mobile Conversion Value | Tutorial Completions value (mobile app) | METRIC | INTEGER | Mobile App Tutorial Completions |
Mobile Conversion Value | Other App Actions value (mobile app) | METRIC | INTEGER | Other Mobile App Actions |
Media | Video avg. watch time | METRIC | FLOAT | The number of times your video starts to play. This is counted for each impression of a video, and excludes replays. |
Media | Video views | METRIC | FLOAT | The average time a video was played, including any time spent replaying the video for a single impression. |
Media | Video thruplay views | METRIC | FLOAT | The number of times your video was played to completion, or for at least 15 seconds. Learn more. This metric is in development. |
Media | Video views (3s) | METRIC | INTEGER | 3 second video views |
Media | Video views (30s) | METRIC | INTEGER | 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 |
Media | Video views upto 25% | METRIC | INTEGER | The number of times your video was played at 25% of its length, including plays that skipped to this point. |
Media | Video views upto 50% | METRIC | INTEGER | The number of times your video was played at 50% of its length, including plays that skipped to this point. |
Media | Video views upto 75% | METRIC | INTEGER | The number of times your video was played at 75% of its length, including plays that skipped to this point. |
Media | Video views upto 95% | METRIC | INTEGER | The number of times your video was played at 95% of its length, including plays that skipped to this point. |
Media | Video views upto 100% | METRIC | INTEGER | The number of times your video was played at 100% of its length, including plays that skipped to this point. |
Media | Avg. Instant Experience / Canvas view time | METRIC | INTEGER | Previously 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. |
Media | Avg. Instant Experience / Canvas view % | METRIC | FLOAT | Previously 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. |
Time | Year | DIMENSION | YEAR | Year in the format 2020 |
Time | Year month | DIMENSION | YEARMONTH | Year & Month in the format 2020-Nov |
Time | Year month number | DIMENSION | YEAR_MONTH_NUMBER | Year & Month in the format 2020-09 |
Time | Month | DIMENSION | MONTHNAME | You will get one result set for each calendar month in the given period. |
Time | Month number | DIMENSION | MONTH | You will get one result set for each calendar month in the given period. |
Time | Week number(sun-sat) | DIMENSION | WEEK_NUMBER | Week number. You will get one result set for every 7 Days in the given period |
Time | Week number(mon-sun) | DIMENSION | WEEK_ISO_NUMBER | ISO week number, where each week starts on Monday. |
Time | Week (sun - sat) | DIMENSION | DATE | Start date of the week. |
Time | Week (mon - sun) | DIMENSION | DATE | Start date of the ISO week. |
Time | Date | DIMENSION | DATE | You will get one result set for each day in the given period |
Time | Hour | DIMENSION | HOUR | Hour based on the time zone of the advertising account. |
Time | Hour (viewer's tz) | DIMENSION | HOUR | Hour based on the time zone of viewer/audience. |
Account Details | Account name | DIMENSION | STRING | The name of the ad account. |
Account Details | Account ID | DIMENSION | STRING | Unique ID of the ad account. |
Account Details | Account currency | DIMENSION | STRING | The currency used for the account, based on the corresponding value in the account settings. |
Account Details | Account edit link | DIMENSION | STRING | Link to edit the Facebook Ads account |
Account Details | Business name | DIMENSION | STRING | The business name for the account |
Account Details | Business city | DIMENSION | CITY | City for business address |
Account Details | Business country code | DIMENSION | COUNTRY_CODE | Country code for the business address |
Account Details | Account status code | DIMENSION | STRING | Status 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 Details | Account status | DIMENSION | ENUM | Status of the account |
Account Details | Attribution setting | DIMENSION | STRING | The 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 Details | Account Timezone | DIMENSION | STRING | Name for the time zone |
Account Details | Account Timezone ID | DIMENSION | STRING | The timezone ID of this ad account |
Account Details | Timezone offset hours utc | DIMENSION | STRING | Time zone difference from UTC (Coordinated Universal Time). |
Account Details | Spend cap | DIMENSION | STANDARD_CURRENCY_UNIT | The 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 Details | Total account amount spent | DIMENSION | STANDARD_CURRENCY_UNIT | Current total amount spent by the account for the lifetime of the account |
Account Details | Due Amount | DIMENSION | STANDARD_CURRENCY_UNIT | Bill amount due for this Ad Account. |
Account Details | Funding source | DIMENSION | STRING | ID 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 Details | Campaign name | DIMENSION | STRING | The name of the campaign. |
Campaign Details | Campaign ID | DIMENSION | STRING | Unique ID of the campaign. |
Campaign Details | Campaign tags | DIMENSION | STRING | List of tags assigned to campaign. |
Campaign Details | Campaign start date | DIMENSION | DATE | Start date of the campaign. |
Campaign Details | Campaign end date | DIMENSION | DATE | End date of the campaign |
Campaign Details | Campaign start datetime | DIMENSION | DATETIME | Merging 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 Details | Campaign end datetime | DIMENSION | DATETIME | Merging 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 Details | Campaign created date | DIMENSION | DATE | The date at which the campaign was created. |
Campaign Details | Campaign updated date | DIMENSION | DATE | The 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 Details | Campaign created datetime | DIMENSION | DATETIME | The date & time at which the campaign was created. |
Campaign Details | Campaign updated datetime | DIMENSION | DATETIME | The 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 Details | Campaign Objective | DIMENSION | STRING | Campaign's objective |
Campaign Details | Campaign Status (effective status) | DIMENSION | STRING | The status of the campaign. The Possible values are ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES |
Campaign Details | Campaign status (configured status) | DIMENSION | STRING | If 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 Details | Campaign edit link | DIMENSION | STRING | Link to edit the campaign in Facebook Ads |
Campaign Details | Buying type | DIMENSION | STRING | Buying type, possible values are: AUCTION: default & RESERVED: for reach and frequency ads. Reach and Frequency is disabled for housing, employment and credit ads. |
Campaign Details | Is Campaign using SKAdNetwork | DIMENSION | STRING | Will return true when the campaign will include SKAdNetwork, used for targeting iOS 14+. |
Campaign Details | Campaign Daily budget | DIMENSION | STANDARD_CURRENCY_UNIT | The daily budget of the campaign |
Campaign Details | Campaign Lifetime budget | DIMENSION | STANDARD_CURRENCY_UNIT | The lifetime budget of the campaign |
Campaign Details | Campaign Budget remaining | DIMENSION | STANDARD_CURRENCY_UNIT | Remaining budget |
AdSet Details | AdSet name | DIMENSION | STRING | The name of the adset. |
AdSet Details | AdSet ID | DIMENSION | STRING | Unique ID of the adset. |
AdSet Details | AdSet start date | DIMENSION | DATE | The start date of the adset, e.g. 2015-03-12 or 2015-03-12. |
AdSet Details | AdSet end date | DIMENSION | DATE | The end date of the adset. |
AdSet Details | AdSet start datetime | DIMENSION | DATETIME | The 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 Details | AdSet end datetime | DIMENSION | DATETIME | End time, in UTC UNIX timestamp. |
AdSet Details | AdSet created date | DIMENSION | DATE | The date at which the adset was created. |
AdSet Details | AdSet updated date | DIMENSION | DATE | The date at which the adset last updated. |
AdSet Details | AdSet created datetime | DIMENSION | DATETIME | The date & time at which the adset was created. |
AdSet Details | AdSet updated datetime | DIMENSION | DATETIME | The date & time at which the adset was last updated. |
AdSet Details | AdSet Status (effective status) | DIMENSION | STRING | The 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 Details | AdSet Status (configured status) | DIMENSION | STRING | The 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 Details | AdSet edit link | DIMENSION | STRING | Link to edit the ad set in Facebook Ads |
AdSet Details | Bid amount | DIMENSION | CURRENCY | Bid 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 Details | Bid info | DIMENSION | STRING | Map of bid objectives. |
AdSet Details | Billing Event amount | DIMENSION | STRING | The 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 Details | AdSet Daily budget | DIMENSION | STANDARD_CURRENCY_UNIT | The daily budget of the set defined in your account currency. |
AdSet Details | Lifetime budget | DIMENSION | STANDARD_CURRENCY_UNIT | The lifetime budget of the set defined in your account currency. |
AdSet Details | Lifetime min spend target | DIMENSION | FLOAT | Lifetime 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 Details | Lifetime spend cap | DIMENSION | FLOAT | Lifetime spend cap of the ad set defined in your account currency. To use this field, lifetime budget must be specified in the Campaign. |
AdSet Details | AdSet Targeting | DIMENSION | STRING | The targeting information of this adset. Includes age ranges, DMA, Gender used in the targeting. |
AdSet Details | AdSet targeting minimum age | DIMENSION | INTEGER | Minimum age defined by user for adset targeting. |
AdSet Details | AdSet targeting maximum age | DIMENSION | INTEGER | Maximum age defined by user for adset targeting. |
AdSet Details | AdSet targeting geo location | DIMENSION | STRING | All location targeting information of this adset like countries, location types, country groups etc. |
AdSet Details | AdSet targeting countries | DIMENSION | STRING | Countries defined by user for adset targeting. |
AdSet Details | AdSet targeting location types | DIMENSION | STRING | Location types defined by user for adset targeting. |
AdSet Details | AdSet targeting country groups | DIMENSION | STRING | Country groups defined by user for adset targeting. |
AdSet Details | AdSet targeting in-stream videos level | DIMENSION | STRING | This specifies the brand safety restrictions for where your ad can appear within Facebook in-stream videos and Reels. |
AdSet Details | AdSet targeting audience network level | DIMENSION | STRING | This indicates the brand safety restrictions for where your ad can be shown on apps and websites within the Audience Network. |
AdSet Details | Promoted Object | DIMENSION | STRING | The object this ad set is promoting across all its ads. |
Ad Details | Ad name | DIMENSION | STRING | The name of the ad. |
Ad Details | Ad ID | DIMENSION | STRING | Unique ID of the ad. |
Ad Details | Ad created date | DIMENSION | DATE | The date at which the ad was created. |
Ad Details | Ad updated date | DIMENSION | DATE | The date at which the ad was last updated. |
Ad Details | Ad created datetime | DIMENSION | DATETIME | The date & time at which the ad was created. |
Ad Details | Ad updated datetime | DIMENSION | DATETIME | The date & time at which the ad was last updated. |
Ad Details | Ad Status (effective status) | DIMENSION | STRING | The 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 Details | Ad Status (configured status) | DIMENSION | STRING | The configured status of the ad. |
Ad Details | Ad Preview Link | DIMENSION | STRING | A link that enables users to preview ads in different placements. |
Ad Details | Ad Bid Amount | DIMENSION | FLOAT | Bid 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 Details | Ad review feedback | DIMENSION | STRING | The review feedback for this ad after it is reviewed. |
Ad Creative Details | Creative Id | DIMENSION | STRING | Unique ID for an ad creative, numeric string. |
Ad Creative Details | Creative Name | DIMENSION | STRING | Name of this ad creative as seen in the ad account's library. |
Ad Creative Details | Ad Title | DIMENSION | STRING | Title for link ad, which does not belong to a page. |
Ad Creative Details | Ad Body | DIMENSION | STRING | The body of the ad. Not supported for video post creatives |
Ad Creative Details | Image url | DIMENSION | IMAGE_URL | A URL for the image creative. |
Ad Creative Details | Creative Object type | DIMENSION | STRING | The 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 Details | Call to action type | DIMENSION | STRING | Type of call to action button in your ad. This determines the button text and header text for your ad. |
Ad Creative Details | Thumbnail url | DIMENSION | STRING | URL for a thumbnail image for this ad creative. |
Ad Creative Details | Link url | DIMENSION | STRING | Identify a specific landing tab on your Facebook page by the Page tab's URL |
Ad Creative Details | Object url | DIMENSION | STRING | URL that opens if someone clicks your link on a link ad. This URL is not connected to a Facebook page. |
Ad Creative Details | Link to Promoted Post | DIMENSION | STRING | The URL directing to the promoted post. |
Ad Creative Details | Object link url | DIMENSION | STRING | URL that opens if someone clicks your link on a link ad. |
Ad Creative Details | Object message | DIMENSION | STRING | The main body of the post linked to the ad creative. |
Ad Creative Details | Object name | DIMENSION | STRING | Can be name of the link provided / title of the video creative. |
Ad Creative Details | Object link caption | DIMENSION | STRING | A link caption that reflects to the advertisor / business. |
Ad Creative Details | Object description | DIMENSION | STRING | The description for the link. |
Ad Creative Details | Object CTA type | DIMENSION | STRING | The type of the call-to-action. Eg., OPEN_LINK, BOOK_TRAVEL, CALL. |
Ad Creative Details | Url tags | DIMENSION | STRING | A 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 Details | Template url | DIMENSION | STRING | Used by Dynamic Ads when you want to use third-party click tracking. |
Ad Creative Details | Template url spec | DIMENSION | STRING | Used for Dynamic Ads when you want to use third-party click tracking. |
Ad Creative Details | Page name | DIMENSION | STRING | The Facebook Page associated with the business your ad is promoting. |
Lead Ads | Lead ID | DIMENSION | STRING | Unique ID of the lead. |
Lead Ads | Lead created time | DIMENSION | DATETIME | Time the lead was created |
Lead Ads | Lead field data | DIMENSION | STRING | Form field data submitted by the user |
Lead Ads | Lead form ID | DIMENSION | STRING | Form ID used for the lead |
Lead Ads | Lead email | DIMENSION | STRING | Email submitted by the user |
Lead Ads | Lead phone number | DIMENSION | STRING | Phone number submitted by the user |
Lead Ads | Lead full name | DIMENSION | STRING | Full name submitted by the user |
Lead Ads | Lead company name | DIMENSION | STRING | Company name submitted by the user |
Lead Ads | Lead country | DIMENSION | COUNTRY | Country submitted by the user |
Lead Ads | Lead state | DIMENSION | STRING | State submitted by the user |
Lead Ads | Lead city | DIMENSION | CITY | City submitted by the user |
Lead Ads | Lead field 1 name | DIMENSION | STRING | Name of the form field 1 submitted by the user |
Lead Ads | Lead field 1 value | DIMENSION | STRING | Value of the form field 1 submitted by the user |
Lead Ads | Lead field 2 name | DIMENSION | STRING | Name of the form field 2 submitted by the user |
Lead Ads | Lead field 2 value | DIMENSION | STRING | Value of the form field 2 submitted by the user |
Lead Ads | Lead field 3 name | DIMENSION | STRING | Name of the form field 3 submitted by the user |
Lead Ads | Lead field 3 value | DIMENSION | STRING | Value of the form field 3 submitted by the user |
Lead Ads | Lead field 4 name | DIMENSION | STRING | Name of the form field 4 submitted by the user |
Lead Ads | Lead field 4 value | DIMENSION | STRING | Value of the form field 4 submitted by the user |
Lead Ads | Lead field 5 name | DIMENSION | STRING | Name of the form field 5 submitted by the user |
Lead Ads | Lead field 5 value | DIMENSION | STRING | Value of the form field 5 submitted by the user |
Lead Ads | Lead field 6 name | DIMENSION | STRING | Name of the form field 6 submitted by the user |
Lead Ads | Lead field 6 value | DIMENSION | STRING | Value of the form field 6 submitted by the user |
Lead Ads | Lead field 7 name | DIMENSION | STRING | Name of the form field 7 submitted by the user |
Lead Ads | Lead field 7 value | DIMENSION | STRING | Value of the form field 7 submitted by the user |
Lead Ads | Lead field 8 name | DIMENSION | STRING | Name of the form field 8 submitted by the user |
Lead Ads | Lead field 8 value | DIMENSION | STRING | Value of the form field 8 submitted by the user |
Lead Ads | Lead field 9 name | DIMENSION | STRING | Name of the form field 9 submitted by the user |
Lead Ads | Lead field 9 value | DIMENSION | STRING | Value of the form field 9 submitted by the user |
Lead Ads | Lead field 10 name | DIMENSION | STRING | Name of the form field 10 submitted by the user |
Lead Ads | Lead field 10 value | DIMENSION | STRING | Value of the form field 10 submitted by the user |
Impression/Platform/Device | Impression device | DIMENSION | STRING | The device where your last ad was served to someone on Facebook. For example "iPhone" if someone viewed your ad on an iPhone. |
Impression/Platform/Device | Place page id | DIMENSION | STRING | The ID of the place page involved in impression or click. |
Impression/Platform/Device | Publisher platform | DIMENSION | STRING | Which platform your ad was shown, for example on Facebook, Instagram, or Audience Network. |
Impression/Platform/Device | Publisher position | DIMENSION | STRING | Where your ad was shown within a platform, for example on Facebook desktop News Feed, or Instagram Mobile News Feed. |
Impression/Platform/Device | Device platform | DIMENSION | STRING | The type of device, mobile or desktop, used by people when they viewed or clicked on an ad, as shown in ads reporting. |
Impression/Platform/Device | Action Device | DIMENSION | STRING | The device on which the conversion event you're tracking occurred. For example, 'Desktop' if someone converted on a desktop computer. |
User | Gender | DIMENSION | STRING | Gender of people you've reached. People who don't list their gender are shown as 'not specified'. |
User | Age | DIMENSION | STRING | The age range of the people you've reached. |
User | Country code | DIMENSION | COUNTRY_CODE | The 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. |
User | Country | DIMENSION | COUNTRY | The 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. |
User | Region/State | DIMENSION | REGION | The 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. |
User | DMA region | DIMENSION | STRING | DMA (Designated Market Area) regions are the 210 geographic areas in the United States in which local television viewing is measured by The Nielsen Company. |
User | User segment | DIMENSION | STRING | User segment (ex: new, existing) of Advantage+ Shopping Campaigns (ASC). Existing user is specified by the custom audience in ASC settings. |
Product | Product ID | DIMENSION | STRING | The ID and name of the product involved in impression, click, or action. |