Version 21.0

Marketing API

October 2, 2024 | Available until TBD | Blog post

Objectives

Outcome-Driven Ad Experiences

Applies to v21.0+.

Beginning with v21.0, you will no longer be able to create new ad sets or ads with non-Outcome-Driven Ad Experience (ODAX) objectives. Existing ad campaigns using older objectives can continue to run for now, but we encourage you to transition all your campaigns to the ODAX objectives. See the Simplifying campaign objectives with Outcome-Driven Ad Experiences blog entry and the Outcome-Driven Ad Experiences documentation for more information.

The following endpoints are affected:

Standard Enhancements

Image Expansion

Applies to v21.0+.

For single media ads, the Image Expansion feature will be included as part of Standard Enhancements. Therefore, if creating an ad or an ad creative opted-in to Image Expansion, please refer to this link for instructions to set standard_enhancements as a field inside the creative_features_spec.

The following endpoints are affected:

Version 22 Upcoming Change

Product Catalog — Enforcing Country Override Specific Fields

Applies to v22.0

This change applies to advertisers using country and language feeds to localize their product data. It standardizes which fields should be provided in a country feed versus a language feed (or a country and language feed via API) to help advertisers set up their product data in the most efficient way.

Price, sale price, unit price, base price, status (visibility), and availability must now only be provided in a country feed. This helps ensure customers see the correct localized product data.

If your language feed currently contains the price, sale_price, base_price, status or availability fields, move them to your country feed before the Graph API v22.0 release in Q1 2025 to ensure that the localized data continues to be uploaded to your products past this date.

The following endpoints are affected: