Get Report

The Get Report node lets you fetch Meta Ads performance data across one or more accounts using specified metrics, dimensions, and filters. This is an AI-powered node that can understand natural language instructions.

When to Use It

Use this node to:

Generate automated performance reports and dashboards
Track campaign metrics and KPIs over time
Create data-driven insights for optimization decisions
Export data for further analysis in external tools
Monitor Facebook and Instagram advertising performance

Inputs

Field	Type	Required	Description
Accounts	Dynamic multi-select	Yes	Select one or more Meta Ads accounts to query
Date Range	Date range picker	Yes	Select date range for the report
Metrics	Multi-select	Yes	Select metrics to include in the report
Dimensions	Multi-select	No	Select dimensions to segment your data
Filters	Rule-based filters	No	Add filters to refine your data
Order By	Sort configuration	No	Set the order of results
Limit	Number	No	Maximum number of rows to return
Options	Report options	No	Additional options for the report

Filters

Filters allow you to refine your data by applying conditions to specific dimensions or metrics. Multiple filters use AND logic - all conditions must be met for a row to be included in the results.

Available Filter Operators

Operator	Description	Example Use Case
EQUALS	Exact match	Campaign name equals “Black Friday Sale”
NOT_EQUALS	Does not match exactly	Campaign status not equals “PAUSED”
CONTAINS	Contains substring	Campaign name contains “2024”
NOT_CONTAINS	Does not contain substring	Campaign name doesn’t contain “test”
IN_LIST	Matches any value in list	Placement in [“Facebook_Feed”, “Instagram_Feed”]
NOT_IN_LIST	Doesn’t match any value in list	Device not in [“Desktop”]
REGEXP_MATCH	Matches regular expression	Campaign name matches ”.(sale\|promo).”
NOT_REGEXP_MATCH	Doesn’t match regex	Campaign name doesn’t match “test.*“
GREATER_THAN	Numeric greater than	Spend > 100
LESS_THAN	Numeric less than	CPC < 2.00
IS_NULL	Field has no value	Purchase value is null
IS_NOT_NULL	Field has a value	Purchase value is not null

Filter Examples

Example 1: High-spending active campaigns

- Spend > 50 (GREATER_THAN)
- Campaign status = "ACTIVE" (EQUALS)
- Impressions > 1000 (GREATER_THAN)

Example 2: Promotional campaigns using regex (OR logic)

- Campaign name matches ".*(sale|promo|discount).*" (REGEXP_MATCH)

Example 3: Exclude test campaigns

- Campaign name does not contain "test" (NOT_CONTAINS)
- Campaign name does not contain "draft" (NOT_CONTAINS)

OR Logic with Filters

Since multiple filters use AND logic, use these approaches for OR conditions:

IN_LIST operator: Placement IN ["Facebook_Feed", "Instagram_Feed", "Instagram_Stories"]
REGEXP_MATCH operator: Campaign name REGEXP_MATCH ".*(sale|promo|discount).*"
Run separate queries: Create different workflows for different conditions

Options Reference

These optional settings let you format the output from Meta Ads before passing it to other nodes.

Option	Description
Pretty Column Names	Converts column headers to Title Case (e.g. `campaignName` becomes `Campaign Name`)
Add Percent Sign to Ratios	Appends `%` to ratio metrics like CTR or Engagement Rate
Display Currency Symbol	Adds `$` or local currency symbol to monetary metrics
Compact Numbers	Converts large numbers to short format (e.g. `10K` instead of `10,000`)
Pivot Dimensions as Columns	Transforms dimension values into separate columns for easier comparison

Output

The node returns a structured dataset with performance metrics and dimensions. The exact format depends on your configuration and the data returned from Meta Ads. Typical Output Structure:

Data Rows: Performance metrics and dimensions
Metadata: Account information, date ranges, and query details
Summary Statistics: Total records, data freshness, execution time

Can be passed to:

AI nodes like Analyze Data or Structured Output
Export nodes (e.g., Google Sheets)
Email or Slides nodes

Credit Cost

Cost per run: 1 credit per account

Example Setup

Scheduler (Daily 8 AM) →
Get Report →
AI Analysis →
Google Slides Report →
Slack Notification

Configuration Example:

Date Range: Last 7 days
Metrics: Impressions, Clicks, Spend, Purchases
Dimensions: Campaign Name, Date
Filters: Spend > 0 (only active campaigns)
Limit: 1000 rows

FAQs

