· An app access token can retrieve all metrics for that app.
· A user access token with read_insights permission can retrieve metrics for all apps, pages and domains owned by this user.
· A page access token with read_insights permission can retrieve all metrics for that Page.
< Field ::: Description, id, name, period, values >
Naming Patterns for Metrics
· _unique suffix ---- shows the number of unique users who performed a specific action.
· The _login and _logout suffixes-------- indicate whether someone was logged into or out of Facebook.
· The _source suffix-------- metric will be broken down into a list of referral sources(External referrals by domains and internal by Facebook)
· Metrics that are marked with * are available in real-time, i.e., they are refreshed approximately every 15 minutes. Most other metrics will update once every 24 hours.
Available Metrics
App User Demographics
Name
Description
Values for `period`
application_active_users
1 day, 7 day, and 30 day counts of users who have engaged with your app or viewed your app
day, week, month
application_active_users_locale
Top locales of your active users
day
application_active_users_city
Top cities of your active users
day
application_active_users_country
Top countries of your active users
day
application_active_users_gender
Gender of your active users
day
application_active_users_age
Age of your active users
day
application_active_users_gender_age
Gender and age demographics of your active users
day
application_installed_users
Total installations of your app or connections to your Connect app
lifetime
application_installed_users_locale
Top locales of your app's installed user base
lifetime
application_installed_users_city
Top cities of your app's installed user base
lifetime
application_installed_users_country
Top countries of your app's installed user base
lifetime
application_installed_users_gender
Gender of your app's installed user base
lifetime
application_installed_users_age
Age of your app's installed user base
lifetime
application_installed_users_gender_age
Gender and age demographics of your app's installed user base
lifetime
application_installation_adds
New installations of your app or connections to your Connect site. Follows acceptance of your Terms of Service
day
application_installation_adds_unique
New installations of your app or connections to your Connect site. Follows acceptance of your Terms of Service
day
application_installation_removes
Removed installations of your app or connections to your Connect site
day
application_installation_removes_unique
Removed installations of your app or connections to your Connect site
day
application_tos_views
Impressions of the Terms Of Service dialog of your app
day
application_tos_views_unique
Impressions of the Terms Of Service dialog of your app
day
application_permission_views_top
Impressions of each permissions dialog type
day
application_permission_views_top_unique
Impressions of each permissions dialog type
day
application_permission_grants_top
Impressions of each permissions dialog type
day
application_permission_grants_top_unique
Impressions of each permissions dialog type
day
application_block_adds
Blocks of your app
day
application_block_adds_unique
Blocks of your app
day
application_block_removes
Removed blocks of your app
day
application_block_removes_unique
Removed blocks of your app
day
Page and Post Stories and "People talking about this"
Name
Description
Values for `period`
page_stories
The number of stories created about your Page (Stories)
day, week, days_28
page_storytellers*
The number of people sharing stories about your page ('People Talking About This' / PTAT). These stories include liking your Page, posting to your Page's Wall, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
Note that currently only the weekly value is in real-time if you set until=now in the request. This metric is deprecated after thedeprecate_PTAT migration.
day, week, days_28
page_stories_by_story_type
The number of stories about your Page by story type. This metric is deprecated after thedeprecate_PTAT migration.
day, week, days_28
page_storytellers_by_story_type
The number of people talking about your Page, by story type. This metric is deprecated after thedeprecate_PTAT migration.
day, week, days_28
page_storytellers_by_age_gender
The number of People Talking About the Page by user age and gender
day, week, days_28
page_storytellers_by_city
The number of People Talking About the Page by user city
day, week, days_28
page_storytellers_by_country
The number of People Talking About the Page by user country
day, week, days_28
page_storytellers_by_locale
The number of People Talking About the Page by user language
day, week, days_28
post_stories*
The number of stories generated about your Page post ('Stories')
lifetime
post_storytellers*
The number of unique people who created a story about your Page post ('People Talking About This' / PTAT)
lifetime
post_stories_by_action_type*
The number of stories created about your Page post, by action type
lifetime
post_storytellers_by_action_type*
The number of unique people who created a story about your Page post, by action type
lifetime
Page Impressions
Name
Description
Values for `period`
page_impressions
The total number of impressions seen of any content associated with your Page
day, week, days_28
page_impressions_unique
The number of people who have seen any content associated with your Page
day, week, days_28
page_impressions_paid
The number of impressions of a Sponsored Story or Ad pointing to your Page
day, week, days_28
page_impressions_paid_unique
Number of people who saw a sponsored story or Ad about your Page
day, week, days_28
page_impressions_organic
The number of times your posts were seen in News Feed or Ticker or on visits to your Page. These impressions can be Fans or non-Fans
day, week, days_28
page_impressions_organic_unique
The number of people who visited your Page, or saw your Page or one of its posts in News Feed or Ticker. These impressions can be Fans or non-Fans
day, week, days_28
page_impressions_viral
The number of impressions of a story published by a friend about your Page. These stories include liking your Page, posting to your Page's Wall, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
day, week, days_28
page_impressions_viral_unique
The number of people who saw your Page or one of its posts from a story published by a friend. These stories include liking your Page, posting to your Page's Wall, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
day, week, days_28
page_impressions_by_story_type
Total impressions of stories published by a friend about your Page by story type
day, week, days_28
page_impressions_by_story_type_unique
The number of people who saw a story about your Page by story type
day, week, days_28
page_impressions_by_city_unique
The number of people who have seen any content associated with your Page by city
day, week, days_28
page_impressions_by_country_unique
The number of people who have seen any content associated with your Page by country
day, week, days_28
page_impressions_by_age_gender_unique
The number of people who have seen any content associated with your Page by age and gender grouping
day, week, days_28
page_impressions_frequency_distribution
The number of people your Page reached broken down by how many times people saw any content about your Page
day, week, days_28
page_impressions_viral_frequency_distribution
The number of people your Page reached from a story published by a friend, broken down by how many times people saw stories about your Page
day, week, days_28
page_impressions_by_paid_non_paid
The total number of impressions seen of any content associated with your Page, broken down by total, paid, and non-paid
day, week, days_28
page_impressions_by_paid_non_paid_unique
The number of people seen of any content associated with your Page, broken down by total, paid, and non-paid
day, week, days_28
Page Engagement
Name
Description
Values for `period`
page_engaged_users
The number of people who engaged with your Page. Engagement includes any click
day, week, days_28
page_consumptions
The number of times people clicked on any of your content
day, week, days_28
page_consumptions_unique
The number of people who clicked on any of your content
day, week, days_28
page_consumptions_by_consumption_type
The number of times people clicked on any of your content, by type
day, week, days_28
page_consumptions_by_consumption_type_unique
The number of people who clicked on any of your content, by type
day, week, days_28
page_places_checkin_total
The number of times people checked into a place
day, week, days_28
page_places_checkin_total_unique
The number of people who checked into a place
day, week, days_28
page_places_checkin_mobile
The number of times people checked into a place using mobile phones
day, week, days_28
page_places_checkin_mobile_unique
The number of people who checked into a place using mobile phones
day, week, days_28
page_places_checkins_by_age_gender
gender and age of people who checked in at your Place
day
page_places_checkins_by_locale
top locales of people who checked into your Place
day
page_places_checkins_by_country
top countries of people who checked into your Place
day
page_negative_feedback
The number of times people took a negative action (e.g., un-liked or hid a post)
day, week, days_28
page_negative_feedback_unique
The number of people who took a negative action (e.g., un-liked or hid a post)
day, week, days_28
page_negative_feedback_by_type
The number of times people took a negative action broken down by type (see negative feedback types)
day, week, days_28
page_negative_feedback_by_type_unique
The number of people who took a negative action broken down by type see negative feedback types)
day, week, days_28
page_positive_feedback_by_type
The number of times people took a positive action broken down by type (see positive feedback types)
day, week, days_28
page_positive_feedback_by_type_unique
The number of people who took a positive action broken down by type (see positive feedback types)
day, week, days_28
page_fans_online
The number of your fans who saw any posts on Facebook on a given day, broken down by hour of day in PST
day
page_fans_online_per_day
The number of your fans who saw any posts on Facebook on a given day.
