Our Facebook data source has been designed for Facebook Pages.
Important note
This integration cannot be used with personal Facebook profiles.
Facebook Pages allow individuals and organizations to connect with their fans on the world's most popular social network.
You can customize your Facebook Page by posting stories, hosting events, adding apps and more. People who like your Facebook Page and their friends can get updates in News Feed.
Create a new Facebook widget
To create a Facebook widget for your dashboard, follow these steps:
- Click , located in the top right of your dashboard.
- Search for Facebook using the Search sources field.
Alternatively, you can also scroll down the alphabetical list of integrations until you reach the Facebook integration. - Click on the Facebook integration.
Is this is your first Facebook widget?
You'll need to connect your Facebook account to Geckoboard. If not, you can skip to configuring your Facebook widget.
Creating a connection and authenticating with Facebook
When adding your first Facebook widget, you'll be asked to create a connection and authenticate your Facebook account with Geckoboard. 
Facebook uses OAuth to authenticate meaning you will briefly be taken to Facebook to allow Geckoboard to access data associated with your Facebook Pages.
Follow the steps below to allow Geckoboard access to your Facebook Page and App Insights.
- After selecting the Facebook integration and a widget type in the previous steps, when prompted, log into your Facebook account.
- Select the Choose what you allow option.
- On the next page, ensure that Manage your Pages is toggled on.
- Check the box next to Pages.
- Then check the box next to the names of the Pages you want to use within Geckoboard.
- Next, make sure Access your Page and App insights is toggled on.
- Click OK, and your account will be connected!
Types of Facebook widgets and example configurations
We'll be tracking Geckoboard's Facebook Page stats.
Page Stats List
The Page Stats List widget displays metrics in a particular time frame from your Facebook Page as a list.
You can track the following metrics:
- Top Referring Domains
- Top Like Source by Likes
- Top Like Source by People
- Top Story Types by Stories
- Top Story Types by Storytellers
- Top Story Types by Page Impressions
- Top Story Types by Unique Page Views
- Top Consumption Types by Clicks
- Top Consumption Types by People
- Top Countries by Storytellers
- Top Countries by Page Places Checkins
- Top Cities by Unique Page Views
- Top Languages by Storytellers
- Top Languages by Page Places Checkins
- Top Negative Feedback Types by Actions
- Top Negative Feedback Types by People
- Frequency Distribution by Page Impressions
- Frequency Distribution by Virality
- Frequency Distribution by Page Post Impressions
Example configuration
To track the "Top Cities by Unique Page Views" in the last 90 days, use the following widget configuration:
Title: Top Cities by Unique Page Views in the last 90 days
Facebook Page: The Page you’d like to show data from (one account can have many Pages). In this example: Geckoboard's Facebook Page
Metric: Top Cities by Unique Page Views
Time Period: In last 90 days
Page Stats Number Widget
The Page Stats Number widget displays metrics for different types of interactions in a particular time frame from your Facebook Page as a number.
You can track the following metrics:
Page Engagement
- Engaged Users
- Consumptions
- Unique Consumptions
- Page Place Checkins
- Unique Page Place Checkins
- Page Place Mobile Checkin
- Negative Actions
- Unique Negative Actions
Page Likes
- Total Likes
- New Likes
- Unique New Likes
- New Unlikes
- Unique New Unlikes
Page Views
- Page Views
- Unique Page Views
- Logged-in Page Views
- Logged-out Page Views
Page Impressions and Stories
- Page Impressions
- Unique Page Impressions
- Paid Page Impressions
- Unique Paid Page Impressions
- Organic Page Impressions
- Unique Organic Page Impressions
- Viral Page Impressions
- Unique Viral Page Impressions
Example configuration
To track the "New Likes" in the last 7 days, use the following widget configuration:
Title: New Likes in the last 7 days
Facebook Page: The Page you’d like to show data from (one account can have many Pages). In this example: Geckoboard's Facebook Page
Interaction: Page Likes
Metric: New Likes
Time Period: In last 7 days
Show comparison to a previous period: Yes
Metric: New Likes
Compare with: 7 days ago
Post Stats Number Widget
The Post Stats Number widget displays metrics for recent posts on your Facebook Page as a number.
You can track the following metrics:
- Post Likes
- Post Comments
- Post Shares
- Post Consumptions
- Unique Post Consumptions
- Engaged Users
- Post Negative Feedback
- Unique Post Negative Feedback
- Post Impressions
Example configuration
To track the "Post Likes" of your most recent Page Post, use the following widget configuration:
Title: Most Recent Post Likes
Facebook Page: The Page you’d like to show data from (one account can have many Pages). In this example: Geckoboard's Facebook Page
Page Posts: Most Recent Post
Metric: Post Likes
Page Demographics Bar Chart
The Page Demographics Bar Chart widget display demographic (age group and sex) info for metrics including Page Impressions, Likes and Storytellers in a particular period of time as a Bar Chart.
Example configuration
To track demographic data of "Page Impressions" last week, use the following widget configuration:
Title: Page Impressions Weekly
Facebook Page: The Page you’d like to show data from (one account can have many Pages). In this example: Geckoboard's Facebook Page
Metric: Page Impressions
Time Period: Last Week
Page Stats Line Chart
The Page Stats Line Chart widget compares metrics for different types of interactions during two separate periods of time and displays the comparison as a line chart.
Example configuration
To compare "Total Page Views" in the last 7 days against "Total Page Views" in the last 7 days of the previous month, use the following widget configuration:
Title: Total Page Views in the last 7 days vs a month ago
Facebook Page: The Page you’d like to show data from (one account can have many Pages). In this example: Geckoboard's Facebook Page
Interaction: Views
Metric: Total Page Views
Time Frame: In last 7 days
Comparison Period: One month ago
