GET /{ad-account-id}/insights
GET /{ad-id}/insights
GET /{ad-set-id}/insights
GET /{campaign-id}/insights
POST /{ad-account-id}/insights
POST /{ad-id}/insights
POST /{ad-set-id}/insights
POST /{campaign-id}/insights
|
If you do not provide action_attribution_windows when pulling results we will use 7d_click and 1d_view by default instead of 28d_click and 1d_view.
The use_account_attribution_setting field will be ignored, as we will be replacing the account-level setting with a new attribution setting that can be set at the ad set level during ads creation. Below you will find details for two new fields related to attribution settings that can be used: use_unified_attribution_setting and attribution_setting.
Please note, when Apple enforces the AppTrackingTransparency prompt, we will update the default to 7d_click only due to limitations in view-through signal.
New use_unified_attribution_setting field:
This field can be used in GET and POST requests to /adcampaigngroup/insights, /adcampaign/insights, /adgroup/insights, and /adaccount/insights.
If you set use_unified_attribution_setting to true, your query’s conversion metric attribution and campaign optimization will use the attribution_setting of the ad object(s) being queried — a single period of time during which conversions are credited to ads and used to inform campaign optimization.
If use_unified_attribution_setting is set to true, we:
- Cannot aggregate conversion metric values across different attribution settings.
New attribution_setting field:
This field can be used in GET and POST requests to /adcampaigngroup/insights, /adcampaign/insights, /adgroup/insights, and /adaccount/insights. This field is used to indicate which attribution setting is used by a conversion metric. The attribution setting is set at the ad set level during ads creation, and ensures the conversions our system optimizes for are the same ones you want to measure.
For queries of ad objects that are using mixed or SKAdNetwork-dependent settings, attribution_setting will return the following:
- mixed: indicates when a campaign or account has ad sets using multiple attribution settings
- skan: indicates when SKAdNetwork attribution setting is used for iOS 14 app install campaigns
- na: indicates when a campaign or account doesn’t have an ad set within
atribution_setting will return values only when use_unified_attribution_setting is true, else response will not return attribution_setting.
|
Facebook Developers