Meta Ads Request Parameters
When building a data request through the Meta Ads connector, the following parameters are used to define the level of detail, the time period, and the attribution logic.
Detail Level (level)
Defines the hierarchy level at which data is grouped:
| Value | Description |
|---|---|
account | Ad account level — aggregated data across all campaigns |
campaign | Campaign level — data grouped by campaigns |
adset | Ad set level — data for each ad set |
ad | Ad level — the most granular data for each ad |
Default: ad (maximum detail)
Time Period (date_preset)
Preset date ranges via the Graph API:
| Value | Description |
|---|---|
today | Today only |
yesterday | Yesterday |
last_7d | Last 7 days (not including today) |
last_30d | Last 30 days (not including today) |
this_month | Current month |
last_month | Last month |
lifetime | All time |
Default: last_30d
Implementation: via the resolveGraphDateRange function
Custom Period (time_range)
For an arbitrary date range, the time_range object is used:
{
"time_range": {
"since": "2026-07-01",
"until": "2026-07-25"
}
}Date format: YYYY-MM-DD. The until day is not included in the result.
Fields to Request (fields)
The list of fields included in the response. LightLead automatically builds the optimal set of fields based on the report configuration. Main categories:
- Structural fields:
campaign_name,adset_name,ad_name,account_name - Metrics:
spend,impressions,clicks,ctr,cpc,cpm,reach,frequency - Conversion metrics:
purchases,purchase_value,purchase_roas - Actions:
actions,action_values,cost_per_action_type
Record Limit (limit)
The number of records per API response page:
| Parameter | Value |
|---|---|
| Maximum per page | Defined by META_MAX_PAGES |
| Default | Configured in runtimeConfig.providers.meta.maxPages |
When the page limit is exceeded, a meta_paging_truncated event is logged.
Async Report Parameters
For large data volumes, async reports are used — see Async Reports.