Sep 17, 2025

Yahoo! JAPAN Ads Script has new features and closes the previous version

Product
  • Yahoo! JAPAN Ads Search Ads
  • Yahoo! JAPAN Ads Display Ads
New runtime (V202510) release
Schedule

October 16, 2025
*This date is subject to change.

Summary

To improve convenience we will release a new runtime (V202510) for Yahoo! JAPAN Ads Script. The latest runtime will automatically update the script you are using. If the system can't update the script, it sends an email to the Yahoo! JAPAN Business ID that last approved the current script. You can select the runtime version on your side, but we recommend using the latest version. The main feature improvements in this version are as follows:

Search Ads
Additional measures following the end of the autobidding type “Enhanced CPC”

We will take additional measures in response to the end of the autobidding type “Enhanced CPC.”
Find more details, in this announcement.


Services
  • CampaignService
  • ReportDefinitionService
Change

・CampaignService
Remove the cpcBiddingScheme from CampaignService.

・ReportDefinitionService
The behavior of the ReportDefinitionService during add and getReportFields operations will be changed as follows. There are no changes to the interface.

■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
Specifying radiuses will be available in geo targeting

In campaign geo targeting, define the target area by specifying a target point and its radius. Find more details, in this announcement.

Services
CampaignTargetService


Change
Add the following radius specification field to the CampaignTargetService (add/get/set/remove).
  • Add radiusTarget under target
  • Add RADIUS to targetType
Display Ads End of search keyword targeting

We will support the following services due to the end of search keyword targeting. Learn more in the following announcement.

Services
  • AdGroupTargetService
  • StatsService
  • SearchKeywordIdeaService
  • SearchKeywordListService
Change
  • Remove targetType "SEARCH_TARGET" from AdGroupTargetService, StatsService.
  • Remove the endpoints of SearchKeywordIdeaService, SearchKeywordListService.
IF change in reporting API

Change the specification when the report is retrieved and requires that the report be displayed in Japanese or English.

Services

ReportDefinitionService/getReportFields

Change
  • request
    • Add the report item “lang.” Specifying JA or EN is required.
  • response
    • Add the report item "displayFieldName."
    • End report items “displayFieldNameJa” and “displayFieldNameEn.”
Maintenance
Display Ads
  • We will limit the number of offline conversions to 200 and end sorting, based on system load and sorting feature usage.
    • Services
      • OfflineConversionService/get
    • Change
      • Change OfflineConversionService/get as follows.
        • numberResults
          • default: 500 → 100
          • max: 1000 → 200
        • sorts
          • Because the service will end, specifying the sort it is no longer available, and it will be sorted by ID.

  • Review the error outside the BudgetOrderService budget setting range.
    The BudgetOrderService/set for search and display ads had differences in error codes that were outside the budgeted values. We will unify the error codes for both.
    • Services
      • BudgetOrderService/set
    • Change
      • Fix error code outside budget setting value from F0001 to V0001 when BudgetOrderService/set in display-ads-api. Note that when V202510 is released, it will be applied to all versions.

  • Add new services or add fields to existing services to support upcoming new bidding features. These services and fields will not be available until the official feature release. Details of the feature will be announced later.
    • Services
      • BiddingStrategyService
      • CampaignService
      • ReportDefinitionService
    • Change
      • Add a new BiddingStrategyService.
        • get
        • add
        • set
        • remove
      • CampaignService
        • request
          • get
            Add portfolioBiddingIds.
          • add, set
            Add biddingStrategyConfiguration/portfolioBiddingId.
        • response
          • Add biddingStrategyConfiguration/portfolioBiddingId.
          • Add biddingStrategyConfiguration/portfolioBiddingName.
      • ReportDefinitionService
        • Add PORTFOLIO_BIDDING to the reportType.
End of previous runtime
Schedule

November 5, 2025
*This date is subject to change.

Summary

With the release of the new runtime version, we will close the previous runtime version (V202501).