Ads and Commerce
Ads and Commerce
Resources
Version 20.0
Updated: Jan 31, 2025
Marketing API
May 21, 2024 | Available until May 6, 2025 |
Instagram Graph API
Instagram User Insights
Applies to v20.0+. Will apply to all versions on August 19, 2024.
The
last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.The following endpoints and metrics are affected:
GET /{ig-user-id}/insightsengaged_audience_demographicsreached_audience_demographics
Auction Ads
Campaign Optimization of Impressions
Applies to v20.0+. Will apply to all versions August 19, 2024.
The
optimization_goal parameter will no longer accept the impressions value in combination with:- The legacy
POST_ENGAGEMENTobjective - The
ON_POSTdestination_type
Note: Optimizing for reach is still available.
The following endpoints are affected:
Frequency Controls
Applies to v20.0+. Will apply to all versions August 19, 2024.
The
frequency_control_specs parameter should no longer be sent in an API call if the optimization_goal is set to Ad Recall Lift, Link Click Optimization, Post Engagement, or 2-second Video Views. Any campaigns of this type that are still running will be disabled beginning August 19, 2024.Writes to this field are only available in ad sets where
REACH and THRUPLAY are the performance goal.The following endpoints are affected:
Offline Conversions API
Deprecation of Remaining Endpoints
Applies to v20.0+.
The Offline Conversions API will be discontinued in May 2025. It was previously due to be deprecated in the third quarter of 2024. As we announced in the v17.0 changelog, the Offline Conversions API no longer supports offline events. Graph API v16.0 is the last version that supports offline events. The Offline Conversions API will be discontinued when v16.0 expires in May 2025.
Between now and May 2025, we will be deprecating the remaining Offline Conversions API endpoints on Marketing API v20.0.
The following endpoints are affected:
POST/GET/DELETE /{offline_event_set_id}POST/GET /{offline_event_set_id}/uploadsPOST /{offline_event_set_id}/validatePOST /{offline_event_set_id}/ad_accountGET /{offline_event_set_id}/statsGET /{offline_event_set_id}/shared_agenciesPOST/GET /{offline_event_set_id}/agenciesGET /{offline_event_set_id}/adaccountsGET /{offline_event_set_id}/customconversionsGET /{offline_event_set_id}/audiencesGET /{offline_event_set_id}/shared_accountsGET /{ad_account_id}/offline_conversion_data_setsPOST/GET /{business_id}/offline_conversion_data_setsPOST/GET/DELETE /{business_asset_group_id}/contained_offline_conversion_data_sets
In February 2023, we announced that the Conversions API now fully supports offline events. We recommend that advertisers use the Conversions API for new integrations. We recommend that advertisers with Offline Conversions API integrations convert their integration into a Conversions API integration before May 2025 and not update their Offline Conversions API until they have successfully done so. Learn more about the Conversions API.
Messaging Ads
Sponsored Messages
Applies to v20.0+. Will apply to all versions August 19, 2024.
Creation of the sponsored messages ad type will no longer be available. This change will not affect other messaging ads ad types.
The following endpoints are affected:
Did you find this page helpful?
