Insights for your Facebook App, Domain or Page

Facebook Insights provides developers and Page owners with metrics about their content. By understanding and analyzing trends about usage and demographics as well as consumption and creation of content, you can be better equipped to improve your business and create better experiences on Facebook.

To see metrics on your Facebook Page or app, go to the Insights Dashboard. Only Page administrators, app owners and domain administrators can view Insights data for the properties they own or administer. To view comprehensive Insights on your specific Page, app or website, click the corresponding item on the left navigation bar. If you need to access this data programmatically, you can access Insights through the Graph API Insights object.

Domain Insights

Facebook Insights for domains offers a consolidated view of key metrics for any website, even those that have not implemented Facebook platform. For example, if people link to your site in their Facebook status message, that data is included in the analytics for your domain. You can access sharing metrics and demographic information per domain and per URL so you can optimize your content for sharing and better tailor your content to your audience.

Claiming a domain

To see Insights for your website, you must first claim your domain by associating it with a Facebook app that you manage, or with your Facebook user account. Here's how to do this:

Click the Insights for your Website button on the top right of the Insights Dashboard.
Type your domain name into the text box and select the user or app that you want to "own" this domain within Facebook Insights. If you pick an app, all admins of the app will become Insights admins of this domain.
Copy the fb:admins or fb:app_id meta tag shown in the dialog and add it to the <head> of your web page.
Click the Get Insights button. Once we check that the correct fb:admins or fb:app_id tag is present, the claimed domain will appear on the left navigation bar in the "domains" section.

You can also manually customize these meta tags and then add them to your site before clicking the Get Insights button to claim the domain:

    <meta property="fb:admins" content="1234,1235" />
    <meta property="fb:app_id" content="your_app_id" />

fb:admins can take a value of a single user ID or a comma-separated list of user IDs.
fb:app_id can take a value of a single app ID.

App Insights

To build the best possible experience for people using your app, use Insights to track how its being used. For app administrators, Insights includes feedback for stream stories, referral traffic to your app, a breakdown of the actions that contribute to active user count, demographics on authorized users and active users and the number of times permissions are prompted and granted. Detailed Insights on Open Graph activity for your app are also available. In addition, Insights provides diagnostics for your app so you can track API errors as well as get access to allocations and throttling information.

You can access Insights for your app directly through the Insights Dashboard.

Page Insights

If you administer a Facebook Page or have integrated Open Graph into your web pages, you can see analytics for referral traffic and stream stories in the Insights dashboard, as well as tab views for your Facebook Pages. Insights captures data about engagement with Pages regardless of whether an action occurred on or off Facebook.

Exporting Content

Dashboard Export

The Insights Dashboard lets you export all data for your app, page or domain into a .CSV or Excel file. To do this click the Export button at the top left corner of the Insights Dashboard for any app, page or domain. The export dialog lets you specify a date range for the data you want to export.

API

Beyond the Insights Dashboard, you can use the Graph API to find additional data about your Page, app or domain. To get started, use the Graph API Explorer to learn about Graph API.

FAQs

Q: How long does it take Facebook to process and display Insights data?

A: The data you access through Insights is at most 48 hours old. In the event of a delay, we will announce it on Platform Status.

Q: What time zone are your metrics based on?

A: All daily, weekly and monthly Insights data are aggregated according to PDT (Pacific Daylight Time).

Q: What's the minimum number of people who have to like a Page before I can see Insights for that Page?

A: For privacy reasons, Insights are only provided to Pages that have been liked by more than 30 people.

Q: What is an active user?

A: For apps, people are considered active users if, having granted the app permissions, they have done one of the following:

Visited the app Canvas page
Viewed the app on a Page profile tab
Visited an external website when logged into that site with their Facebook account
Had the Facebook API called on their behalf with an active user session.

People who have not granted permissions to your app are not considered active users, but they're counted in other metrics such as impression data. For Pages, people are considered active users if they have visited the Page, viewed a post by the Page or interacted with a post.

Q: What geographic and demographic data is available?

A: Facebook Insights lets you see geographic and demographic data for people that have liked a Page or installed an app. Location data is based on the geographic location of each person as determined by their browser IP address and is limited to the top 20 countries and cities. All other demographic information is aggregated and non-personally identifiable.

Q: I am a Page administrator. Why can't I see Insights for my Page?

A: Insights are only available to pages liked by at least 30 people. Insights start showing up for your page once your page has 30 users who have liked it.

Q: Why does the count next to my Like Button not match what I see in Insights?

A: The count next to the Like button represents the sum of Like button clicks, News Feed likes, News Feed comments and shares on Facebook.