LinkedIn Ads
Get Report
Fetch LinkedIn Ads data based on specified metrics and dimensions
The Get Report node lets you fetch LinkedIn 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.
Example 2: Lead generation campaigns using regex (OR logic)
Example 3: Exclude test campaigns
Configuration Example:
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 LinkedIn advertising performance for B2B campaigns
Inputs
| Field | Type | Required | Description |
|---|---|---|---|
| Accounts | Dynamic multi-select | Yes | Select one or more LinkedIn 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 “Q4 2024 Lead Gen” |
| 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 | Campaign type in [“SPONSORED_CONTENT”, “TEXT_AD”] |
| NOT_IN_LIST | Doesn’t match any value in list | Objective not in [“BRAND_AWARENESS”] |
| REGEXP_MATCH | Matches regular expression | Campaign name matches ”.(lead|conversion).” |
| NOT_REGEXP_MATCH | Doesn’t match regex | Campaign name doesn’t match “test.*“ |
| GREATER_THAN | Numeric greater than | Impressions > 1000 |
| LESS_THAN | Numeric less than | Cost < 500 |
| IS_NULL | Field has no value | Conversion value is null |
| IS_NOT_NULL | Field has a value | Conversion value is not null |
Filter Examples
Example 1: Active B2B campaigns with performanceOR Logic with Filters
Since multiple filters use AND logic, use these approaches for OR conditions:- IN_LIST operator:
Campaign type IN ["SPONSORED_CONTENT", "TEXT_AD", "DYNAMIC"] - REGEXP_MATCH operator:
Campaign name REGEXP_MATCH ".*(lead|B2B|enterprise).*" - Run separate queries: Create different workflows for different conditions
Options Reference
These optional settings let you format the output from LinkedIn 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 LinkedIn 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
- 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
- Date Range: Last 30 days
- Metrics: Impressions, Clicks, Spend, Conversions
- Dimensions: Campaign Name, Date
- Filters: Spend > 0 (only active campaigns)
- Report Type: Standard Campaign Report
- Limit: 1000 rows
FAQs
What happens if I select multiple LinkedIn Ads accounts?
What happens if I select multiple LinkedIn 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
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?
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 operatorOption 2: REGEXP_MATCH operatorOption 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?
What's the difference between CONTAINS and REGEXP_MATCH?
- CONTAINS: Simple substring search.
Campaign name CONTAINS "B2B"finds any campaign with “B2B” anywhere in the name - REGEXP_MATCH: Advanced pattern matching.
Campaign name REGEXP_MATCH "^B2B.*"finds campaigns that START with “B2B”
Why are my filters not working?
Why are my filters not working?
Common filter issues:
- Case sensitivity: “Lead” ≠ “lead”. 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 are my demographic metrics missing or inconsistent?
Why are my demographic metrics missing or inconsistent?
LinkedIn has several restrictions on demographic data:
- Top 100 limit: API only supports top 100 demographic values per creative per day
- Rounding: Metrics are approximate and rounded down to 0 for small values (less than 3)
- Daily aggregation: Small daily values may not sum correctly over time periods
Why is data missing for some campaigns?
Why is data missing for some campaigns?
Campaign data may be missing if:
- Draft status: Campaigns in draft status cannot be retrieved
- Paused status: Paused campaigns may not return data
- Creative issues: Creatives with malformed URLs or rejection status
- API errors: Temporary LinkedIn API issues preventing data retrieval
Why doesn't the creative name match LinkedIn UI?
Why doesn't the creative name match LinkedIn UI?
The creative name in reports comes from the content object created in LinkedIn, which may differ from what’s displayed in the UI. This is how LinkedIn’s API provides the data and is expected behavior.
How to filter out inactive campaigns?
How to filter out inactive campaigns?
To exclude inactive campaigns, use filters like:
spend > 0impressions > 0clicks > 0This ensures you only get data for campaigns with actual performance.
Why is my report returning no data?
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 in draft status
- Permissions: You may lack proper access to the selected accounts
- Metrics compatibility: Some metric/dimension combinations aren’t supported
Why do I get 'REVOKED_ACCESS_TOKEN' error?
Why do I get 'REVOKED_ACCESS_TOKEN' error?
This error indicates your LinkedIn credentials have expired (LinkedIn requires annual renewal). To fix:
- Reconnect your data source in the connection settings
- Re-authenticate with your LinkedIn account
- Update credentials to restore API access
Why are demographic values approximated?
Why are demographic values approximated?
LinkedIn provides approximate demographic metrics to protect user privacy:
- Rounding: Values are rounded down, small numbers become 0
- Aggregation: Daily small values may not sum to period totals correctly
- Sampling: Large datasets may be sampled for performance