releasenotes.md

Release Notes

Release version　　

6.0 (WSDL version: 6.0)

Type of Version up　　

Major version up

Main Contents of this Release

※Target Data Objects and Enumerations are referable on the list of Data Objects (Enumerations).

1. Addition of Video Ads function

The feature of Video Ads which supports adding video ads creative and aggregating stats of video ads are available.

Target Web Service

• VideoService
• AdGroupService
• AdGroupAdService
• CampaignService
• MediaService
• StatsService
• BulkService

2. Support collaboration with Yahoo! JAPAN DMP

Creating/editing 'Custom Audience List' on Yahoo! JAPAN DMP are supported.
※Using this feature requires a conclusion of Yahoo! JAPAN DMP contract.

Target Web Service

• RetargetingListService

3. Maintenance Release

Some of Web Services will have maintenance release.
Details of maintenance on each target web service is available on the 'Impacts on each Version from the change of Services'.

Target Web Service

• StatsService
• AccountAdProductService
• AuditLogService
• AdGroupTargetService
• AdGroupService
• AccountService
• ReportDefinitionService

Impacts on each Version from the change of Services

Service	Ver.5.4 and before	Ver.6.0
Addition of Video Ads function
VideoService	Not supported	New service Following objects are added: 　-VideoSelector (retains search conditions (exec parameters) on get method) 　-VideoOperation (retains campaigns to be operated on mutate method) 　-VideoPage (retains the exec results (list of all Entities) of get method) 　-VideoReturnValue (retains exec results (list of all Entities) of mutate method) 　-VideoValues (retains exec results (1 entity) of get/mutate method) 　-VideoRecord (retains video information) 　-VideoSetting (retains video settings) 　-UploadVideo (retains video information to be uploaded) 　-UploadUrlPage (retains exec results (list of all Entities) of getUploadUrl method) 　-UploadUrlValues (stores URL information where video to be uploaded to) 　-UploadUrlValue (retains URL information where video to be uploaded to) 　Following Enums are added: 　-VideoFileType (video file type) 　-VideoApprovalStatus (editorial review status on video) 　-VideoProcessStatus (process status on video) 　Adding error codes for video ads
AdGroupService	No change.	-'ManualCPVAdGruopAdBid' (object to retain CPV bidding information) is added. -'ManualCPVAdGroupBid' is added to inherited on 'bid' of 'AdGroup'.
AdGroupAdService	No change.	- 'VideoAd' (video ads object) is added. - 'ManualCPVAdGruopAdBid' (object to retain CPV bidding information) is added. - 'VideoAd' is added to inherited on 'ad' of 'AdGroup'. - 'ManualCPVAdGruopAdBid' is added to inherited on 'bid' of 'AdGroupAd'.
CampaignService	No change.	- 'MANUAL_CPV' is added to 'biddingStrategyType'. - 'biddingStrategy' of 'Campaign' is changed to 'Ignore' for Add/Set requests.
MediaService	No change.	- 'ThumbnailFlg' (object of video thumbnail image flag) is added. - 'ThumbnailFlg' is added to 'MediaRecord'.
StatsService	No change.	- 'VIDEO' is added to 'StatsType'. - 'MEDIA' of 'StatsType' is changed to 'IMAGE'. - Following items which relate to video ads are added to 'Stats'. 　-autoVideoPlays (Auto Video Plays) 　-clickVideoPlays (Video click plays) 　-videoViewedRate (Video Viewed Rate, i.e. Video plays/Impressions) 　-averageCpv (average CPV) 　-videoPlays (Total video plays) 　-videoViewsTo25 (Video Views to 25%) 　-videoViewsTo50 (Video Views to 50%) 　-videoViewsTo75 (Video Views to 75%) 　-videoViewsTo95 (Video Views to 95%) 　-videoViewsTo100 (Video Views to 100%) 　-averageRateVideoViewed (The average rate of video played, i.e. Average Duration of Video Viewed/Average longest duration of Video Viewed) 　-averageDurationVideoViewed (Average Duration of Video Viewed(sec))
BulkService	No change.	- 'VIDEO' is added to 'EntityType'.
Support Yahoo! JAPAN DMP collaboration
RetargetingListService	Only removing Custom Audience List is available.	- 'CustomAudienceTargetList' (object of Target List to use users' visit/activity history from Yahoo! JAPAN DMP) is added. - 'targetListTypes' of 'RetargetingListSelector' is changed to '0...5'. - 'targetListType' is removed from 'RetargetingListOperation'. - 'accountId' is newly added to 'RetargetingList'. - 'CustomAudienceTargetList' is added to inherited on 'targetList' of 'RetargetingList'. - type of 'reachPeriod' of 'RuleTargetList' is changed to 'int'.
Maintenance Release
StatsService	No change.	- Revised WSDL.
AdGroupTargetService	No change.	- 'searchKeywordListStatus' is deleted from 'SearchTarget'. 'targetListStatus' is deleted from 'SiteRetargetingTarget'. - Following Enums are deleted. 　-TargetListStatus 　-SearchTargetListStatus - Revised WSDL.
AuditLogService	No change.	- Revised WSDL.
AccountAdProductService	No change.	- 'status' is deleted from 'AdProduct'. - 'AdProductStatus' is deleted.
AdGroupService	No change.	- 'NONE' is added to 'SmartDeviceCarrier'.
AccountService	No change.	- 'CANCELED' is added to 'AccountStatus'.
ReportDefinitionService	No change.	- 'ReportFilter' (object to retain filter definition) is added. - 'FilterOperator' (operater to be specified by filter) is added. - 'filterable' is added to 'ReportDefinitionField'. - 'filters' is added to 'ReportDefinition'.

YDN API Reporting document updates

YDN API Reporting document has been updated. See the followings.

• List of Report Fields

Sunset Date of YDN API Ver.5.3

YDN API Ver.5.3 is planned to sunset in July 2017 (JST). The date is to be decided.