Yahoo! JAPAN Ads API | Developer Center

日本語

Yahoo! JAPAN Ads API Display Ads API v19

Version released
v19

Date
February 25, 2026

Key points of this release

*Learn more about objects and other details in the Reference.

Changes due to expanded tracking tag availability

With tracking tag issuance and management in Business Manager and support for LINE official accounts, we made the following changes.
See the following announcement for details.
Display Ads: Impact of expanding the availability of tracking tags

Services

  • TrackingTagService
  • AudienceListService
  • ConversionTrackerService

Change

  • Added a new service "TrackingTagService" (get) to get tracking tags.
  • AudienceListService
    Added trackingTagId to the websiteVisitorsAudienceList that will be used in get, add, set, and remove.
  • ConversionTrackerService
    • Changed conversionTrackerTypes from LY_TAG_CONVERSION to TRACKING_TAG_CONVERSION.
    • Renamed lyTagConversion to trackingTagConversion.
    • Added trackingTagId to trackingTagConversion (previously lyTagConversion).

Optional logo image setting for carousel ads

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

Added "isRemoveLogoMediaId" to AdGroupAdService to remove logo images.

Partial changes to the placement list create/edit view (from v18)

From v18, we supported partial changes to the placement list create/edit view.
This is a reminder about the feature that became available in v18 as of December 17, 2025. See the following announcement.
Display Ads (Auction): Changes to placement list create and edit views

Services

PlacementUrlIdeaService

Change

  • Added the following fields to responses when getting placement URL candidates:
    reaches: total reach across all devices
    adRequests: total ad requests across all devices
  • The following fields are scheduled for removal on April 1, 2026. Use the preceding new fields instead.
    desktopReaches: reaches per PC
    desktopAdRequests: ad requests per PC
    smartPhoneReaches: reaches per smartphone
    smartPhoneAdRequests: ad requests per smartphone
    tabletReaches: reaches per tablet
    tabletAdRequests: ad requests per tablet

Support for integration with "Airbridge" tracking tool

Airbridge is now available as a tracking tool for tracking app conversions. See the following announcement.
Display Ads: Launch of integration with the ad tracking tool "Airbridge"

Services

  • AppLinkService
  • AudienceListService
  • CampaignService

Change

  • You can now specify "AIRBRIDGE" in the "appVendor" field of AppLinkService.
  • Added "AIRBRIDGE" to the "appVendor" field returned in the AudienceListService response.
  • You can now specify "AIRBRIDGE" in the "vendorName" field of CampaignService.

Support for renaming shared audience lists

Before the integration of LY Ads, we renamed the shared audience lists used in audience list targeting. See the following announcement.
共通オーディエンス「ヤフー提供」名称変更のお知らせ (Renaming of list name for shared audience "Offered by Yahoo! JAPAN") - available in Japanese

Services

  • AdGroupTargetService
  • AudienceListService

Change

Changed the following list type names in the "audienceListType" field of the services.

Before After
OFFERED_BY_YAHOO_JAPAN OFFERED_BY_LY_SHARED_AUDIENCE

Support for app conversion-related metrics

We now support app conversion-related metrics provided by partner tracking tools. Actual metrics will become available on or after the schedule of this feature. See the following announcement.
Display Ads (Auction): Adding numerical metrics related to app conversions

Services

StatsService

Change

Added the following items.

XML attributes Name
installs Installs
costPerInstall Cost per install
conversionsAfterInstall Conversions after install
cpaAfterInstall CPA after install
convValueAfterInstall Conversion value after install
convValueAfterInstallPerCost Conversion value after install/cost
allConversionsAfterInstall Conversions after install (all)
allConvValueAfterInstall Conversion value after install (all)
installsViaClick Installs (click)
costPerInstallViaClick Cost per install (click)
conversionsAfterInstallViaClick Conversions after install (click)
cpaAfterInstallViaClick CPA after install (click)
convValueAfterInstallViaClick Conversion value after install (click)
convValueViaClickAfterInstallPerCost Conversion value (click) after install/cost
allConversionsAfterInstallViaClick Conversions after install (click) (all)
allConvValueAfterInstallViaClick Conversion value after install (click) (all)

Support for the platform integration of "LY Ads Display Ads"

To support the upcoming platform integration of "LY Ads Display Ads," we have updated the following features.

Services

  • CampaignService
  • AdGroupService
  • AdGroupAdService
  • AdGroupTargetService
  • VideoService
  • MediaService
  • PlacementUrlListService
  • AudienceListService

Change

  • We added an error message to the service to inform users that updates are not available during the migration.
    Error message: Update or remove operations are not allowed during migration.
  • For AudienceListService, we added the following AudienceListType and AudienceList object. These cannot be specified in add or set operations.
    AudienceListType: MIGRATED_LINE_AUDIENCE
    Object name: migratedLineAudienceList
  • When updating AudienceListService, if the source list type is a similar audience list, we added an error message to inform users that similar expansion is not available in Display Ads.
    Error message: Cannot create similarity list based on lookalike audience.

Support for Display Ads (Guaranteed) LINE Talk Head View Premium

You can now search for and retrieve LINE Talk Head View Premium ads.
*LINE Talk Head View Premium is available only to specific customers.

Services

GuaranteedAdGroupAdService/get

Change

  • Added "TALK_HEAD_VIEW_PREMIUM" to GuaranteedAdGroupAdServiceAdType.
  • Added "talkHeadViewPremium" to GuaranteedAdGroupAdServiceAd.

Maintenance

  • StatsService: image and video statistics are no longer 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, is also no longer available in the Yahoo! JAPAN Ads API.
    *This change applies to all supported versions, including v19.
    Services
    StatsService/get
    Change
    Remove the following items from type.
    IMAGE
    VIDEO

  • AudienceListService/get: added 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: added "Generate leads" as a conversion tracking purpose. Statistical values are now returned as decimal values.
    Services
    ConversionTrackerService/get,add,set
    Change
    • Added "GENERATE_LEADS" to category in ConversionTrackerService/get, add, and set.
    • Statistical values are now returned in decimal format.

  • For Dynamic Display Ads, you can now specify the language when downloading an error file for a product list.
    Services
    FeedDataService/downloadErrorFile
    Change
    Added the "lang" field. You can now specify Japanese or English as the language of the downloaded file.

Differences between v18 and v19 IF

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

End of Yahoo! JAPAN Ads API v17

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

  • Support end date: March 17, 2026
  • End of life date: July 28, 2026

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

  • End of life date: March 17, 2026
    *Support for this version has already ended.

Developer Center

Related sites: