Today, we are releasing Facebook Graph API v17.0 and Marketing API v17.0. As part of this release, we are highlighting changes below that we believe are relevant to parts of our developer community. These changes include announcements, product updates, and notifications on deprecations that we believe are relevant to your application(s)’ integration with our platform.
For a complete list of all changes and their details, please visit our changelog.
The Ad Strategies beta product has been deprecated since October 28, 2022. Because of this, we are deprecating the fields ad_strategy_id and ad_strategy_group_id on the campaigns endpoint with the release of Marketing API v17.0.
Since February 2023, the Conversions API fully supports offline events, ensuring parity features provided by the current Offline Conversions API endpoint. By consolidating our web and offline event APIs into a single API, we hope to simplify and improve how advertisers use their cross-channel marketing data to enhance ad optimization, custom audiences, and measurement.
Starting with Graph API version 17 onwards, released on May 23, 2023, Offline Conversions API will no longer support offline events. We recommend that advertisers with Offline Conversions API integrations convert their integration into a Conversions API integration and not update their Offline Conversions API until they have successfully done so.
As announced in December 2021, we redesigned the objective selection experience when creating new campaigns to effectively guide advertisers to campaign setups that help to better achieve their marketing goals. The new experience, Outcome-Driven Ad Experiences, resulted in changes to the Marketing API.
We will begin the process of deprecating the legacy experience and objectives, starting with the release of Marketing API v17.0. When using Marketing API v17.0, campaigns can only be created with Outcome-Driven Ad Experience objectives, and the legacy objectives' APIs will be deprecated. Existing legacy campaigns and duplication of existing legacy campaigns will still be supported and not be impacted in this version. More details can be found in our recent developer blog post.
Earlier this year, we released Advantage+ creative standard enhancements on Marketing API. Beginning on May 23, 2023, Marketing API users will be required to specify an ad's enrollment to Advantage+ creative's standard enhancements by providing 'OPT_IN' or 'OPT_OUT' in the 'enroll_status' field. If the field is left blank, the user will receive an error and be directed to complete the field. To learn more about Advantage+ creative standard enhancements on Marketing API, please view this developer blog post.
The following endpoints are affected
With Marketing API v17 release, we are deprecating Advantage+ Catalog Ads for Streaming (A+CA for Streaming) catalog usage. Commerce Catalog ads is the recommended alternative to A+CA for Streaming. Here is a guide for setting up a Commerce Catalog. The below endpoints will be deprecated:
On August 21, 2023, the above changes will apply to all Marketing API versions, and we will be pausing all campaigns that have A+CA for Streaming catalogs attached at the L3, L2, or L1 level.
As the Instant Articles product was deprecated on April 20th 2023, an API that allows publishers to manage their instant articles will be deprecated now.
Earlier, additional business admined pages were returned without the business_management permission access. Beginning on May 23, 2023, if you would like to continue receiving access to the business admined pages, the business_management permission will be required. You can refer to the business_management page for more details related to this permission.
To avoid disruption to your business, we recommend migrating all calls to the latest API version that launched today.
As part of our 2-year deprecation schedule for Platform SDKs, please note the upcoming deprecations and sunsets: