Jan 27, 2026

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 (V202602) release
Schedule
February 26, 2026
*This date is subject to change.

Summary
To improve convenience we will release a new runtime (V202602) 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 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
Add age and gender targeting and rename target lists
We will add targeting by age and gender.
We will rename “Target list” to “Audience list” in Search Ads.
See the following for details.
Search Ads: Add an age and gender targeting feature and rename target lists
Services
[Rename target lists]
  • AudienceListService (previously RetargetingListService)
  • AdGroupAudienceListService (previously AdGroupRetargetingListService)
  • CampaignAudienceListService (previously CampaignRetargetingListService)
[Age and gender targeting]
  • AudienceListService (previously RetargetingListService)
  • AdGroupAudienceListService (previously AdGroupRetargetingListService)
  • CampaignAudienceListService (previously CampaignRetargetingListService)
  • ReportDefinitionService
Change
[Rename target lists]
  • We will rename the following services (the following descriptions use the new names):
    “RetargetingListService” → “AudienceListService”
    “AdGroupRetargetingListService” → “AdGroupAudienceListService”
    “CampaignRetargetingListService” → “CampaignAudienceListService”
[Age and gender targeting]
*This feature is available for some users. If the feature is not available to a user, AudienceListService/getDemographic returns an empty response. The detailed offering conditions are not disclosed.
  • AudienceListService/getDemographic
    You can select audience lists (previously target lists) by age and gender.
  • AdGroupAudienceListService.get, add, set
    We will add a flag under criterionUserList to indicate whether the audience list (previously target list) is for a specific age or gender.
  • CampaignAudienceListService.add
    When you try to add age- or gender-based audience lists (previously target lists), “Invalid value” is returned.
  • ReportDefinitionService.get, add, remove, getReportFields
    You can specify “Target audience” (field name: TARGET_ALL).
Add business name assets
We will add new “Business name asset” to ad display assets.
See the following for details.
Search Ads: Adding Business name assets
Services
  • AccountAssetService (new)
  • AssetService
  • CampaignAssetService
  • ReportDefinitionService
  • CampaignExportService
  • AuditLogService
Change
  • Add the new web service “AccountAssetService.”
  • AssetService.get, add, set, remove
    Add “BUSINESS_NAME” to assetData/type.
  • CampaignAssetService.get, replace, set
    Add “BUSINESS_NAME” to type.
  • ReportDefinitionService.get, add, remove
    Add “ACCOUNT_ASSET to reportType.”
  • CampaignExportService.add
    Add “BUSINESS_NAME_ASSET” to entityTypes.
  • AuditLogService.get, add
    Add “ACCOUNT_ASSET” to entityType.
Add a new report metric “Click share”
We will add a new report metric “Click share.”
See the following for details.
Search Ads: Adding new report metric "Click share"
Services
  • ReportDefinitionService
Change
  • ReportDefinitionService.get, add, remove, getReportFields
    You can specify “Click share” (field name: SEARCH_CLICK_SHARE).

  • Display Ads
    Changes due to expanded tracking tag availability
    With tracking tag issuance and management in Business Manager and support for LINE official accounts, we will make the following changes.
    See the following announcement for details.
    Display Ads: Impact of expanding the availability of tracking tags
    Services
    • AudienceListService
    • ConversionTrackerService
    Change
    • AudienceListService
      Add trackingTagId to the websiteVisitorsAudienceList that will be used in get, add, set, and remove.
    • ConversionTrackerService
      • Change conversionTrackerTypes from LY_TAG_CONVERSION to TRACKING_TAG_CONVERSION.
      • Rename lyTagConversion to trackingTagConversion.
      • Add trackingTagId to trackingTagConversion (previously TagConversion).
    Optional logo image setting for carousel ads
    We will update carousel ads to make logo image settings optional.
    See the following announcement for details.
    Display Ads: Logo image for carousel ads becomes optional
    Services
    • AdGroupAdService
    Change
    • Add “isRemoveLogoMediaId” to AdGroupAdService to remove logo images.
    Maintenance
    • StatsService: image and video statistics will no longer be available. Based on your usage status, the "Performance data check feature for the image and video list view," which has been discontinued in the Campaign Management Tool, will also no longer be available in the Yahoo! JAPAN Ads Script.
      *This change applies to all supported versions, including v202602.
      Services
      StatsService.get
      Change
      Remove the following items from type.
      IMAGE
      VIDEO
    • AudienceListService/get: add an option to get detailed settings.
      Services
      AudienceListService.get
      Change
      Add a flag called includeDetail to get details. By setting this flag to "True," you can get the detailed settings.
    • ConversionTrackerService: add “Generate leads” as a conversion tracking purpose.
      Services
      ConversionTrackerService.get, add, set
      Change
      We will add “GENERATE_LEADS” (Generate leads) to category in ConversionTrackerService/get, add, and set.
    End of previous runtime
    Schedule
    March 10, 2026
    *This date is subject to change.
    Summary
    With the release of the new runtime version, we will close the previous runtime version (V202503).