Archived Marketing API Changes 2022

Warning

Deprecation Notice
The Marketing Version 202311 (Marketing November 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

November 2022

Product & Platform Announcements

• Engagement Retargeting API: Retarget an audience based on content engagement or member actions. The Engagement Retargeting API is available again starting with the November API version, after we removed the API in May due to a bug. You can retarget audiences based on content engagement or member actions such as company website or LinkedIn Page visits, engagement with Single Image Ads, Video Ad views, Lead Gen Form opens and more. We’ve also introduced more flexibility with website retargeting lookback windows, and added the ability to delete segments.

• New methodology for Video Completion Rate: To align with the industry standard, we are changing how we calculate Video Completion Rate (VCR) for all videos across LinkedIn and the LinkedIn Audience Network (LAN) — from completions divided by views to completions divided by plays. Learn more about the definitions of these metrics here. VCR is a derived metric that is not shared in any APIs. However, if you are calculating VCR using data that is available via Ad Analytics API, we recommend updating the calculation to videoCompletions divided by videoStarts as a percentage.

• Deprecating API decoration: Starting with the 202211 version, we will no longer support API Decoration for the adAccounts, adCampaigns and adCampaignGroups APIs; we will deprecate API Decoration for other APIs in future versions. To replace API Decoration, we are introducing additional fields in the schemas. Learn more about how to access these fields here.

• A new, more focused inbox experience: We’re introducing a two-tabbed inbox in the LinkedIn platform so members can more easily find and respond to the messages that matter most. The Focused tab contains the most relevant messages, while the Other tab houses the remaining conversations. Sponsored Messages will be delivered to the Focused tab for members who have a higher propensity to click or submit a lead based on their past interactions with Sponsored Messages. Sponsored Messages will be delivered in the Other tab for all other members. No action is required. Please make note of this change as it may impact campaign performance. Learn more here.

October 2022

Product & Platform Announcements

• Offline Conversions API: A new API to measure the marketing impact on offline events The new Offline Conversions API gives you the tools to build a solution that enables you to attribute offline marketing data to more accurately measure the down-funnel effectiveness of ad campaigns - unlocking insights to improve ROI measurement and optimize performance. See this blog post to learn more about what you can build with this API, how it can benefit your customers, who this API is for, and how to apply for access.

• Organization Follower Statistics API: New accurate and comprehensive follower data for Pages. Starting with the version 202210, the organization follower breakdown is replaced by legacy geo region and country with the Bing Geo market area and country/region. This will provide more accurate and comprehensive geographical data for Page followers. To avoid disruption and inconsistency in the naming conventions and follower counts across products, please take the following actions:

1. Migrate to followerCountsByGeo or followerCountsByGeoCountry and to be able to read the Bing Geo URNs, which can be resolved by the Bing Geo API.
2. Migrate to the new Industry Taxonomy Versions API, introduced in the September 2022 update, to resolve the industry V2 URNs in followerCountsByIndustry.

• Ad Campaigns API: LinkedIn Audience Network offsiteDeliveryEnabled field now required. The LinkedIn Audience Network (LAN) helps you reach targeted professional audiences across multiple touch points and in different trusted environments to boost campaign performance. Starting with the version 202210, you will have to explicitly set the offsiteDeliveryEnabled field (now a mandatory) to be true or false, so that the LinkedIn Audience Network can be enabled across all eligible campaigns.

September 2022

Product & Platform Announcements

• Ad Supply Forecasts API: New metricType values for cost per key result forecasting such as COST_PER_MILLION_IMPRESSIONS, COST_PER_MILLION_CLICKS, COST_PER_MILLION_VIEWS, COST_PER_MILLION_LEADS, COST_PER_MILLION_REACHES, and COST_PER_MILLION_MESSAGE_SENDS have been added to the /adSupplyForecasts API. This enables advertisers to understand cost per objective key result hypothetically based on their campaign set up, so they can better plan their campaign and budget use.

• Brand Lift Results API: we’ve introduced two new values to understand statistical strength of Brand Lift test. First, statistical strength for Relative Brand Lift has been added as relativeLiftStatisticalStrengthMetrics to adLiftResultMetrics. Secondly, the statistical strength for demographic breakdown is now available as adLiftResultStatisticalMetrics in adLiftTestResultMetricMemberDemographicBreakdowns.

• Industry Taxonomy Versions API: We’ve introduced a new API to better represent industry data on LinkedIn. It replaces the /industries API and queries industry data based on industry URNs. The new API offers a hierarchical structure to easily navigate the comprehensive list of industries available on LinkedIn. It supports the existing industry data and 400+ additional industry codes that are aligned with the North American Industry Classification System (NAICS).

• New API Postman Collection workspace for versioned APIs only A new workspace dedicated for versioned APIs is now available to test newly released versioned APIs. Clicking on the “Try with postman” button from public developer pages links you right into this workspace. This change enhances the overall dev experience, searchability & tracking capabilities. Check it out.

Breaking Changes

• Unversioned Ad Analytics API: approximateUniqueImpressions available again [in beta] In our July update, we communicated the removal of the approximateUniqueImpressions metric. As of September 12, 2022, we’ve reinstated this metric in the AdAnalyticsV2 endpoint, based on feedback from our partners and our customers. The reach metric will come with a new 92-day maximum window, meaning you will be able to pull the metrics on any dimension (e.g. campaign level, campaign-group level, etc.,) for any time range<=92 days. For all campaigns, the approximateUniqueImpressions metric is currently in beta, meaning that we’re still testing and iterating on it. During these iterations, the calculation of the metric can change. Therefore, we recommend using this metric directionally. We do not recommend using it for historical performance comparisons. Moreover, for campaigns running on our Audience Network, some traffic is excluded, so the metric may be underestimated — in some cases significantly. We will also deprecate the following approximateReach metrics from the unversioned APIs starting in October: averageDailyReachMetrics,averagePreviousDayReachMetrics, averagePreviousSevenDayReachMetrics, averagePreviousThirtyDayReachMetrics.

• DMP Segments Lookalike API: Starting October 31, 2022, we will introduce 1 minute per user (a.k.a member) rate limits for our Lookalike API. The limits will be enforced such that there is minimal interruption to existing applications and their users. For more detailed information, see the rate limit specific sections of our FAQ.

• Unversioned Industries API: Starting January 31, 2023, the /industries API will be deprecated. It has been replaced by the Industry Taxonomy Versions API. Requests made to /industries will receive a 404 status code error in response.

Reminders

• DMP Segments API: New rate limits for users and companies streaming endpoints. Starting October 31, 2022, we will introduce 1 minute per user (a.k.a member) rate limits for our streaming APIs. The limits will be enforced such that there is minimal interruption to existing applications and their users. For more detailed information, see the rate limit specific sections of our FAQ.

• All LinkedIn Marketing APIs are now versioned: We now support API versioning for all LinkedIn Marketing APIs – giving you the power to decide when to adopt API changes. The first version is available now, and we will release a new version every month. We intend to support each API version for a full year with its own set of documentation that covers all Marketing APIs. Continue to check the Recent Changes page to stay up to date on the latest releases. To call an API version, include the request header with key “LinkedIn-Version” and set the value to correspond with the version you’re referencing using the YYYYMM format. Get started with this blog post, walk through video, or documentation. Make sure to migrate to the new APIs before February 2023 when we will sunset the Shares and UGC APIs.

• New Content APIs that simplify the content creation experience and save you time: We introduced four new Content APIs that enable you to build quicker and to adopt the latest formats easier: Images, Videos, Post, and Creatives. With the new APIs, we’ve reduced the steps to upload creative assets and create posts, and the APIs are built to support your workflow. Get started with the new migration guide. Make sure to migrate before February 2023 when we will sunset unversioned APIs.

August 2022

Product & Platform Announcements

• Ad Account Users API: We’ve updated our error format to make the errors more descriptive and easier to resolve.

Breaking Changes

• New rate limits for users and companies streaming endpoints: Starting October 31, 2022, we will introduce 1 minute per user (a.k.a member) rate limits for our streaming APIs. The limits will be enforced such that there is minimal interruption to existing applications and their users. For more detailed information, see the rate limit specific sections of our FAQ.

Reminders

• All LinkedIn Marketing APIs are now versioned: We now support API versioning for all LinkedIn Marketing APIs – giving you the power to decide when to adopt API changes. The first version is available now, and we will release a new version every month. We intend to support each API version for a full year with its own set of documentation that covers all Marketing APIs. Continue to check the Recent Changes page to stay up to date on the latest releases. To call an API version, include the request header with key “LinkedIn-Version” and set the value to correspond with the version you’re referencing using the YYYYMM format. Get started with this blog post, walk through video, or documentation.

• New Content APIs that simplify the content creation experience and save you time: We introduced four new Content APIs that enable you to build quicker and to adopt the latest formats easier: Images, Videos, Post, and Creatives. With the new APIs, we’ve reduced the steps to upload creative assets and create posts, and the APIs are built to support your workflow. Get started with the new migration guide.

July 2022

Product & Platform Announcements

• Posts API

  • Create Polls and Multi-Image Posts to engage your community: Our new Posts API now supports the creation and retrieval of polls and multi-image posts, increasing the variety of content formats marketers can use to reach their audiences.

• Dynamic UTM API/adTrackingParameters

  • Create a dynamic UTM parameter to effectively track campaigns: You can now attach dynamic and custom UTM parameters on supported creative URLs to understand your ad's effectiveness across platforms and to track all campaigns and creatives uniquely, even if duplicated from an existing campaign. These macros are automatically filled with LinkedIn platform values for a campaign, creative, account, and more. Moreover, you don't need to trigger numerous creative content changes for UTM tracking purposes, which overloads Ads Quality with creative edit history and large review queues. Sponsored Content (Image, Article, Video) will be supported with this change. Support for Dynamic Ads, Carousel, and Message ads will come later. All partners using Shares and UGC APIs exclusively for UTM purposes, should now use this new API and avoid duplicate UTM assignments due to more than one method. Previous static UTM assignments will be preserved, but moving them from content to campaign is advisable using this API.

• Brand Lift API

  • Get brand lift survey results broken down by member age and gender demographics: Two new values MEMBER_AGE_RANGE and MEMBER_GENDER are added to AdLiftTestMemberDemographicCategory Enum. You can now see raw survey results and lift metrics broken down by member age range and gender demographics (assuming that there are enough data points, according to our privacy thresholds). Start reading the new enum values to see member age and gender demographics for the adLiftTestResults.

Breaking Changes

• Ad Analytics API
  • approximateUniqueImpressions removed on July 31: On June 8, we launched 9 new metrics on the versioned & unversioned Ad Analytics API to replace the approximateUniqueImpressions metric. These new metrics are contained within the averageDailyReachMetrics, averagePreviousSevenDayReachMetrics, and averagePreviousThirtyDayReachMetrics sub-records and will approximately reach, frequency, and cost per 1,000 member accounts reached for three fixed time ranges: the current day, the last 7 days, and the last 30 days. You’ll be able to pull these metrics for any day. approximateUniqueImpressions will be removed on July 31, 2022 from the API, and any calls with this metric will result in a 404 error.

Reminders

• All LinkedIn Marketing APIs are now versioned: We now support API versioning for all LinkedIn Marketing APIs – giving you the power to decide when to adopt API changes. The first version is available now, and we will release a new version every month. We intend to support each API version for a full year with its own set of documentation that covers all Marketing APIs. Continue to check the Recent Changes page to stay up to date on the latest releases. To call an API version, include the request header with key “LinkedIn-Version” and set the value to correspond with the version you’re referencing using the YYYYMM format. Get started with this blog post, walk through video, or documentation.

• New Content APIs that simplify the content creation experience and save you time: We introduced four new Content APIs that enable you to build quicker and to adopt the latest formats easier: Images, Videos, Post, and Creatives. With the new APIs, we’ve reduced the steps to upload creative assets and create posts, and the APIs are built to support your workflow. Get started with this blog post or walk through video.

June 2022

Platform

• Introducing API Versioning at LinkedIn
  • Who’s impacted: All partners
  • What’s happening: We now support API versioning for all LinkedIn Marketing APIs – giving you more power to decide when to adopt API changes. The first version is available now, and we will release a new version every month. Each API version will be supported for a full year with its own set of documentation that covers all Marketing APIs. Continue to check the Recent Changes page to stay up to date on the latest releases. To call an API version, include the request header with key “LinkedIn-Version” and set the value to correspond with the version you’re referencing using the YYYYMM format. Get started with this blog post, walk through video, or documentation.
• New Content APIs that simplify the content creation experience
  • Who’s impacted: Partner using Shares or UGCPost APIs
  • What’s happening: We’re introducing four new Content APIs that enable you to build quicker and to adopt the latest formats easier: Images, Videos, Post, and Creatives. With the new APIs, we’ve reduced the steps to upload creative assets and create posts, and the APIs are built to support your workflow. Get started with this blog post or walk through video.

• Get started with the new versioned and Content APIs using postman collection
  • Who’s impacted: All partners
  • What’s happening: The LinkedIn Marketing Solutions Versioned API's public workspace in Postman is updated to help you quickly get started with the versioned API and new Content APIs. View our online documentation for more information on getting started with Postman.

Reporting & ROI

• [reminder] New Reporting Metrics
  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening: Starting June 8, 2022, we provided 9 new metrics on the AdAnalyticsV2 API to replace the existing approximateUniqueImpressions metric. These new metrics are contained within the averageDailyReachMetrics, averagePreviousSevenDayReachMetrics, and averagePreviousThirtyDayReachMetrics subrecords and will approximate reach, frequency, and cost per 1,000 member accounts reached for three fixed time ranges: the current day, the last 7 days, and the last 30 days. You’ll be able to pull these metrics for any day. For example, you can pull the “average last 7-day reach” for October 25, (which covers October 18 - October 25), for October 24 (which covers October 17 - October 24), and selecting October 24 - October 25 will average the two individual last 7-day counts. approximateUniqueImpressions will be removed July 31, 2022. Calls requesting approximateUniqueImpressions after this date will receive a 400 error in response.

Breaking Changes

• [reminder] New industryV2 filter for Company Search API
  • Who’s impacted: Partners using the Company Search API industry parameter
  • What’s happening: If you are currently using the Company Search API to find companies using the filter.industry parameter, we are deprecating the existing filter.industry parameter in favor of a new parameter, filter.industryV2, which supports all values plus 200+ new industry codes. Learn more.
  • When: Starting June 30, 2022
• [reminder] Updating LinkedIn Audience Network to being enabled by default via Ads Campaign API
  • Who’s impacted: Partners using the Ad Campaigns API
  • What’s happening: The LinkedIn Audience Network helps customers reach, engage and convert targeted professional audiences in different trusted environments beyond the LinkedIn Feed to boost performance across advertising objectives. Within the LinkedIn Campaign Manager UI, LinkedIn Audience Network is enabled by default, and we’re updating the API accordingly. This means that the default value for offsiteDeliveryEnabled will change from false to true for new campaigns. If you support our Audience Network in your platform, please ensure that the option for it is also set as true by default so that advertisers can continue to benefit from reach and scale efficiencies. If you do not support our Audience Network, make sure this field is set to false to avoid having ads being served on it. We recommend enabling the Audience Network for all eligible objective types and ad formats. Learn more here.
  • When: Starting June 30, 2022
• [reminder] approximateUniqueImpressions metric to be sunset
  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening: API requests that include approximateUniqueImpressions metric in their request query will receive a 400 status code error in response. More details to migrate to new reach & frequency metrics are mentioned above.
  • When: July 31, 2022

May 2022

Campaign Management

• Engagement Retargeting unavailable until further notice
  • Who’s impacted: Partners using or considering the Engagement Retargeting API
  • What’s happening: We discovered a bug that impacts the Engagement Retargeting API. While we resolve the bug, the API will be un-externalized and not available. We’ll update you via this newsletter when the API is available again.
• Removal of campaign floor price (unitCost field)
  • Who’s impacted: Partners using the Ad Campaigns API or Ad Budget Pricing API
  • What’s happening: We are removing the floor price for manual bidding campaigns. Beginning on July 18, when creating manual bidding campaigns, advertiser campaigns now must satisfy two criteria: a bid must be greater than 0 and cannot exceed bidLimits.max. Previously, bids had to be greater than bidLimits.min, which is returned by the Ad Budget Pricing API. If you are using bidLimits.min as a requirement for unitCost, you no longer need to and only need to ensure bids are greater than 0. If an advertiser tries to create or update a campaign to have bid > 0 and below bidLimits.min, this will no longer return an error. The campaign would be created successfully.
• Brand Lift Test Benchmarking released
  • Who’s impacted: Advertisers currently adopting or will adopt the Brand Lift Test API
  • What’s happening: We’re introducing Brand Lift Test Benchmarking, which provides industry and region-level benchmarks for brand lift results. The solution will [a] allow for comparison of results to other tests that selected the same region and industry and [b] enable customers to make better decisions from their results by contextualizing brand lift against other advertisers.

Reporting & ROI

• New Reporting Metrics
  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening:
    • New Reach & Frequency Metrics: Starting June 8, 2022, we will provide 9 new metrics on the AdAnalyticsV2 API to replace the existing approximateUniqueImpressions metric. These new metrics are contained within the averageDailyReachMetrics, averagePreviousSevenDayReachMetrics, and averagePreviousThirtyDayReachMetrics sub records and will approximate reach, frequency, and cost per 1,000 member accounts reached for three fixed time ranges: the current day, the last 7 days, and the last 30 days. You’ll be able to pull these metrics for any day. For example, you can pull the “average last 7-day reach” for October 25, (which covers October 18 - October 25), for October 24 (which covers October 17 - October 24), and selecting October 24 - October 25 will average the two individual last 7-day counts. approximateUniqueImpressions will be removed July 31, 2022. Calls requesting approximateUniqueImpressions after this date will receive a 400 error in response.
    • Event Registrations: Advertisers can now run ads to drive registrations to online events. The new registrations metrics capture the number of registrations occurring after the member saw or clicked on an ad which is set up to land on the event registration page.
    • Document Progress & Completions: Document ads provide advertisers a way to show documents natively in the feed which users can peruse or download. Document metrics, similar to video metrics, show insight into the progress users make through reading the document and how many times the document has been downloaded.
    • Job Apply Clicks & Applications: Talent media ads promote job pages. jobApplyClicks and jobApplications count when a member sees a talent media ad and then clicks to apply or submits their application on the job’s landing page.

Breaking Changes

• approximateUniqueImpressions metric to be sunset

  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening: API requests that include approximateUniqueImpressions metric in their request query will receive a 400 status code error in response. More details to migrate to new reach & frequency metrics are mentioned above.
  • When: July 31, 2022

• [reminder] New industryV2 filter for Company Search API

  • Who’s impacted: Partners using the Company Search API industry parameter
  • What’s happening: If you are currently using the Company Search API to find companies using the filter.industry parameter, we are deprecating the existing filter.industry parameter in favor of a new parameter, filter.industryV2, which supports all values plus 200+ new industry codes. Learn more.
  • When: Starting June 30, 2022

• [reminder] Updating LinkedIn Audience Network to being enabled by default via Ads Campaign API

  • Who’s impacted: Partners using the Ad Campaigns API
  • What’s happening: The LinkedIn Audience Network helps customers reach, engage and convert targeted professional audiences in different trusted environments beyond the LinkedIn Feed to boost performance across advertising objectives. Within the LinkedIn Campaign Manager UI, LinkedIn Audience Network is enabled by default, and we’re updating the API accordingly. This means that the default value for offsiteDeliveryEnabled will change from false to true for new campaigns. If you support our Audience Network in your platform, please ensure that the option for it is also set as true by default so that advertisers can continue to benefit from reach and scale efficiencies. If you do not support our Audience Network, make sure this field is set to false to avoid having ads being served on it. We recommend enabling the Audience Network for all eligible objective types and ad formats. Learn more here.
  • When: Starting June 30, 2022

April 2022

Campaign Management

• Delete Ad entities
  • Who’s impacted: Partners using the Ad Account API, Campaign API, Campaign Group API, and Creatives API
  • What’s happening: Partners can now delete ad entities (Ad Account, Campaign Group, Campaign, and Creative) in any status, including test entities. This action is permanent and cannot be recovered. Deleted entities that contain spend data are moved into a read-only REMOVED status in order for billing administrators to reconcile charges. Search or retrieve of ad entities may show these new values (PENDING_DELETION, REMOVED) in the status field.

Page Management

• Editing page comments
  • Who’s impacted: Partners using the Comments API
  • What’s happening: Partners can now edit existing comments. Only the comment’s message field, which contains the comment’s text, is editable. Unlike the endpoints for CREATE and GET, the new PARTIAL_UPDATE endpoint will not have a resolved URN in its responses’ $URN field.

Audiences

• Granular rate limiting for Audiences
  • Who’s impacted: Audiences partners using the /users and /companies streaming endpoints
  • What’s happening: We will be introducing 1 minute per user (a.k.a member) rate limits for our streaming APIs. The limits will be enforced such that there is minimal interruption to existing applications and their users. For more detailed information, see the rate limit specific sections of our FAQ.
  • When: Starting July 31, 2022

Breaking Changes

• [reminder] New API call length requirements
  • Who’s impacted: All partners
  • What’s happening: To improve our network infrastructure and API traffic, we now require all API calls to meet the new length requirements. Requests exceeding the new length requirements will be rejected. To avoid calls being rejected, we recommend using query tunneling. See migration guide here.
  • When: Starting April 30, 2022
• [reminder] New industryV2 filter for Company Search API
  • Who’s impacted: Partners using the Company Search API industry parameter
  • What’s happening: If you are currently using the Company Search API to find companies using the filter.industry parameter, we are deprecating the existing filter.industry parameter in favor of a new parameter, filter.industryV2, which supports all values plus 200+ new industry codes. Learn more.
  • When: Starting June 30, 2022
• Updating LinkedIn Audience Network to being enabled by default via Ads Campaign API
  • Who’s impacted: Partners using the Ad Campaigns API
  • What’s happening: The LinkedIn Audience Network helps customers reach, engage and convert targeted professional audiences in different trusted environments beyond the LinkedIn Feed to boost performance across advertising objectives. Within the LinkedIn Campaign Manager UI, LinkedIn Audience Network is enabled by default, and we’re updating the API accordingly. This means that the default value for offsiteDeliveryEnabled will change from false to true for new campaigns. If you support our Audience Network in your platform, please ensure that the option for it is also set as true by default so that advertisers can continue to benefit from reach and scale efficiencies. If you do not support our Audience Network, make sure this field is set to false to avoid having ads being served on it. We recommend enabling the Audience Network for all eligible objective types and ad formats. Learn more here.
  • When: Starting June 30, 2022

Coming Soon

• [reminder] Upcoming Reach & Frequency metric changes
  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening: In Q2 CY 2022, 9 new metrics on the AdAnalyticsV2 API will be available, and replace the existing approximateUniqueImpressions metric. These new metrics will approximate reach, frequency, and cost per 1,000 member accounts reached for three fixed time ranges: the previous day, the last 7 days, and the last 30 days. You’ll be able to pull these metrics for any day. For example, you can pull the “average last 7-day reach” for October 25, (which covers October 18 - October 25), for October 24 (which covers October 17 - October 24), and selecting October 24 - October 25 will average the two individual last 7-day counts. Please plan accordingly to have time to migrate to these new metrics. The exact date for removal of the existing reach metric will be announced when the replacement metrics are available.

March 2022

Platform

• All access and refresh token requests should be made using only the POST method

  • Who’s impacted: All partners
  • What’s happening: Reminder that access and refresh token requests should be made using only the POST method with the request header “Content-Type”: “x-www-form-urlencoded” and all required parameters in the request body.

• Getting started with LinkedIn Marketing APIs just got easier with a Marketing Sample Application.

  • Who’s impacted: All partners
  • What’s happening: The Marketing Sample Application provides ready-to-use code that you can use to try out RESTful API calls to LinkedIn's OAuth and Marketing APIs. For example, you can use the sample application to fetch an authenticated user's ad account and role profile to confirm access. Learn more.

Campaign Management

• New cost control bid strategy for all advertisers
  • Who’s impacted: Partners using adCampaignsV2 and adSupplyForecastsV2 APIs
  • What’s happening: Cost Cap Bidding is an automated bid strategy that enables you to input your maximum cost per key (CPX) result when setting up a campaign. LinkedIn provides you with all of the possible results in accordance with the maximum CPX cost you set. To create campaigns with this bid strategy, use the new optimization target types described here. Cost Cap Bidding is a new feature which is ramping and may not be immediately available to all advertisers.
• Retarget audiences that visited a website or engaged with an ad
  • Who’s impacted: Partners using the Engagement Retargeting API
  • What’s happening: Partners can use the new trigger WEBSITE and SINGLE_IMAGE_ADS to create engagement retargeting segments, retargeting audiences who have visited your website, performed chargeable clicks on your single image ads, or engaged with your single image ads.

Page Management

• New industryV2 filter for Company Search API
  • Who’s impacted: Partners using the Company Search API industry parameter
  • What’s happening: If you are currently using the Company Search API to find companies using the filter.industry parameter, we are deprecating the existing filter.industry parameter in favor for a new parameter, filter.industryV2, which supports all values plus 200+ new industry codes. The filter.industry parameter will sunset on June 30, 2022. Learn more.

Breaking Changes

• [reminder] New API call length requirements
  • Who’s impacted: All partners
  • What’s happening: To improve our network infrastructure and API traffic, we now require all API calls to meet the new length requirements. Requests exceeding the new length requirements will be rejected. To avoid calls being rejected, we recommend using query tunneling. See migration guide here.
  • When: Starting April 30, 2022
• New industryV2 filter for Company Search API
  • Who’s impacted: Partners using the Company Search API industry parameter
  • What’s happening: If you are currently using the Company Search API to find companies using the filter.industry parameter, we are deprecating the existing filter.industry parameter in favor for a new parameter, filter.industryV2, which supports all values plus 200+ new industry codes. Learn more.
  • When: Starting June 30, 2022

February 2022

Breaking Changes

• [reminder] New API call length requirements
  • Who’s impacted: All partners
  • What’s happening: To improve our network infrastructure and API traffic, we now require all API calls to meet the new length requirements. Requests exceeding the new length requirements will be rejected. To avoid calls being rejected, we recommend using query tunneling. See migration guide here.
  • When: Starting April 30, 2022

Coming Soon

• [reminder] Upcoming Reach & Frequency metric changes
  • Who’s impacted: Partners using the Ad Analytics API
  • What’s happening: In Q2 CY 2022, 9 new metrics on the AdAnalyticsV2 API will be available and replace the existing approximateUniqueImpressions metric. These new metrics will approximate reach, frequency, and cost per 1,000 member accounts reached for three fixed time ranges: the previous day, the last 7 days, and the last 30 days. You’ll be able to pull these metrics for any day. For example, you can pull the “average last 7-day reach” for October 25, (which covers October 18 - October 25), for October 24 (which covers October 17 - October 24), and selecting October 24 - October 25 will average the two individual last 7-day counts. Please plan accordingly to have time to migrate to these new metrics. The exact date for removal of the existing reach metric will be announced when the replacement metrics are available.

January 2022

Campaign Management

• LinkedIn’s privacy-first approach to B2B digital advertising
  • Who’s impacted: All partners
  • What’s happening: In case you missed it, last month we shared our privacy-first approach to B2B digital advertising. We are introducing new approaches that help provide online consistency across channels and devices, all while limiting or even eliminating the use of third-party personal data including: testing Group Identity for B2B leveraging our first-party data and further investing in B2B measurement. Learn more.
• [reminder] Sponsored Messaging EU Targeting Restrictions
  • Who’s impacted: Partners using the Message Ads API or Conversation Ads API
  • What’s happening: We are stopping the display of Message and Conversations Ads to EU members effective starting January 10, 2022 for new and existing campaigns. New and existing Message or Conversation Ads campaigns targeting EU members will fail with a 400 error. This only affects targeting members based in the EU. Targeting members outside the EU are not impacted.
• [reminder] Changes to conversion tracking on LinkedIn
  • Who’s impacted: Partner using the Insight Tag API
  • What’s happening: In light of changing regulations on privacy, we are asking customers to enable “enhanced conversion tracking” for all LinkedIn Campaign Manager accounts. “Enhanced conversion tracking” allows first-party cookie tracking to minimize impact to their campaign performance due to privacy changes. If a customer uses LinkedIn Insight Tags, we recommend they enable “enhanced conversion tracking” in Campaign Manager. If a customer uses site-wide image pixels, we recommend they switch to Insight Tag and enable “enhanced conversion tracking”. There is no impact to your integration. More information can be found in this help center article.

Breaking Changes

• [reminder] OAuth 2.0 scopes enforcement
  • Who’s impacted: All partners
  • What’s happening: We sunset all legacy OAuth permissions on December 31, 2021. Ensure your authorization request only includes permissions listed in your application settings otherwise your call will be rejected. The complete permission list is under the “Auth” tab under “OAuth 2.0 scopes”.
• [reminder] New API call length requirements
  • Who’s impacted: All partners
  • What’s happening: To improve our network infrastructure and API traffic, we now require all API calls to meet the new length requirements. Requests exceeding the new length requirements will be rejected. To avoid calls being rejected, we recommend using query tunneling. See migration guide here.
  • When: Starting April 30, 2022