Contents x
    Facebook Page Insights
    • 5 Minutes to read
    • Dark
      Light
    Contents

    Facebook Page Insights

    • 5 Minutes to read
    • Dark
      Light
    Article summary

    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.

    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. 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 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 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 for further details.

    For more information, see our article on authorizers.

    How to Create a Facebook Page Insights Data Source

    1. On the Sources page, click on the Create Source button and select the connector from the list.
    2. From the drop-down menu, choose your authorizer.
      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.

    3. Name your data source and select your metrics and attributes.
    4. [Optional] Configure your advanced settings. If you are unsure about how to proceed, we recommend skipping this step.
    5. Configure your sync frequency or set the exact synchronization time under Show advanced settings.
      DATADDO TIP

      If you need to load historical data, refer to the Data Backfilling article.

    6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
    7. 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.

    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.
    • 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

    If your Facebook source is broken, check the extraction log to see the details of the issue.

    1. Go to Sources, click on the three dots and choose Test Extraction.
    2. For the following error messages, reauthorize the service (Facebook).
      "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\"}}"
    3. Restart the broken sources by clicking on the Manual Data Load icon next to your source.
      Facebook - authorization error log 2

    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, please try the following:

    Fully Reauthorize the Service

    1. Go to the 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.

    2. Go to your Facebook settings and navigate to the Business integrations tab.
    3. Find Dataddo and click on Remove.
    4. Now, go back to the Authorizers tab in Dataddo and authorize 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.

    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

    Sending Data to Data Storages

    Other Resources

    Was this article helpful?
    What's Next