Oct 17, 2025

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

Updates
October 17, 2025: We released the new runtime (V202510).
September 17, 2025: We announced this information.

Product

Yahoo! JAPAN Ads Search Ads
Yahoo! JAPAN Ads Display Ads

New runtime (V202510) release
Date
October 16, 2025

Summary
To improve convenience released 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 took 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
Change the behavior of the ReportDefinitionService during add and getReportFields operations 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

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

Display Ads
Add portfolio bidding
We added portfolio bidding. Learn more in the following announcement.

Services

BiddingStrategyService
CampaignService
ReportDefinitionService
CampaignBudgetService

Change

Add 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.
Added new CampaignBudgetService.

End of search keyword targeting
We 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.

In-stream ads
We support "Yahoo! JAPAN Ads Display Ads (Auction) In-stream ads."
Learn more in the following announcement.

Services

CampaignService
AdGroupService
AdGroupAdService
AdGroupTargetService
StatsService

Change

Campaign delivery type: Add PRIVATE_MARKET_PLACE
- CampaignService/get,add
  Add to campaignDeliveryType
- * You cannot create a campaign with PRIVATE_MARKET_PLACE.
- *The preceding will also be returned for v15 to v17.
Device Type: Add CONNECTED_TV
- Services
  - AdGroupService
  - AdGroupTargetService
  - StatsService
Ad Type: Add INSTREAM_AD
- AdGroupAdService
  *You can’t create in-stream ads.
Campaigns with a campaign delivery type PRIVATE_MARKET_PLACE, and ad groups and ads under it, cannot be created, edited, or apply targeting.
You also cannot do the following for PRIVATE_MARKET_PLACE campaigns:
- CampaignService/add,set
- AdGroupService/add,set
- AdGroupAdService/add,set
- AdGroupTargetService/add,set,replace
Added report field values.
- DEVICE：Connected TV
- SPECIAL_PRODUCT_TYPE：Private market place
Added report field.
- DEAL_TYPE: Product type

Add an audience range feature to the audience list (advanced segments)
We support audience range feature to the audience list (advanced segments).
Learn more in the following announcement.

Services
AudienceListService
Change

Add "audienceRange" to advancedSegmentsAudienceList in AudienceListService.
- request
  - add, set
    Add audienceRange to advancedSegmentsAudienceList
- response
  - get, add, set, remove
    Add audienceRange to advancedSegmentsAudienceList

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."

Add SKAdNetwork items in various list views
We added features to SKAdNetwork. The values of the added report fields will be available after the launch date (October 29, 2025).
Learn more in the following announcement.

Change

Add fields that can be specified for each report type.
- App report
- Audience list targeting report
- Content keyword targeting
- Placement targeting

Maintenance

We 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.

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).

Back to Information List