Marketing Developer Platform Changes | January 2024

January 15, 2024

Product & Platform Announcements 

AdAccounts, Campaign Groups, Campaigns, Creative API: Adopt cursor-based pagination by May 31, 2024

We are moving from index-based to cursor-based pagination. You will need to use pageToken returned in the previous call to get to the next set of results, instead of accessing a random page using start and count. 

  • Instead of start & count, pageToken and pageSize will be used for pagination
  • PageSize will be used to specify the number of entities to be returned
  • NextPageToken is an opaque string which will be returned in the metadata and it represents the last entity in the response. It can be used to fetch the next set of results by passing it in “pageToken” in the next api call
  • Sorting will only be supported by id. SortOrder will define the sorting order (Ascending/ Descending) of the results
  • Totals will no longer be supported as a query parameter

After May 31, we will sunset index-based pagination from all API versions prior to 2024, so you will need to migrate to any 2024 API version before then. 

Ad Preview API: Migrate to latest version 

On February 29, 2024 we will sunset ads preview from all API versions before 202311. To continue to support ads preview, make sure to migrate to the latest version. 

Ad Analytics API: Upcoming Reach metric changes 

Starting in January 2024, approximateUniqueImpressions will be deprecated and the new API field will be called approximateMemberReach. As we move to a new metric measurement methodology, you may see some deviation between upcoming approximateMemberReach and old approximateUniqueImpressions for the same creative/campaign/campaign group with the same date range. Additionally, we will be restricting the availability of approximateMemberReach metrics in the following ways:

  • approximateMemberReach will only be supported with pivot(s): CREATIVE, CAMPAIGN, CAMPAIGN_GROUP, CAMPAIGN_TYPE, OBJECTIVE_TYPE and/or SERVING_LOCATION. All requests which supply additional pivot(s) will not include approximateMemberReach in the response.
  • approximateMemberReach can be requested for date ranges with a maximum range of 92 days. 
  • approximateMemberReach will not be available for the current UTC day. The expected delay for current UTC day will be 24-48 hours. Requests which include today in the date range will only return reach for days where data exists.

Page Statistics API: Improving location standardization for demographic analytics 

We will replace the Page demographic breakdown by legacy geo region and country with the Bing Geo market area and country. This will provide more accurate and comprehensive geographical data. As a result, pageStatisticsByRegion and pageStatisticsByCountry will be replaced with pageStatisticsByGeo and pageStatisticsByGeoCountry

Creatives API & legacy Creatives API: Updates to Ad Creative Rejection Reasons 

  1. We have added a new rejection reason symbol, which could be returned as rejection reasons from the API: MISINFORMATION 
  2. We have updated the description for below existing rejection reasons:
    1. PRESCRIPTION_DRUGS
    2. OVER_THE_COUNTER_DRUGS
    3. MEDICAL_DEVICES_AND_TREATMENTS
    4. ILLICIT_OR_RECREATIONAL_DRUGS_AND_RELATED_PRODUCTS
    5. LEGITSCRIPT_APPROVAL_MISSING
  3. PHARMACY_AND_TELEHEALTH

Lookalike Audiences API: Sunset on February 29

On February 29, 2024, we will sunset the ability to create new Lookalike Audiences in both Campaign Manager and via API, as we evolve our audience solutions and invest in new solutions to help scale marketers’ first- and third-party data. Existing Lookalike Audiences can still be used in campaigns but will not be updated when the seed audience updates. Additionally, the following changes will impact existing audiences: 

  • If the LaL audience is not used in a draft or active campaign for 30 days, it will be ARCHIVED 
  • If an LaL audience is ARCHIVED but added to a draft or active campaign, it will go back to BUILDING but it will not be regenerated. It will reflect the original state of the LaL as it was prior to February 29
  • If an ARCHIVED LaL audience is EXPIRED, it is purged and can never be used again