Yahoo! JAPAN Ads API | Developer Center

2023/02/17

Display Ads Changes on ad type names and additional items

Update

Februrary 17, 2023: Updated this information including the modification of change history after the release.
Februrary 8, 2023: Announced this information.

Product

Yahoo! JAPAN Ads Display Ads (Auction)
Yahoo! JAPAN Ads Display Ads (Guaranteed) *Available for limited customers.

Date

February 16, 2023 (Thu)

Overview

We made changes on "ad type" that indicates the type of ads on Display Ads.
These changes are for the future increases in ad types and efficiency on the advertising operation.

Specifically, the ad type names currently being used are displayed in the "Ad type (prev)" after the release date. The new ad type is then displayed in the "Ad type" field.
In addition, we added a new item "main media format."
This field indicates the type of media format such as video or image on the ad of Display Ads.

See the following table for the previous and new on this change.

Products	Before the change	After
Products	Ad type (prev)　 *Indicated in the "Ad type" column before the change release.	Ad type	Main media format
Display Ads (Auction)	Banner (image)	Banner	Image
Display Ads (Auction)	Banner (video)	Banner	Video
Display Ads (Auction)	Responsive Ads (image)	Responsive	Image
Display Ads (Auction)	Responsive video	Responsive	Video
Display Ads (Auction)	Dynamic Ads for Display	Dynamic Ads for Display	-
Display Ads (Auction and Guaranteed)	Carousel	Carousel	Image
Display Ads (Guaranteed)	In-stream ads	In-stream ads	Video
Display Ads (Guaranteed)	Brand Panel Quintuple	Brand Panel Quintuple	Image
Display Ads (Guaranteed)	Brand Panel Quintuple Video	Brand Panel Quintuple	Video
Display Ads (Guaranteed)	Brand Panel Panorama	Brand Panel Panorama	Image
Display Ads (Guaranteed)	Brand Panel Panorama Video	Brand Panel Panorama	Video
Display Ads (Guaranteed)	Top Impact Square	Top Impact Square	Image
Display Ads (Guaranteed)	Top Impact Square Video	Top Impact Square	Video
Display Ads (Guaranteed)	Top Impact Quintuple	Top Impact Quintuple	Image
Display Ads (Guaranteed)	Top Impact Quintuple Video	Top Impact Quintuple	Video
Display Ads (Guaranteed)	Top Impact Panorama	Top Impact Panorama	Image
Display Ads (Guaranteed)	Top Impact Panorama Video	Top Impact Panorama	Video
Display Ads (Guaranteed)	Top Impact Prime Display Double	Top Impact Prime Display Double	Image
Display Ads (Guaranteed)	Top Impact Prime Display Double Video	Top Impact Prime Display Double	Video
Display Ads (Guaranteed)	Top Impact Panorama Side Vision (Video)	Top Impact Panorama Side Vision	Video
Display Ads (Guaranteed)	Top Impact Panorama Side Switch (Video)	Top Impact Panorama Side Switch	Video
Display Ads (Guaranteed)	Top Impact Theater Video	Top Impact Theater	Video
Display Ads (Guaranteed)	Brand Panel Panorama Panel-switch	Brand Panel Panorama Panel-switch	Image
Display Ads (Guaranteed)	Top Impact Panorama Panel-switch	Top Impact Panorama Panel-switch	Image
Display Ads (Auction)	"Text (description 19-19)"	Text	-

The new ad type will appear on the views of Create/Edit ads and Ad list on the Campaign Management Tool after the release date.
The field "Ad type (prev)" is also displayed on the Ad list view and on the performance report.
The specifications of the CSV file for importing will change according to this change.

Precaution

・"Ad type (prev)" will be removed in the future. Please wait for further announcements regarding details.

・The import CSV files downloaded before the release date can't be used after the release date. Please download and use the new import file.

Remarks

The change history (operation history) was changed to the format after the implementation date, with the addition of a "Main Media Format" item on Monday, February 13, 2023. The Campaign Editor will also be available on February 20, 2023.
*The date is subject to change.

Impact on Display Ads API:

Yahoo! JAPAN Ads Display Ads API supports this change as follows.

・Version name v10

・Schedule: February 14, 2023 (Tue)
　*The date is subject to change.

Changes are as follows.

Service name	Changes
AdGroupAdService	Change AdType to the following: ・BANNER_AD ・CAROUSEL_AD ・DYNAMIC_DISPLAY_AD ・RESPONSIVE_AD ・TEXT_AD
	Add mainMediaFormat field in parallel position with AdType as the main media format. Followings can be specified for ENUM values: ・NONE ・IMAGE ・VIDEO
	Merge the classes representing ad details and change them to the followings: ・Merge bannerImageAd and bannerVideoAd, and change to bannerAd ・Merge responsiveImageAd and responsiveVideoAd, and change to responsiveAd ・Rename dynamicAd to dynamicDisplayAd
GuaranteedAdGroupAdService	Change AdType to the following: ・BANNER_AD ・CAROUSEL_AD ・INSTREAM_AD ・BRANDPANEL_QUINTIE ・BRANDPANEL_PANORAMA ・BRANDPANEL_PANORAMA_PANEL_SWITCH ・TOP_IMPACT_SQUARE ・TOP_IMPACT_QUINTIE ・TOP_IMPACT_THEATER ・TOP_IMPACT_PRIME_DISPLAY_DOUBLE ・TOP_IMPACT_PANORAMA ・TOP_IMPACT_PANORAMA_SIDE_VISION ・TOP_IMPACT_PANORAMA_SIDE_SWITCH ・TOP_IMPACT_PANORAMA_PANEL_SWITCH
	Add mainMediaFormat field in parallel position with AdType as the main media format. Followings can be specified for ENUM values: ・IMAGE ・VIDEO
	Merge the classes representing ad details and change them to the followings: ・bannerAd ・carouselAd ・instreamAd ・brandPanelQuintie ・brandPanelPanorama ・brandPanelPanoramaPanelSwitch ・topImpactSquare ・topImpactQuintie ・topImpactTheater ・topImpactPrimeDisplayDouble ・topImpactPanorama ・topImpactPanoramaSideVision ・topImpactPanoramaSideSwitch ・topImpactPanoramaPanelSwitch
ReportDefinitionService	New AdType will be available for output as a report item.
AuditLogService	Add mainMediaFormat (main media format) as a download file item in change history. Change the order of items in the download file. *Check the details on the reference document after v10 release date.

*Versions prior to v9 can continue to operate in the previous format. Also, there are no changes to the change history items, etc.

Developer Center

Related sites: