Yahoo! JAPAN Ads API | Developer Center

日本語

Yahoo! JAPAN Ads Search Ads API v18 Release Note

Version released

v18

Date

October 15, 2025

Key points of this release

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

1. Additional measures following the end of the autobidding type "Enhanced CPC"

We took additional measures in response to the end of the autobidding type "Enhanced CPC."
Refer to the following announcement for details about the end of the feature.
Search Ads: End of autobidding type "Enhanced CPC"

Services

  • CampaignService
  • ReportDefinitionService

Change

・CampaignService
Remove the cpcBiddingScheme from CampaignService.

・ReportDefinitionService
Change the behavior of the ReportDefinitionService during add and getReportFields operations as follows.
There are no changes to the interface. There are no changes in behavior in versions before v17.

■add

  • When specifying reportType=CAMPAIGN, the following values cannot be specified in fields. Specifying them will cause an error.
    ENHANCED_CPC_ENABLED
  • When specifying reportType=BID_STRATEGY, the following values cannot be specified in fields. Specifying them will cause an error.
    TARGET_SEARCH_PAGE_LOCATION
    BID_AUTOMATION
    BID_MULTIPLIER_OF_TARGET_PAGE_LOCATION
    LIMITED_BUDGETS
    LOW_QUALITY_KEYWORDS
    UPPER_BID_LIMIT_OF_TARGET_PAGE_LOCATION
  • When reportType=BID_STRATEGY and fields[] includes BID_STRATEGY_TYPE, the following request will result in an error.
    • When language="JA" or null
      • filters[x].field=BID_STRATEGY_TYPE, and filters[x].values[] contains "Target Position on Search Results Page"
      • filters[x].field=BID_STRATEGY_TYPE and filters[x].values[] contains "Extended cost per click (formerly 'Maximize conversions')"
    • When language="EN"
      • filters[x].field=BID_STRATEGY_TYPE, and filters[x].values[] contains "Target position in search results"
      • filters[x].field=BID_STRATEGY_TYPE and contains filters[x].values[]"Enhanced CPC (Former:Maximize Conversions) "

■getReportFields

  • If reportType=CAMPAIGN is specified, fields[].fieldName won't return the following value.
    ENHANCED_CPC_ENABLED
  • If reportType=BID_STRATEGY is specified, fields[].fieldName won't return the following value.
    TARGET_SEARCH_PAGE_LOCATION
    BID_AUTOMATION
    BID_MULTIPLIER_OF_TARGET_PAGE_LOCATION
    LIMITED_BUDGETS
    LOW_QUALITY_KEYWORDS
    UPPER_BID_LIMIT_OF_TARGET_PAGE_LOCATION

2． Specifying radiuses will be available in geo targeting

In geo targeting, defining the target area by specifying a target point and its radius is available.
*This feature is already available in the Campaign Management Tool. See the following for details.
Search Ads: Specifying radiuses will be available in geo targeting

Services

CampaignTargetService

Change

Add a radius specification field to the CampaignTargetService (add/get/set/remove).

  • Add radiusTarget under target
  • Add RADIUS to targetType

3． Add errors in AbTestService

Add new error. Add to all available versions.

Services

AbTestService

Change

Add the following to the errors returned by abTestService's abTest.errors[].
CAMPAIGN_CRITERION_OVER_LIMIT

Error details: You have reached the maximum total number of "Excluded keywords specified in the campaign," "Associations of target lists with campaigns," "Settings for geo targeting, day of week/hours targeting, and device targeting," and "Target pages of Dynamic Ads for Search (exclusions)."

4. Shopping Search Ads system renewal

Renew the listing system for Shopping Search Ads of Search Ads (Shopping).
See the following announcement for details.
Search Ads (Shopping): System renewal and feature changes for Shopping Search Ads

Services

SsaReportDefinitionService

Change

  • getReportFields will return "SYSTEM_BRAND."
  • You can specify "SYSTEM_BRAND" when add.
  • The following fields are no longer available and will not be returned in getReportFields.
    CAMPAIGN_TRACKING_ID
    ADGROUP_TRACKING_ID
    PRODUCT_GROUP_TRACKING_ID

5. Maintenance

  • The following changes will be made to support future features.
    　It won't be available until the official feature release. Wait for further announcements with detailed schedules.
    • Services
      AdGroupAdService
    • Change
      • Add requiredAssets under responsiveSearchAd.
      • Add the following ENUM values to approvalStatus.
        APPROVED_WITH_PRE_DISAPPROVED
        POST_DISAPPROVED_WITH_REVIEW
  • In the Java client library, release versions with the suffix "-spring5" will no longer be supported as of v17.

Differences between v17 and v18 IF

You can view the differences between Search Ads API v17 and v18 on this page, organized by IF.

End of Search Ads API v15

Search Ads API v16 will end with the following schedule:

  • Support end date: November 26, 2025
  • End of life date: Mid March 2026 (scheduled)
    *Wait for further announcements with detailed schedules.

Yahoo! JAPAN Ads API v15 will end with the following schedule:

  • End of life date: November 26, 2025
    *Support for this version has already ended.

Developer Center

Related sites: