Version 19.0
Updated: May 29, 2025
Marketing API
January 23, 2024 | Available until February 4, 2025 |
Insights
Ads Insights
Applies to v19.0+.
- The
age_targeting,gender_targeting,labels, andlocationinsights metrics will no longer be available. - The
estimated_ad_recall_rate_lower_bound,estimated_ad_recall_rate_upper_bound,estimated_ad_recallers_lower_bound, andestimated_ad_recallers_upper_boundinsights metrics will no longer be available.
The following endpoints are affected:
GET /{ad-set-id}/insightsGET /{ad-account-id}/insightsGET /{ad-id}/insightsGET /{campaign-id}/insightsPOST /{ad-set-id}/insightsPOST /{ad-account-id}/insightsPOST /{ad-id}/insightsPOST /{campaign-id}/insights
Objectives
Ad Copies
Applies to v19.0+.
When creating a copy of an ad you must only use Outcome-Driven Ad Experience objectives. Attempting to use legacy objectives will result in an error.
The following endpoints are affected:
Targeting
Target Expansion
Applies to v19.0+. Will apply to all versions on April 22, 2024.
- The
targeting_optimizationfield will not be accepted for campaigns that are optimized for link clicks or landing page views. This also applies to previous optimizations that were included in Advantage Detailed Targeting with no option to opt-out including conversions, value, app installs, app events and conversations. - For all optimizations that are opted into Advantage Detailed Targeting with no option to opt-out we will automatically set the
targeting_as_signalfield to either 1 or 3 based on the set of objectives and optimizations. - The
targeting_as_signalfield should be either null or 0 for campaigns that are optimized for impressions, video views, reach, engagement, ad recall lift or lead, otherwise an error will be received.
The following endpoints are affected:
POST /act_{ad-account-id}/adsetsPOST /{adset-id}GET /{adset-id}/delivery_estimateGET /act_{ad-account-id}/delivery_estimate
V19.0 Changes
| File Name |
|---|