Marketing Developer Platform Changes | March 2023

Product & Platform Announcements

• Ad Analytics API: Introducing validWorkEmailLeads metric and PLACEMENT_NAME pivot Starting with the 202303 version, we are introducing the following:
  • validWorkEmailLeads: This metric represents the count of leads with a valid work email that does not use an established free or personal email domain.
  • PLACEMENT_NAME: This pivot enables grouping of metrics by placement. The pivot values are: LINKEDIN, OFFSITE and OFFSITE_IN_STREAM. Only LAN(Linkedin Audience Network) enabled video campaigns are eligible to deliver on offsite in-stream inventory. When video campaigns deliver on offsite in-stream inventory, you will see the metrics available for "OFFSITE_IN_STREAM" placement.
• Image API & Videos API: Externalizing the Media Library In October 2022, we rolled out the media library in the Campaign Manager UI. The media library provides one location where advertisers can upload, manage, and select images and videos for single image ads and video ads. We are externalizing the media library for our API partners so that advertisers can use the same media library during ad creation on partner platforms.
• This will allow API partners to perform the following actions:
  • initializeUpload (existing method): This is an existing method for asset upload; the update in the release would be parallel registration under the Media Library
  • findByAssociatedAccount (new method): Return all media library assets under a specific account and asset type
• partialUpdate (new method): Update an existing media library asset- specifically to rename an asset or to archive it
  • We will enable findByIdsAndAssociatedAccount to return specific media library assets based on ID in a future release.
• Saved Audience Template API: Save Audience Criteria
  
• We are introducing a new API to enable the following:
  • Save audiences, including targeting attributes and/or existing matched audiences, for easy re-use in campaigns. This is especially valuable for users who build audiences via the Audience Insights and wish to apply those audiences to a campaign.
  • Fetch audiences to access audience insights when used in tandem with the Audience Insights saved via the Campaign Manager UI.
• Ads A/B Testing API: Test Campaign Performance
  
• We have launched A/B Testing to help our advertisers optimize their ROI with rigorous testing. A/B Testing measures the performance of two campaigns with equal audiences and budgets to test one variable, such as creative content / ad format, targeting, or placement. The testing tool then selects a winner (if any), or verifies that the performance difference between the variants is insignificant or inconclusive.

Breaking Changes

• Ad Analytics API: Change in structure of query parameters**

Starting with the 202303 version, we will change the format of certain query parameters in both the analytics finder and the statistics finder. In both finders, pivot, pivots, timeGranularity, campaignType, and objectiveType would be records containing the expected values instead of directly accepting values. For example, pivot=CAMPAIGN would become pivots=(value:List(CREATIVE,CAMPAIGN)) would become pivots=List((value:CREATIVE),(value:CAMPAIGN)).

• Creatives API: Change in the structure of IntendedStatuses finder parameter** Starting with the 202303 version, intendedStatuses query parameter in the finder request would be a record which would contain the expected array instead of directly accepting an array value. Instead of providing intendedStatuses=List(ARCHIVED,CANCELED) we would require passing intendedStatuses=(value:List(ARCHIVED,CANCELED)).
• API Decoration Deprecation: In November 2022, we began deprecating API decoration for some APIs. Starting with the 202303 version, we will no longer support decoration on the following APIs:
  • Creatives API
  • Images API
  • Videos API
  • Ad Lift Test Results API
  • Insight Tags Permissions API
  • Insight Tags API
  • Audience Counts API

Reminders

• Migrate to the new Community Management API before June 30, 2023. We’re accelerating our push to release more functionality that enables your customers to know and grow their professional communities — starting with a new Community Management API. Existing community management partners must migrate to the new API by June 30, 2023. Check out this article to learn more about our plans for community management.
• All access and refresh token requests should only be made using the POST method after June 30, 2023. This is a reminder that access token and refresh token requests should be made using only the POST method to /accessToken endpoint with the request header Content-Type: x-www-form-urlencoded and all required parameters in the request body. We will start returning 400 errors on the GET /accessToken endpoint after June 30, 2023.