Facebook indicates that their Insights metrics are only generated for a Facebook Page that has more than 100 people that like it. Likewise, demographic metrics, such as age, gender and location, are available in Page Insights once there is data for 100 or more people.

Facebook requires that you be a Facebook Page Admin and logged into your Facebook account in another tab / window prior to connecting the account to Rank Ranger (or ask an Admin to authorize the Rank Ranger connection for you).

Facebook requires that connections to external applications be renewed approximately every 60 days. We send automated emails 14 days before the connection is expected to expire, with a link directly to the Authorized Connection page where you can click a Renew button to prevent expiration and ensure reports contain the data you expect.

Facebook limits the amount of data available via their API to 90 days. We follow Facebook's best practices in order to provide the reporting that they allow. We review third-party developer API changes monthly, so if they change the rules to allow for a longer reporting period, we'll update our reports accordingly.

Confirm Your Authorization

Facebook Page Administrators

You must be a Facebook PageAdmin in order to authorize data integration. Confirm your status as a Page Admin: when viewing the Facebook page of the company, organization or product, you should see a Settings option in the upper right of the screen.

If you do not see the Settings option then you will need to ask the page owner to make you a Page Admin.

If you do see the Settings option, then click it.

Facebook Page Roles

Navigate to the Page Roles screen and confirm that you are a page Admin, as opposed to Editor, Moderator, Advertiser or Analyst. If you are not listed as a Page Admin then you will need to request a role upgrade from an existing Page Admin or ask an Admin to authorize the Rank Ranger connection for you.

Authorize Facebook Connection

Click Settings in the top right navigation or hover over the person icon and select My Account.

Access Authorized Connections

Scroll down to the Connections section of the sidebar and click Authorized Connections.

If no connections have been previously added to your account, you will see a blank Manage Connections table.

Add Authorized Connection

Click the Add Connection button to expand the option list.

Click the Facebook button.

Authorize Rank Ranger Facebook App: Permissions

In order to provide your with Facebook reports and tools, Rank Ranger requires your authorization to receive your public profile information, access your Page and App insights, ads and related stats for display in your social analytics reports in our marketing platform. Authorization also enables you to post to your Facebook Page, read and respond to messages and manage ads through our app.

Rank Ranger will receive your public profile information: you may click the review the info our app will have access to and click the Okay button if you agree.

Authorizing Rank Ranger to post to Facebook enables you to post to your Facebook page and respond to messages using our app. Only you (and your account sub-users if you authorize them) will have the ability to enter and post content.
Select the list that you want to share posts on your page with and click the Okay button.

Click the "Choose what you allow" link to view the details of each permission.

Review each permission and click the Okay button when you've completed your choices.

Manage your Pages enables us to provide you with the Timeline report

Publish as Pages you manage allows you to post, comment and like as the pages you manage from inside our app

Manage your ads allows you to manager Ads from inside our app

Access your Page and App Insights enables us to provide you with Insights reports and graphs

Performance including Page Fans, Post and Page Impressions and Total Reach

Page Engagement

External Referrers Graph

Net Likes Graph (new likes minus the number of unlikes)

Total Reach Graph

Likes, Comments and Shares Graph

Glossary of Facebook Metrics

Page Metrics

New Likes: the number of new people who have liked the Facebook Page.

Page Checkins: the number of times that people have indicated in a Facebook post referencing the Facebook Page that they visited the business or organization's physical location by utilizing the checkin option in a personal post.

Page Fans (aka Likes): the total number of people who have liked the Page. (Unique Users)

Page Impressions: the number of impressions seen of any content associated with the Page. (Total Count)

Page Likes (aka Fans): the total number of people who have liked the Page. (Unique Users)

Page Mentions: the number of mentions of the Page that are attributed to your ads. A mention happens when a person types @ followed by your Page name, then selects your Page name from a list, in a Facebook post or comment.

Page Stories: the number of stories created about the Page.

People Engaged: the number of people who engaged with the Page. Engagement includes any click or story created. (Unique Users)

Total Reach: the number of people who have seen any content associated with the Page. (Unique Users)

Unlikes: the number of Unlikes of the Page (e.g., users who previously Liked the page, and later clicked the Unlike this Page option).

Page Post Metrics

Organic Impressions: the total number of unique people who were show your Page post through unpaid distribution.

Paid Impressions: the total number of unique people who were shown your post as a result of ads

Post Clicks: the number of clicks on any of your content. Stories generated without clicks on page content (e.g., liking the page in Timeline) are not included. (Total Count)

Post Impressions: the number of impressions resulting from all Page posts. (Total Count)

Post Likes: the total number of unique likes per post.

Post Reach: the number of people who saw any of the Page posts. (Unique Users)

Post Shares: the total number of times someone shared a Page post.

Posts by a Page: the number of times content posted by a Facebook Page has been referenced on another page.

Posts by People on a Page: the number of times that people posted on a page.

About Facebook Business Manager

Facebook requires a personal user account login with Page Admin role in order to integrate their Page Insights and Ad performance report data with Rank Ranger. According to Facebook, Business Manager permissions cannot be used for access to reporting data via the Facebook Page or Ads Reporting API.

Our development team has thoroughly researched the Facebook Business Manager API and learned that it does not provide access to reporting data or the ability to allow our users one login for all Facebook pages and ad accounts. This is clarified in the Facebook Developer documentation that indicates: