Version 19.0

Marketing API

January 23, 2024 | Available until February 4, 2025 | Blog post

Insights

Ads Insights

Applies to v19.0+.

  • The age_targeting, gender_targeting, labels, and location insights metrics will no longer be available.
  • The estimated_ad_recall_rate_lower_bound, estimated_ad_recall_rate_upper_bound, estimated_ad_recallers_lower_bound, and estimated_ad_recallers_upper_bound insights metrics will no longer be available.

The following endpoints are affected:

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_optimization field 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_signal field to either 1 or 3 based on the set of objectives and optimizations.
  • The targeting_as_signal field 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: