# Facebook Insights Data Connector User Guide

> **Note:** Facebook Insights provides valuable data about your Facebook Page's performance, audience, and content engagement. This guide will help you set up and use Facebook Insights as a data source in Power My Analytics.

[![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-1.png)](https://lookerstudio.google.com/reporting/51595ba5-1c3e-4137-a156-07f466d322df)

## Prerequisites

Before connecting Facebook Insights to Power My Analytics, ensure you have:

- A Facebook account with the following permissions:

    - For classic page management: Administrator access
    - For Business Manager: Page Editor access
    - For New Page Experience: Partial access with Content, Community activity, Messages, Ads, and Insights permissions

        ![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-2.png)

The Power My Analytics app in [Facebook's Business Integrations](https://www.facebook.com/settings/?tab=business_tools) must have these permissions:

- Access your Page and App insights
- Read content posted on the Page
- Read user content on your Page
- Show a list of the Pages you manage

## Adding Facebook Insights as a Data Source

1. To add the correct Facebook account, you must be logged in to that account in your browser. Open an Incognito window in your browser to log into the correct Facebook account before connecting with Power My Analytics.
2. Log in to your Power My Analytics account and navigate to the **Sources** page.
3. Click the **\+ New Data Source** button and select Facebook & Instagram from the gallery.
4. Grant Facebook business access by selecting "Opt in to all current and future Businesses" and click **Continue**.
5. Grant Facebook page access by choosing "Opt in to all current and future Pages" and click **Continue**.
6. Grant Instagram account access by selecting "Opt in to all current and future Instagram accounts" and click **Continue**.
7. Finalize permissions by clicking **Save**, then click **Got it**.

## Creating a Data Studio Report

Follow these steps to create a Data Studio report using your Facebook Insights data:

1. After adding Facebook Insights as a data source, go to **Reports > Data Studio** in your Power My Analytics hub
2. Click on Facebook Insights under Create Data Studio Report to open the official Data Studio application
3. Google Data Studio Configuration:

    - Step 1:

        - Name your data source (e.g., "Facebook Insights - \[Your Organization\]")
        - Select your Power My Analytics hub from the dropdown
        - Optional: Keep "Use report template for new reports" checked to use the PMA demo template
        - Click **Next**

    - Step 2:

        - User Account: Choose your Facebook Insights account or "Sample Account" for sample data
        - Click **Next**

    - Step 3:

        - Choose “Page” for reports
        - Optional: Allow “Page” modification in reports
        - Click **Connect** in the top right to complete the configuration

    - Step 4:

        - Click **Create Report** in the top right
        - Include "today" in your report's date range to begin historical data storage

For a quick start, you can use our pre-built [Facebook Insights demo template](https://lookerstudio.google.com/reporting/51595ba5-1c3e-4137-a156-07f466d322df).

## Key Reports and Fields

Popular metrics for Facebook Insights include:

- Page Metrics: Total Page Followers (lifetime), New Followers, Page Likes
- Post Metrics: Views (Facebook views), Content Interactions
- Interaction Metrics: Reactions, Comments Total, Shares, Post Link Clicks, Likes, Engagement
- Audience Metrics: Age and Gender
- Review Metrics: Review Rating by Review Creation Date, Reviewer Name, Review Text, Recommendation Type
- Location Metrics: Total People Who Viewed by City, Total People Who Viewed by Country
- Reels Metrics: Total Plays, Replays

For a complete list of available Facebook Insights fields, refer to the [Schema Explorer](https://hub.powermyanalytics.com/resources/schema/facebook_pages).

> **Note:** On June 15, 2026, Meta is deprecating a large group of legacy reach, impression, and video view metrics in the Facebook Insights API, including Reach, Post Reach, and most video impression and unique video view fields. These fields will no longer receive new data after that date; data already collected remains available in your reports. See [Facebook Insights Deprecated Legacy Reach and Video View Metrics (June 15, 2026)](https://knowledge.powermyanalytics.com/application/sources/facebook-insights-deprecated-legacy-reach-and-video-view-metrics-june-15-2026/) for the complete list of affected fields and recommended alternatives.

> **Note:** Using our Facebook Page Insights demo template? Its "most recent posts" overview (and the Post Reach scorecards) were built on the Reach field, which now returns 0. See [Reach Reads 0 on Every Post, and I Cannot Find the Replacement Field](https://knowledge.powermyanalytics.com/application/sources/reach-reads-0-on-every-post-and-i-cannot-find-the-replacement-field/) to switch to Views (Facebook views) and refresh your report's field list.

## Limitations and Important Considerations

- **Cached Data Requests with Unique Metrics and Date Dimension:** When a unique metric is paired with the date dimension, this will result in a request for cached data instead of a request for live data. For more information, please see [Understanding Cached and Live Data Requests](https://knowledge.powermyanalytics.com/support/faq/understanding-cached-and-live-data-requests/#a-special-case-unique-metrics-paired-with-the-date-dimension).
- **Backfilling:** Up to 2 years. Meta's API provides only the last two years of Page Insights data.

    - Metrics that cannot be backfilled: Age, Gender, and Location are lifetime metrics and cannot be backfilled.
- **Time Zone:** All data is reported in time zone UTC-8:00 (UTC-7:00 during Daylight Saving Time).
- **Unique Metrics:** Unique metrics are fields that count individual users. Unique metrics can only be summed in the following periods: 1 day, 7 days, 28 days
- **48-Hour Delay in Pages:** Allow 48 hours after connecting Facebook Insights as a data source for all pages to appear.
- **Over 100 Pages:** If your account has more than 100 pages, Facebook will not return a complete list of pages.
- **Minimum Page Size:** Meta provides Page Insights data only for Pages with 100 or more likes.
- **Data Updates:** Meta updates most Facebook Insights metrics once every 24 hours.
- **Unique Metric Estimates:** Meta calculates unique metrics as estimates, each one independently, so a unique total may not equal the sum of its parts.
- **Breakdown Values of Zero:** Meta returns only non-zero values for Page post and Page view breakdowns, so a breakdown value with no activity shows as blank rather than 0 in your report.
- **Video Metrics for Reshared Videos:** Some video metrics are accurate only for videos your Page created. For a video your Page reshared from another Page, those metrics show 0.
- **Reels Interactions:** Meta's Page Insights metrics do not include interactions on Reels.
- **Demographic Metrics:** Age, gender, and location are only available when there is data for 100 or more people.
- **Demographic Reporting Limitations:** Demographics data is only available as lifetime and does not include the most recent 3 days. Reports including the most recent 3 days will display “No data”.
- **Video Posts:** Video data is only available for the past year.
- **Tagged Posts:** Pages that tagged you will only be reported if Facebook considers the Page to be authentic.
- **Privacy:** Pages may conceal post data from accounts that do not have permission to see them. User information may also be concealed.
- **New Account Delay:** After adding a new account in Facebook, it is necessary to wait 24 hours before using this account in your PMA reports.
- **API and Authentication**: Facebook and Instagram use the same underlying API. PMA's Facebook Ads, Facebook Insights, Instagram Ads, and Instagram Insights data connectors use the same authentication process.
- **Pages Lifetime Data Delay:** Data from fields in the Pages Lifetime table is delayed by 48 hours. You can view affected metrics by searching for the Pages Lifetime table under Facebook Insights in our Schema Explorer.

    ![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-3.png)

### Unavailable Data

- Messages
- Actions on Page
- Facebook's API provides limited data on Stories. Instead, use the metric **Video Stories by Action Type Distribution** with the dimension **Video Stories by Action Type**.
- Orders
- Page likes by age and gender
- Realtime data
- Custom fields

### Show Multiple Pages in One Report

To include multiple pages in the same report:

1. On the connector configuration page, select **Allow "page" to be modified in reports**.

    ![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-4.png)
2. Select all of the pages you would like to show and compare in your report. All of the pages managed by your Facebook account should be available.

    ![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-5.png)
3. Select any chart and use the **Parameters** drop-down menu to select the page you wish to report on.

    ![](https://knowledge.powermyanalytics.com/application/sources/images/facebook-insights-data-connector-user-guide-6.png)
4. Create multiple tables to compare page performance.

### Show Daily New Followers

[Use our Google Sheets extension](https://knowledge.powermyanalytics.com/application/troubleshooting/report-daily-new-followers-in-facebook-instagram-and-twitter/) to calculate new followers and see this metric that is not included in Facebook's API.

### Post Type (Type Field)

If you're comparing how your different content formats perform, here's what you need to know about the **Type** field in the Posts report.

**What Type tells you**

Type is useful, but it answers a narrower question than you might expect: it tells you the action that created the post, not what the post looks like. Type shows values that come straight from Facebook, so they look like Meta's own internal wording rather than friendly labels. The two you'll see most often:

| Value in your report | What it means |
| --- | --- |
| added\_photos | One or more images were posted |
| added\_video | A video was posted |

Other values appear occasionally, such as *shared\_story* (a shared post) and *mobile\_status\_update* (a text post published from a phone).

**The catch: single images and carousels look identical**

> **Note:** A post with one photo and a post with ten photos both return **added\_photos**. Grouping by Type won't separate them, and no other field in Facebook Insights will either: Facebook does track the difference, but it keeps it in a part of its API that reports on individual post attachments, which Power My Analytics doesn't currently collect. If you need a single-image-versus-carousel comparison today, you'll need to tag those posts yourself (for example, by keeping a short list of your carousel post IDs and blending it into your report).

**What Type is good for**

Use it to separate images from video within the Posts table, when you want both in one chart. For a clean video and Reels breakdown with video-specific metrics, build a separate Videos table instead: see [How to Create Separate Posts and Video Tables for Facebook Insights](https://knowledge.powermyanalytics.com/application/sources/create-separate-posts-and-video-tables-for-facebook-insights/).

## Troubleshooting

See our article [Troubleshooting Facebook](https://knowledge.powermyanalytics.com/application/sources/troubleshooting-facebook-insights/) for information on issues that may affect Facebook connectors.

**Related:** [Why Per-Video and Per-Post Metrics Can't Be Reported by Day (YouTube, Facebook, Instagram, TikTok)](https://knowledge.powermyanalytics.com/application/sources/why-per-video-and-per-post-metrics-can-t-be-reported-by-day-youtube-facebook-instagram-tiktok/) — why per-post metrics are lifetime totals and how to build a daily view.
