Yahoo! JAPAN Ads API | Developer Center

Display Ads API v1 Release Note

Release version

v1

Effective Date

February 20, 2020 (Thu)

Main Contents of this Release

*More about objects and other details are described on the Reference document.
Following feature enhancements were released with the official release of Yahoo! JAPAN Ads Display Ads API.

1. Performance value of the day on reports

ReportDefinitionService has a new data item "TODAY" for today.
You will be able to get the today's data by specifying today's date on "startDate/endDate" or specifying "TODAY" on "dataRangeType."

Service that covers this feature
ReportDefinitionService

2. Operation history supported

The new service AuditLogService for acquiring operation history data is now available.

Service that covers this feature
AuditLogService

3. Migration of YDN campaign supported

The new service CampaignMigrationService for migrating existing campaigns of Display Ads (YDN) to the new Display Ads (Auction) format campaigns.

Service that covers this feature
CampaignMigrationService

4. Maximum number of times for uploading Item list of Dynamic ads for display

Added "uploadLimits" field on the get response of FeedService. After this change, upload types, maximum number of times and maximum lines of Item list became available.

Service that covers this feature
FeedService

5. Maintenance Release

Following changes were made.

- Added "accountName" as search criteria of AccountService.
- The type of the following fields changed from "Enum" to "String".
　　"audienceCategoryType" of AdGroupTargetService
　　"audienceCategoryType" of DictionaryService
　　"audienceCategoryType" of StatsService
- Added "startIndex" and "numberResults" fields on the request for "getDisapprovalReason" of DictionaryService to support paging feature on search criteria.
　　startIndex
　　numberResults
- Specifying 1 to 5 on "sortFiedls" of the add request of ReportDefinitionService became available.
It can be specified by using "ReportDefinitionServiceREportSortField" and "ReportDefinitionServiceReportsSortType".
- Added the following fields on the get response of StatsService for the planned feature enhancement.
　　impressionShare
　　budgetImpressionShareLostRate
　　rankImpressionShareLostRate
- Added the "conversionOptimizerTrainingStatus" field on the get response of CampaignService for the planned feature enhancement.

Service that covers this feature
AccountService
AdGroupAdService
AdGroupService
AdGroupTargetService
CampaignService
DictionaryService
ReportDefinitionService
StatsService