Meta Ads
Follow our setup guide to connect Meta to QUANTI:
Prerequisites
To connect Facebook Ads to QUANTI:, you need:
An active Meta Ads Manager account with the following permissions for the accounts you'd like to sync:
An
ads_readpermission to sync Ads report information for any Ad accounts that you own or have been granted access to through this permission.An
ads_managementpermission to sync Ads accounts' metadata. This permission also requests theidandaccount_timezonefields of Ad accounts. Theaccount_timezonefield is required to save the correct report date in the destination.A
business_managementpermission is mandatory to ensure a successful setup. Without this permission, setup tests will fail
The breakdowns and fields you'd like to sync.
Setup instructions
Connect your Facebook account to permit Quanti: to access to your data
Connector information
Connector Name : Name your connector. It must be unique.
Dataset ID : Define the ID of the dataset. It must not exist yet, as it will be created and data will be sent there.
Select accounts to sync.
Create queries: You can either select pre-built queries or create your own custom queries.
Pre-built Queries
Stats & Conversions
ad_stats: Advertising performance at ad level.
ad_conv: Conversion performance at ad level.
adset_stats: Advertising performance at ad set level.
adset_conv: Conversion performance at ad set level.
campaign_stats: Advertising performance at campaign level.
campaign_conv: Conversion performance at campaign level.
Dimension Tables (History)
account_history: Account-level metadata history.
creative_history: Creative-level metadata history.
ad_image_history: Ad image metadata history (URLs, dimensions, status).
campaign_history: Campaign-level metadata history.
ad_set_history: Ad set-level metadata history.
ad_history: Ad-level metadata history.
ad_video_history: Metadata of ad videos (thumbnail, duration, status) per ad account.
Breakdowns
ad_stats_age_gender: Ad performance broken down by age and gender.
ad_conv_age_gender: Conversion data broken down by age and gender.
ad_stats_country_region: Ad performance broken down by country and region.
ad_conv_country_region: Conversion data broken down by country and region.
ad_stats_device_platform_placement: Ad performance broken down by device, platform, and placement.
ad_conv_device_platform_placement: Conversion data broken down by device, platform, and placement.
Custom query
Custom reports let you build your own queries against the Meta Ads Insights API, with full control over the fields, breakdowns, and attribution windows collected. Each custom report produces a dedicated table in your dataset.
To validate field and breakdown combinations before configuring them in QUANTI, use the Facebook Graph API Explorer: it shows which fields are compatible with which breakdowns and surfaces errors before any data is collected.
Building a custom report
In the connector setup, click Add custom report and configure:
Fields: metrics and dimensions from the Meta Insights API (e.g.
impressions,spend,clicks,actions,conversions,reach,frequency,cpm,cpc,ctr…). The full list is available in Meta's documentation.Breakdowns: optional additional dimensions to split results by (e.g.
age,gender,country,region,device_platform,publisher_platform,impression_device,placement…). Breakdowns must be compatible with the fields selected — the Graph API Explorer will flag incompatible combinations.Level: granularity of the report —
ad,adset,campaign, oraccount.Action attribution windows: defines the conversion window used to attribute actions to ads. See the compatibility table below.
Action attribution windows
The action_attribution_windows parameter controls which click and view windows are used to count conversions. Not all windows are available on all conversion types:
1d_click
✅
✅
✅
7d_click
✅
✅
✅
1d_view
✅
✅
✅
28d_click
✅
✅
❌
28d_view
✅
✅
❌
7d_view
✅
✅
❌
Deprecated parameters
Since June 10, 2025, Meta has deprecated the following two parameters. They are silently ignored by the API regardless of the value passed — Meta now applies its own defaults automatically:
action_report_time: Meta now automatically usesmixed(impression-based for on-Meta actions, conversion-based for off-Meta actions). This parameter no longer has any effect.use_unified_attribution_setting: Meta now automatically aligns with the ad set's attribution settings. This parameter no longer has any effect.
These parameters have been removed from QUANTI's prebuilt reports and custom report configuration. If you have existing custom reports that included them, the reports will continue to function — the parameters are simply ignored by the API.
Last updated