Actions3
- Facebook Ads Actions
Overview
This node is designed to interact with Facebook Ads data, specifically for retrieving ads information from a Facebook Ad Account. It supports operations such as fetching detailed data about individual ads and listing multiple ads within a specified date range.
Common scenarios where this node is beneficial include:
- Marketing teams wanting to automate the extraction of ad performance data for reporting or analysis.
- Agencies managing multiple Facebook Ad Accounts who need to pull ads data programmatically.
- Data analysts integrating Facebook Ads metrics into dashboards or BI tools.
Practical example: A user can specify a Facebook Ad Account and a date range to retrieve up to 100 ads created or active during that period, including details like impressions, clicks, spend, and creative content.
Properties
| Name | Meaning |
|---|---|
| Đây là phiên bản Thử nghiệm Chúng tôi sẽ liên tục cập nhật và sửa lỗi. Mời bạn truy cập https://zalo.me/g/ebsiof941 để cập nhật thông tin mới nhất |
Notice informing users that this is an experimental version subject to updates and fixes. |
| Facebook Ad Account | Select the Facebook Ad Account to query. Can be chosen from a list of accounts or entered by ID. |
| Từ ngày | Start date for fetching ads data (format YYYY-MM-DD). Required. |
| Đến ngày | End date for fetching ads data (format YYYY-MM-DD). Required. |
| Giới hạn số lượng | Maximum number of ads to retrieve (range 1-100). Default is 25. |
Output
The node outputs JSON data structured as follows:
success: Boolean indicating if the request was successful.adAccountId: The ID of the Facebook Ad Account queried (prefixed with "act_").dateRange: Object containingsinceanduntildates used in the query.ads: An array of ad objects retrieved from Facebook, each containing fields such as:id: Ad identifier.name: Ad name.status: Current status of the ad.campaign_id: Associated campaign ID.creative: Details about the ad creative including title, body, image URL, and link URL.- Performance metrics like spend, impressions, reach, frequency, clicks, CTR, CPM, CPP, unique clicks, cost per action, conversions, etc.
totalAds: Number of ads returned.response: Raw response object from the Facebook API.
If binary data were involved (e.g., images), it would be summarized here, but this node focuses on JSON data only.
Dependencies
- Requires a valid API authentication token credential for Facebook Ads API access.
- Uses Facebook Graph API v19.0 endpoints.
- Node configuration must include credentials capable of obtaining access tokens for the Facebook Ad Account.
- Network connectivity to Facebook's API endpoints is necessary.
Troubleshooting
Common issues:
- Invalid or expired API tokens leading to authorization errors.
- Incorrect Facebook Ad Account ID format (should be prefixed with "act_" or selected from the list).
- Date range errors such as invalid formats or start date after end date.
- Exceeding the maximum allowed limit for ads retrieval (1-100).
Error messages:
- Errors related to token acquisition will indicate failure to get access token; ensure credentials are correctly configured.
- API response errors include HTTP status codes and messages; check the description field for details.
- If the node is set to continue on failure, errors are attached to output items; otherwise, execution stops with an error.
Resolutions:
- Verify and refresh API credentials.
- Double-check input parameters for correctness.
- Ensure the Facebook Ad Account exists and the authenticated user has access.
- Adjust limits and date ranges to valid values.