Version 20.0

Marketing API

May 21, 2024 | Available until May 6, 2025 | Blog post

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:

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.

Reservation

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. Any campaigns of this type that are still running will be disabled beginning August 19, 2024.

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.

The following endpoints are affected: