Update 1/31/21: Added links to the changelog. Clarify read/write values and use cases for ad accounts.
In order to effectively guide advertisers to optimal campaign setups, we are redesigning the objective selection experience when creating new campaigns in Ads Manager. We are moving to an Outcome based Ads Manager, where advertisers can select their designed business outcomes (e.g. Awareness, Traffic, Engagement, Leads, App Promotion, Sales) and the interface will guide advertisers to the most optimal campaign setup/creation paths to achieve that outcome.
View our changelog to see the full list of API changes.
The ads ecosystem has become increasingly fragmented, difficult to use, and complex. Advertiser confusion around Objectives has been a noted pain point, specifically, advertisers do not understand which Objectives to select to achieve their desired outcome during campaign setup and creation.
Today, there is no clear or consistent taxonomy that determines what an Objective is and what features live within each Objective. In addition, there are redundant options being used for the same or similar purpose. These misalignments further advertiser confusion and often result in suboptimal campaign setups.
The changes will most impact advertisers who predominantly use Conversions, Messages, and Video Views campaigns.
We will be consolidating the 11 objectives into 6, focusing on marketing-outcomes:
By simplifying the objectives and consolidating the 11 to 6, our aim is to achieve the following:
Note: Although the Store Traffic objective will not initially be supported by ODAX, it will still be supported as a legacy objective. We will exclude Ads Managers that use Store Visits in our gradual rollout of ODAX, as we work to support Store Traffic in ODAX in the future.
ODAX will result in changes to the API for all developers in mid/late January. These changes include:
We plan to gradually roll out these changes to Ads Manager throughout 2022. As such, we recommend developers implement the below API changes by April 2022 to help advertisers have a consistent experience when using Ads Manager and your app. (This blog will be updated with additional developer documentation once the API is available in mid/late January).
Read
New Field | Value | Ad Account experience |
has_advertiser_opted_in_odax | true | ODAX experience (6 objectives) |
has_advertiser_opted_in_odax | false | Legacy experience (11 objectives) |
Update 1/31/22: The new field has_advertiser_opted_in_odax indicates whether an ad account can create new campaigns using ODAX objectives. During the rollout phase of ODAX on Ads Manager, some advertisers will have the updated objective experience, and others will not. As such this field will enable you to align your app’s experience with the ad account’s Ads Manager experience for a consistent experience across interfaces.
Write (testing purposes only)
New Field | Value | Ad Account experience |
odax_opt_in | true | ODAX experience (6 objectives) |
odax_opt_in | false | Legacy experience (11 objectives) |
Update 1/31/22: The new field odax_opt_in enables the advertiser to opt-in an ad account to create ODAX campaigns via the API. This field is meant for developer testing purposes only and is provided to help test the new ODAX experience on your app to prepare your apps to align with the new objective experience in Ads Manager.
Note:
Read
Existing field | New ODAX values |
objective |
|
Write
Existing field | New ODAX values |
objective |
|
To create an ODAX campaign, you need to provide a new ODAX objective. You can compare code samples for objective of the new ODAX values vs the current legacy values in our developer documents.
Read
Existing field | New ODAX values |
destination_type |
|
Write
Existing field | New ODAX values |
destination_type |
|
If the campaign is an ODAX campaign group, you will need to provide a new destination type that may be required for certain outcomes such as Engagement and Leads. You can compare code samples for destination_type of the new ODAX values vs the current legacy values in our developer documents.
Restrictions
There will be new restrictions on ODAX campaigns. You can view the set of restrictions in our developer documents.
Restrictions that were based on legacy objectives, are now decided by destination type, promoted object and optimization goal.
Examples: