PhoAi Ultimate Facebook Ads icon

PhoAi Ultimate Facebook Ads

Node for Facebook Ads Data

Actions3

Overview

This node interacts with Facebook Ads to retrieve detailed information about a specific advertisement. It is particularly useful for marketers, advertisers, and analysts who want to fetch comprehensive data on individual ads within a given date range. For example, you can use this node to get the performance metrics, creative details, and status of a particular ad by specifying its ID and the time period of interest.

Practical scenarios include:

  • Monitoring the effectiveness of a single ad campaign.
  • Extracting ad creative content and metadata for reporting.
  • Integrating Facebook Ads data into broader marketing dashboards or automation workflows.

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		 A notice indicating that this is an experimental version of the node, subject to updates and fixes. Users are invited to visit the provided link for the latest information.
Ad ID The unique identifier of the Facebook ad whose details you want to retrieve. This is required.
Từ ngày (Since Date) The start date (YYYY-MM-DD) for the data retrieval period. Required to specify the beginning of the date range.
Đến ngày (Until Date) The end date (YYYY-MM-DD) for the data retrieval period. Required to specify the end of the date range.

Output

The node outputs JSON data containing:

  • success: Boolean indicating if the operation was successful.
  • adId: The ID of the requested ad.
  • dateRange: An object with since and until fields representing the requested date range.
  • adDetail: Detailed information about the ad fetched from Facebook's Graph API, including fields such as:
    • id
    • name
    • effective_status
    • campaign_id
    • creative (with nested fields like id, name, title, body, image_url, link_url)
    • insights (performance metrics like spend, impressions, reach, clicks, CTR, CPM, etc.)
  • response: The raw response from the Facebook API for debugging or further processing.

No binary data output is indicated in the code.

Dependencies

  • Requires a valid API authentication token credential for Facebook Ads.
  • Makes HTTP requests to Facebook's Graph API v19.0.
  • Uses an internal service endpoint (/get_access_token_user_account) to obtain access tokens.
  • Requires n8n HTTP Request helper methods to perform API calls.
  • Node expects proper configuration of credentials providing access tokens for Facebook Ads API.

Troubleshooting

  • Common Issues:

    • Invalid or expired access token leading to authorization errors.
    • Incorrect Ad ID causing "not found" or empty responses.
    • Date range format errors or invalid dates.
    • Network or connectivity issues when calling Facebook API.

  • Error Messages:

    • Errors thrown include descriptive messages with HTTP status codes and Facebook API error responses.
    • Example: "Status: <code>. Response: <error message>" indicates an API call failure.
    • Resolution usually involves verifying credentials, ensuring the Ad ID exists, and checking date formats.

  • Handling Errors:

    • The node supports continuing on failure if configured, allowing partial processing of multiple items.
    • Otherwise, it throws detailed errors with item index for easier debugging.

Links and References

Discussion