Developer Center (English) > Announcement > YDN API V201812 released



YDN API V201812 released

Document Number: APIE-FY18-2016

Dear customer,

Thank you for using Yahoo! JAPAN Promotional Ads.

YDN API new version has released, as previously announced in
"YDN API V201812 release (Document Number: APIE-FY18-1987)".
Please see below for details.

Once again, thank you for using Yahoo! JAPAN Promotional Ads.

1. Product:
 - YDN API Sandbox
 - YDN API Production

2. Version released:
 V201812 (WSDL version: V201812)

3. Effective date:
 December 5, 2018 (Wed) JST

4. Overview:
 Following changes are made on the new version.

 4-1. Tracking video conversions
 Tracking the number of conversions occurred other than from ad
 clicks after viewing video ads for more than 10 seconds in
 Yahoo! JAPAN Display Ad Network (YDN) became available.
 Changes on the V201812 release are as follows.

 (1) Change in conversion related indexes on performance data
  and reports
  Following services are changed in conversion related indexes.

 (1)-1. The 'conversion' definition on conversion related indexes
  was expanded.
  Conversions of users who visited the website from ad clicks.
  Conversions of users who (a)visited the website from ad clicks
  or (b)viewed the video ad for more than 10 seconds and then
  visited the website other than by clicking on the ad.
  *For videos less than 10 seconds, viewing the full ad will be
  worth viewing 10 seconds.

 (1)-2. New tracking indexes
  - Counts of conversions by ad click before visiting the website
  - Counts of conversions across devices

 (2) Adding Video Beacon URL related items
  New items related to Video Beacon URL to measure video
  conversions became available on AdGroupService.
  The indexes are added to the download file of AuditLogService
  and BulkService.
  *All API versions will have impact of this change on download file.

 (3) New item to conversion tag setting
  A new index 'measurementPeriodView' to specify the tracking
  period from video view to conversion is added to
  The tracking period can be set within 1 - 30 days.
  The index is added to download file of AuditLogService.
  *All API versions will have impact of this change on download file.

 4-2. New format (aspect ratio 1:1) in YDN video ads
 A new format (aspect ratio 1:1, pixel size 600×600) has been
 added, as previously announced in "New format (aspect ratio 1:1)
 in YDN video ads (Document Number: APIE-FY18-1999)".
 *All API versions will have impact of this maintenance.

 4-3. Search targeting enhancement
 The following changes are made on Search Targeting.

 (1) Following changes made on SearchKeywordIdeaService request.
  - Keywords and keywordsIds became optional and specifying
  both at once are unavailable.
  - The upper limit of keywords are changed from 100 to 200.
  - A space character (half-width and full-width) became
  - Following items are added.
   sortField (sort field)
   sortType (sort type)
   matchType (match type)

 (2) Adding 'releaseDate' (the date keyword added) on the
  response of SearchKeywordIdeaService.

 4-4. System updates
 System maintenance has been completed on YDN API.

 Old report items were eliminated from ReportDefinitionService
 and ReportService for system maintenance purpose.

 "動作区分/Behavior Type" column has been added to the reporting
 fields on the document.
 "動作区分/Behavior Type" which describes the action of each
 reporting field has been added.
 Please refer the document for more details.
 *All API versions will have impact of this maintenance.

5. Remarks:
 - Please contact your sales representative about the details of
 video ads.
 - See the following page for more information.
 Release note
 - The API document of Sponsored Search API V201812 is available:
 API document

6. Sunset schedule of YDN API V201806:
 YDN API V201806 sunset is scheduled as follows.
 -Deprecation Date : January 15, 2019 (Tue)
 -End of Life Date : April 15, 2019 (Mon)

If you have any questions, please contact us.

Yahoo! JAPAN API support team

Text ends here Top of page