Overview

This node integrates with the Facebook Graph API to retrieve analytics data for a Facebook Page. Specifically, the 'Get Page Insights' operation fetches various metrics such as total page views, impressions, fans, and engaged users over the past week. This is useful for social media managers and marketers who want to monitor the performance and engagement of their Facebook Pages to optimize content and strategy.

Use Case Examples

1. A social media manager uses this node to automatically pull daily page insights into a dashboard for performance tracking.
2. A marketing automation workflow triggers this node to fetch weekly page analytics and sends a report via email to stakeholders.

Properties

Output

JSON

• success - Indicates if the API request was successful.
• message - A descriptive message about the result of the operation.
• pageId - The ID of the Facebook Page for which insights were retrieved.
• insights - An array of insight metrics data returned from the Facebook API, including metrics like page views, impressions, fans, and engaged users.

Dependencies

• Requires a Facebook OAuth2 API credential with permissions to access Facebook Pages and their insights.

Troubleshooting

• Ensure the Facebook OAuth2 credentials are valid and have the necessary permissions (e.g., pages_show_list, pages_read_engagement).
• If no pages are found, verify that the connected Facebook account has admin or task access to at least one Facebook Page.
• Invalid or expired access tokens will cause authentication errors; reconnect the Facebook account in the credential settings.
• API rate limits or permission issues may cause errors; check Facebook app permissions and token scopes.

Links

• Facebook Graph API - Page Insights - Official documentation for the Facebook Page Insights API endpoint.