LY Ads API | Developer Center

LY Ads Display Ads API v20 Release Note

Version released

v20

Date

July 8, 2026

Key points of this release

*Learn more about objects, etc. in the reference document.

Changes to placement list create and edit views

To support changes to the placement list creation and editing screens and related features, some fields were removed from PlacementUrlIdeaService/get. See the following for details.
Changes to placement list create and edit views

Services

PlacementUrlIdeaService

Change

The following fields were removed from the PlacementUrlIdeaService/get response.

• desktopReaches
• desktopAdRequests
• smartPhoneReaches
• smartPhoneAdRequests
• tabletReaches
• tabletAdRequests

Removal of report fields for search keyword targeting

Due to the discontinuation of search keyword targeting, some report fields are no longer available. See the following for details.
Removal of report fields for search keyword targeting

Services

ReportDefinitionService

Change

• You can no longer specify SEARCH_TARGET in report_type.
• When creating a report, you can no longer specify the following:
  • SEARCHKEYWORD_ID
  • SEARCHKEYWORD

Support for app conversion-related metrics

Some report fields have been updated to support the addition of app conversion-related metrics.
See the following for details.
Adding numerical metrics related to app conversions

Services

ReportDefinitionService

Change

Changed the following report item types (Type) from LONG to DOUBLE.

• CONV_VALUE
• ALL_CONV_VALUE
• CONV_VALUE_VIA_AD_CLICK

Maintenance

• Closing old report items
  ReportDefinitionService can no longer specify the following report items.
  
  • IMPRESSION_SHARE_BUDGET_LOSS
  • IMPRESSION_SHARE_RANK_LOSS
  • CLICK
  • VIEWABLE_CLICK
  • START_DATE
  • END_DATE
  • CITY_NAME
  • WARD_NAME
  • PREF_NAME
  • PREF_ID

• In the Java client libraries for v17 - v19, the class name "YahooJapanAdsApiClient" was changed to "AdsApiClient."

Differences between v19 and v20 IF

You can view the differences between Display Ads API v19 and v20 on this page, organized by IF.

Upgrading client library for Java users

The client library of the LY Ads API released for Java users is now compatible with Spring Framework 7 series. We have also updated the version corresponding to the previous version (Spring Framework 6 series).
Select the client library that supports Spring Framework 6 or 7 series according to your system requirements.
Each release of the library and the system requirements are as follows.

*To maintain the previous system environment, use the Spring Framework 6 series compatible version.
Note that Spring Framework 6 series supported versions will be discontinued after a certain period of time. Consider migrating to Spring Framework 7 series as soon as possible.

We have changed the following properties in the retry settings when updating the access token.

• Before jp.co.yahoo.adsdisplayapi.oauth2.retry.max_attempts
• After jp.co.yahoo.adsdisplayapi.oauth2.retry.max_retries

The number of retries has been changed from "Maximum attempts" before the change to "Maximum retries." To maintain the same number of attempts as before, apply the value to one less than the existing setting.

End of LY Ads API v18

LY Ads API v18 will end with the following schedule.
*These dates are subject to change.

• Support end date: August 5, 2026
• End of life date: Early December 2026
  
  

LY Ads API v17 will end with the following schedule.

• End of life date: August 5, 2026

*Support for this version has already ended.