--- title: "Facebook Page Insights" slug: "facebook-page-insights" description: "Get all your Facebook Page Insights metrics with Dataddo. Easily create a Facebook Page Insights data source and extract data from up to 5 years back." updated: 2024-05-10T17:56:28Z published: 2024-05-10T17:56:28Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt > Use this file to discover all available pages before exploring further. # Facebook Page Insights **Facebook Page Insights** is a tool that offers detailed analytics and metrics for Facebook Pages. It provides data on the performance of a Page, including information about audience demographics, post reach, engagement, and other key metrics, helping Page administrators understand and optimize their content strategy to better engage with their audience. Refer to Facebook's official documentation to see [all available endpoints from the Facebook Page API](https://developers.facebook.com/docs/graph-api/reference/page/). If you have multiple Facebook Pages and would like to extract the same data from all of them, it's possible through [multi-account extraction](/docs/multi-account-extraction). Contact our Solutions team to enable this feature. ## Authorize Connection to Facebook Page Insights To authorize this service, use **OAuth 2.0** to share specific data with Dataddo while keeping usernames, passwords, and other information private. 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select your service. 2. Follow the on-screen prompts to grant Dataddo the necessary permissions to **access and retrieve** your data. 3. **[Optional]** Once your ***authorizer*** is created, click on it to **change the label** for easier identification. Ensure that the account you're granting access to holds at least **admin-level permissions**. If necessary, assign a team member with the required permissions with the [authorizer role](https://docs.dataddo.com/docs/user-roles#authorizer) to authenticate the service for you. The best practice is to create a dedicated **Admin System User** in Facebook Business Manager. For more details, refer to the [official Facebook documentation](https://developers.facebook.com/docs/marketing-api/system-users) for further details. For more information, see our article on [***authorizers***](https://docs.dataddo.com/docs/authorized-services). ## How to Create a Facebook Page Insights Data Source 1. On the **Sources** page, click on the [**Create Source**](https://app.dataddo.com/sources/new) button. 2. Select the connector from the list and name your ***data source***. 3. On the **Dataset** step, select your **dataset**. **DATADDO TIP** If you're unsure which dataset to select, use the search bar to look for datasets with the desired attributes or metrics. 4. On the **Account** step select your ***authorizer*** from the drop-down menu. **Didn't find your authorizer?** Click on **Add new Account** at the bottom of the drop-down and follow the on-screen prompts. You can also go to the **Authorizers** tab and click on [**Add New Service**](https://app.dataddo.com/service/new). 5. On the **Attributes and Metrics** step, select the **metrics and attributes** you want to extract. ![Create a source using a custom-schema connector.](https://cdn.document360.io/084ed225-3f99-4644-a2da-39ca0cd5ef45/Images/Documentation/Create%20Source%20-%20Custom-Schema%20Connector.png) 6. On the **Metadata** step, select which [**metadata fields**](/docs/metadata-inclusion) such as extraction time to add to your data. 7. On the **Snapshot** step: 1. Configure your [**sync frequency**](/docs/extraction#extraction-frequency) or click **Show advanced settings** to set the exact synchronization time. **DATADDO TIP** If you need to **load historical data**, refer to the [**Data Backfilling**](https://docs.dataddo.com/docs/data-backfilling) article. 2. [Optional] Enable the **Allow Empty Data Extractions** toggle to allow the extraction when no data is available. 8. In the top-right corner, click **Test Data** button to preview extracted data. You can **adjust the date range** for a specific time frame. 9. Click on **Save** and **congratulations, your new data source is ready!** --- ## Limitations ### Number of Rows Under normal circumstances, the Facebook Page Insights API sets a hard limit on the total number of rows that can be extracted per call. To overcome this limitation, Dataddo supports automatic pagination to make multiple calls and retrieve all your data. ### Historical Data Limitation The Facebook Page Insights API has two limitations for historical data: - You may load up to **90 days per extraction batch**. - In total, you may extract up to **5 years** of historical data. For more information, refer to our [guide for data backfilling](/docs/data-backfilling). ## Troubleshooting ### Data Preview Unavailable No data preview when you click on **Test Data** might be caused by an issue with your ***source*** configuration. The most common causes are: - **Date range**: Try a smaller date range. You can load the rest of your data afterward using [manual data load](https://docs.dataddo.com/docs/data-backfilling). - **Insufficient permissions**: Please make sure your authorized account has at least admin-level permissions. - **Invalid metrics, attributes, or breakdowns**: You may not have any data for the selected metrics, attributes, or breakdowns. - **Incompatible combination of metrics, attributes, or breakdowns**: Your selected combination cannot be queried together. Please refer to the service's documentation to view a full list of metrics that can be included in the same ***data source***. ### Authorization Error Broken Facebook ***sources*** that return the following error messages when **testing the extraction** (broken ***source*** > three dots > **Test Extraction**) must be [reauthorized](/docs/authorized-services#how-to-reauthorize-your-account): ``` "response_status": "401 Unauthorized" ``` ``` "Www-Authenticate": "OAuth \"Facebook Platform\" \"invalid_token\" \"You cannot access the app till you log in to www.facebook.com and follow the instructions given.\"" ``` ``` "response_body": "{\"error\":{\"message\":\"You cannot access the app till you log in to www.facebook.com and follow the instructions given.\",\"type\":\"OAuthException\",\"code\":190,\"error_data\":\"{\\\"checkpoint_url\\\":\\\"https:\\\\\\/\\\\\\/www.facebook.com\\\"}\",\"error_subcode\":459,\"fbtrace_id\":\"AUWZQsg7Opr7SEpp_lk9wUa\"}}" ``` **DATADDO TIP** Once reauthorized, make sure to [load the missing data](/docs/data-backfilling). You can also click the [**Debug & Restart**](/docs/en/troubleshooting#how-to-fix-a-broken-source) icon next to the broken source and Dataddo will show you step-by-step how to reauthorize your account and execute a manual data load. ### Unable to Find Facebook Sub-Accounts If your access rights have changed or you gained access to a new Facebook account, it's possible that your other accounts will not be immediately listed in Dataddo. To fix this, try the following steps: **Fully Reauthorize the Service** 1. Go to the [Authorizers](https://app.dataddo.com/authorizers) tab in Dataddo and delete the Facebook ***authorizer***. Deleting an Authorizer Please keep in mind that you will first need to **delete all sources created with the *authorizer***. This will also affect your ***flows***. You can also temporarily switch the ***source*** using the authorizer to a different account before deletion. 2. Go to your Facebook settings and navigate to the [Business integrations](https://www.facebook.com/settings?tab=business_tools&ref=settings) tab. 3. Find Dataddo and click on **Remove**. 4. Now, go back to the Authorizers tab in Dataddo and [authorize](https://app.dataddo.com/service/new) your Facebook account again. **Check Your Account Permissions** If the method above doesn't work, please check your Facebook account's permissions. To access insights, make sure the permissions are **at least on the analyst/admin level**. ### Correct Date Range Setup Metrics are calculated in PST timezones, while the Facebook Page Insights API operates in UTC. Keep in mind that this will have an implication on the configuration of a [date range](/docs/setting-date-range). If you set the connector to query the data for **2020-11-21**, the Facebook API considers it as the value in **UTC** timezone. As such, the matching metrics will be in the **2020-11-21 08:00:00+0000** format which will correspond to the values associated with **2020-11-20** in your Business Manager. ### Invalid Insights Metric **ERROR MESSAGE** `The value must be a valid insights metric.` This issue is caused by some endpoints being deprecated after **April 18, 2024** when Graph API was updated to v19. The following fields now no longer return data: - `page_video_views_10s` - `page_video_views_10s_paid` - `page_video_views_10s_organic` - `page_video_views_10s_autoplayed` - `page_video_views_10s_click_to_play` - `page_video_views_10s_unique` - `page_video_views_10s_repeat` - `post_video_views_10s` - `post_video_views_10s_unique` - `post_video_views_10s_autoplayed` - `post_video_views_10s_clicked_to_play` - `post_video_views_10s_organic` - `post_video_views_10s_paid` - `post_video_views_10s_sound_on` These fields will be removed or replaced by their substitutes where available, however, if your ***source*** is still broken, please **restart** it. ## Related Articles Now that you have successfully created a ***data source***, see how you can connect your data to a dashboarding app or a data storage. **Sending Data to Dashboarding Apps** - [Simple Data Integration to Dashboards](https://docs.dataddo.com/docs/simple-data-integration-to-dashboards) - [Data Backfilling to Dashboarding Apps](https://docs.dataddo.com/docs/data-backfilling-to-dashboarding-apps) **Sending Data to Data Storages** - [Batch Ingestion to Data Warehouses](https://docs.dataddo.com/docs/ingestion-to-data-warehouses) - [Data Backfilling to Storages](https://docs.dataddo.com/docs/data-backfilling-to-storages) **Other Resources** - [Troubleshooting](https://docs.dataddo.com/docs/troubleshooting) - [Extraction Logs](https://docs.dataddo.com/docs/extraction-logs) - [Data Duplication](https://docs.dataddo.com/docs/data-duplication) Multi-account extraction (MAE) enables simultaneous data extraction from multiple e.g. Facebook accounts within a single source setup. This ensures consistent configuration of your data sources across all accounts. Authorizers act as credentials for external services (e.g. Facebook or Google). To enable Dataddo to access and retrieve your data, you need to grant access to accounts that possess admin-level permissions or higher within these services. Pagination divides large datasets into smaller 'pages' to manage and assemble complete data. This is useful when an API endpoint has a restriction on the number of records extractable in a single call.