Actions72
- Pages Actions
- Posts Actions
- Groups Actions
- Events Actions
- Insights Actions
- Marketing/Ads Actions
- Videos Actions
- Messaging Actions
- Shop/Catalog Actions
- Lead Ads Actions
- Webhooks Actions
Insights → Get Event Insights
AI-generatedOverview
The "Get Event Insights" operation of the Facebook Enhanced node retrieves analytical metrics related to a specific Facebook event. This allows users to gain insights into how an event is performing in terms of engagement, reach, impressions, and video views. It is particularly useful for marketers, event organizers, or social media managers who want to monitor the effectiveness and audience interaction of their Facebook events.
Practical examples include:
- Tracking the number of people reached by an event over a certain period.
- Measuring engagement levels such as clicks or interactions on event posts.
- Analyzing video view counts associated with event content.
Properties
| Name | Meaning |
|---|---|
| Metrics | The specific metrics to retrieve for the event insights. Options include: |
| - Page Impressions | |
| - Page Reach | |
| - Page Engaged Users | |
| - Post Impressions | |
| - Post Reach | |
| - Post Engagements | |
| - Video Views | |
| - Video Views Organic | |
| Period | The time period for which insights are retrieved. Options: Day, Week, Days 28 |
| Since | Start date (ISO 8601 format) for filtering insights data |
| Until | End date (ISO 8601 format) for filtering insights data |
| Event ID | The unique identifier of the Facebook event for which insights are requested (required) |
Output
The output JSON contains the requested event insights data structured according to the Facebook Graph API's response format for event insights. This typically includes metric names, values, and timestamps corresponding to the selected metrics and time periods.
If multiple items are processed, the output is an array where each element corresponds to one input item’s result.
No binary data output is indicated for this operation.
Dependencies
- Requires a valid API key credential for the external N8N Tools API service used for validation.
- Requires Facebook API credentials (OAuth2 or API key) configured in n8n to authenticate requests to Facebook Graph API.
- The node internally uses a helper class to interact with Facebook’s Graph API endpoints.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential for the external N8N Tools API is correctly set up and active.
- Facebook API errors: Errors from Facebook (e.g., permission denied, invalid event ID) should be checked against Facebook’s API documentation and permissions granted to the app.
- Date format issues: Ensure that the 'Since' and 'Until' dates are provided in proper ISO 8601 format to avoid request failures.
- Missing required parameters: The 'Event ID' must be provided; otherwise, the request will fail.