What happens if I select multiple Meta Ads accounts?

The data will be aggregated across all selected accounts into a single dataset.
If you’d like to break it out by account, add the account_name or account_id dimension to segment results per account.

How do I combine filters with OR logic?

Multiple filters always use AND logic (all conditions must be true). For OR logic, use:Option 1: IN_LIST operator

Placement IN ["Facebook_Feed", "Instagram_Feed", "Instagram_Stories"]

Option 2: REGEXP_MATCH operator

Campaign name REGEXP_MATCH ".*(sale|promo|discount).*"

Option 3: Run separate workflows Create different Get Report nodes for different conditions, then combine the data downstream.

What's the difference between CONTAINS and REGEXP_MATCH?

CONTAINS: Simple substring search. Campaign name CONTAINS "sale" finds any campaign with “sale” anywhere in the name
REGEXP_MATCH: Advanced pattern matching. Campaign name REGEXP_MATCH "^sale.*" finds campaigns that START with “sale”

Use CONTAINS for simple text searches, REGEXP_MATCH for complex patterns or OR conditions.

Why are my filters not working?

Common filter issues:

Case sensitivity: “Sale” ≠ “sale”. Use CONTAINS or regex for flexible matching
Data type mismatch: Don’t use text operators on numeric fields
Field availability: Not all dimensions/metrics support all filter operators
Syntax errors: Check regex patterns for proper escaping

Why don't my conversions match Facebook Ads Manager?

Conversion data discrepancies often occur due to:

Attribution windows: Different attribution models may show different results
SKAdNetwork conversions: iOS 14+ conversions require “Use Attribution Setting” configuration
Conversion tracking setup: Ensure proper Facebook Pixel or Conversions API setup
Attribution settings: Fixed attribution windows vs. ad set attribution settings can cause differences

Why is my data different from the Meta Ads Manager?

Data discrepancies can occur due to:

Reporting delays: Meta Ads data can take up to 24-48 hours to finalize for recent dates
Attribution windows: Different attribution models may show different results
Time zones: Ensure your date range matches the account’s time zone
Breakdowns: When using breakdowns, some metrics are estimated and may not perfectly match
Filters: Check if you have different filters applied in the UI vs API

Why are some conversions missing when I use breakdowns?

Offsite conversions (Purchases, Add to Cart, etc.) are only available with these breakdowns:

Age, Gender, Age & Gender
Country, Impression device
Platform, Platform & device
Placement, Audience

If you need conversion data, ensure you’re using compatible breakdowns or connect without breakdowns.

Why can't I see conversions for campaign-level data?

Facebook’s API won’t return conversion values when there’s aggregation across multiple attribution settings. This shows as “multiple” in the Attribution setting field. Try connecting the data source at the Ad Set level instead of Campaign level.

How to filter out inactive campaigns?

Facebook by default returns only campaigns that have had activity during the selected date range, so you don’t need to filter out inactive campaigns.

Why is my report returning no data?

Common causes of empty results:

Date range: The selected period may have no activity
Filters: Your filters may be too restrictive
Account status: Campaigns may be paused or inactive
Metrics compatibility: Some metric/dimension combinations aren’t supported
Attribution requirements: Some metrics require specific attribution settings

Why are some metrics showing as zero?

Zero values can indicate:

No activity: The campaigns genuinely had no performance for those metrics
Conversion tracking: Conversion metrics require proper Facebook Pixel setup
Dimension compatibility: Some dimensions don’t work with certain metrics
Attribution: Different attribution models may show different values
Estimated metrics: When using breakdowns, some metrics are estimated by Facebook

Why are my custom conversions different from Events Manager?

Custom conversions in the API (and therefore in Markifact) match the Ads Manager, not the Events Manager. These are different data sources:

Ads Manager: Shows conversion data from the Ads Insights API
Events Manager: Shows raw conversion events

Get Started

Guides

Nodes

When to Use It

Inputs

Filters

Available Filter Operators

Filter Examples

OR Logic with Filters

Options Reference

Output

Credit Cost

Example Setup

FAQs

Get Started

Guides

Nodes

​When to Use It

​Inputs

​Filters

​Available Filter Operators

​Filter Examples

​OR Logic with Filters

​Options Reference

​Output

​Credit Cost

​Example Setup

​FAQs

When to Use It

Inputs

Filters

Available Filter Operators

Filter Examples

OR Logic with Filters

Options Reference

Output

Credit Cost

Example Setup

FAQs