Meta Insights icon

Meta Insights

Get insights from Facebook Ads, Facebook Pages, and Instagram

Actions6

Facebook Paid

AI-generated

Summary

Fetches campaign-level Facebook Ads insights for the selected date range, keeps rows whose placement is Facebook, and aggregates them into one summary item. Optionally filters campaigns by a case-insensitive name substring and by the ISO calendar week derived from the range’s start date.

Inputs

  • Ad Account ID (required) — Facebook ad account ID, including the act_ prefix.
  • Date Mode — Choose a preset date range or provide a custom range. Defaults to preset mode.
  • Date Preset — Used in preset mode. Offers presets from today and yesterday through the last year, plus maximum; defaults to Last Week (Mon–Sun).
  • Since — Start date in YYYY-MM-DD format for a custom range.
  • Until — End date in YYYY-MM-DD format for a custom range.
  • Campaign Name Filter — Include only campaigns whose names contain this text, case-insensitively. Empty includes all matching Facebook placement rows.
  • Auto KW Filter — When enabled and a start date is available, also require the campaign name to contain kw N, where N is the ISO week number of the range’s start date. Defaults to false.
  • Graph API Version — Graph API version used for the request; defaults to v25.0.

Output shape

A single summary item per input item.

The item contains platform, spend, impressions, reach, clicks, video views, leads, CTR, CPC, CPM, cost per reach (cpf), frequency, date start and stop, plus campaign and row-count debug fields. Numeric totals are returned as strings. The node paginates through fetched insight rows before filtering and aggregation. Errors are thrown unless the node is configured to continue on fail.

Examples

Example 1: Fetch Facebook placement performance for the previous Monday through Sunday, including only campaigns with “launch” in the name.

Use the required ad account ID, keep the default date preset, and set Campaign Name Filter to launch.

Links

Discussion