Yahoo! JAPAN Ads API | Developer Center
日本語2022/05/17
Yahoo! JAPAN Ads API v8 released
Document Number: APIE-FY22-2224
Dear customers,
Thank you for using Yahoo! JAPAN Ads.
We have released Yahoo! JAPAN Ads API new version, as previously
announced in "Yahoo! JAPAN Ads API v8 release (Document Number:
APIE-FY22-2204)." Please see the following details.
1. Product:
Yahoo! JAPAN Ads Search Ads API
Yahoo! JAPAN Ads Display Ads API
2. Version released:
v8
3. Date:
May 16, 2022 (Mon)
4. Changes on Search Ads API:
■Adding features on Responsive Ads for Search
We added the Ad Customizer output actual performance values by
each asset on the performance report on Responsive Ads for Search.
It will be available around the summer of 2022.
See the following release note for more detail.
[Search Ads] Adding features on Responsive Ads for Search and end of adding ads of Extended Text Ads
■New conversion tracking purpose (v7, v8)
The new conversion tracking purpose became compatible with all
conversions such as web pages. It will be available on May 18th,
2022 (Wed). See the following release note for more detail.
[Search Ads] New conversion tracking purpose and reports
■The new option will become available for the duration of the report
creation
The new option "This Month (excluding today)" became available for
the duration of report creation.
■Search Ads Dynamic Ads for Search new page feed
We started Dynamic Ads for Search page feed in a new format on
Search Ads. It will be available around July 2022. See the
following the release note for more detail.
[Search Ads] Dynamic Ads for Search New page feed
The FeedService and PageFeedItemService provided in v7 and earlier
versions will be discontinued in September 2022.
5. Changes on Display Ads API:
■Geo targeting enhancement
Target radius became available to specify the target location on
geo targeting feature.
*These changes were provided on the Campaign Management Tool in
advance. See the following release note for more detail.
[Display Ads (Auction)] Geo Targeting enhancement
■Provision of Display Ads (Guaranteed) to agencies prepaid
Along with the provision of Display Ads (Guaranteed) to agencies
prepaid, the field to indicate estimated cash balance, etc. were
added.
■Change of age targeting features
The definition of adult age changed to "18 years old." Along with
this change, we changed some of the age groups in age targeting.
*These changes were provided on the Campaign Management Tool in
advance. See the following release note for more detail.
[Display Ads] Change of Age Targeting features
■Attribution model comparison report
The attribution model comparison report which provides
visibility to the credits of campaigns and ad groups that have
contacted users to conversions that occur under your account were
added.
*These changes were provided on the Campaign Management Tool in
advance. See the following release note for more detail.
Attribution model comparison report starts
■A new user list will be available for some Display Ads
(Guaranteed) products
A new user list is available for the audience list targeting for some
Display Ads (Guaranteed) products.
■Reporting duration expands for performance data
We added the new duration to the performance report and changed
the behavior of the existing duration.
The duration that can be specified has been changed from the
past 25 months to the past 37 months.
■Changing the period of the performance data
The period for the performance data selected in the Campaign
Management Tool has been extended to 25 months in the past.
Along with this change, we changed the duration of performance
data on ConversionTrackerService and StatsService.
■Maintenance release
System updates have been made for the following services.
・Fields that are not currently used have been removed from
StatsService.
・NOT_IN will be added to filterOperator of
ReportDefinitionService.
・An error OVER_COUNT_ERROR was added to AuditLogServiceJobStatus.
6. Changes on the client library for Java users:
"API Client Implementation" and "Service Layer Implementation"
have been added to the library including request and response
entities of Yahoo! JAPAN Ads API published for Java users.
This eliminates the need for users to manage tokens and API
requests, which previously had to be implemented on the user side,
and enables more efficient development of services using Yahoo!
JAPAN Ads API.
Learn more details on the following pages.
https://github.com/yahoojp-marketing/ads-display-api-java-lib
https://github.com/yahoojp-marketing/ads-search-api-java-lib
There is also an example of actually using the sample program as
follows.
https://github.com/yahoojp-marketing/ads-display-api-java-samples
https://github.com/yahoojp-marketing/ads-search-api-java-samples
7. Remarks:
・More details are available on the release note and reference
document.
- Search Ads API
https://ads-developers.yahoo.co.jp/developercenter/en/developers-guide/ysa-v8.html
- Display Ads API
https://ads-developers.yahoo.co.jp/developercenter/en/developers-guide/yda-v8.html
- Reference
https://ads-developers.yahoo.co.jp/reference/en/
・We will hold an online seminar to give an overview of v8. We will
make another announcement for the detail.
8. Yahoo! JAPAN Ads API v6 Sunset:
Yahoo! JAPAN Ads API v6 sunset is scheduled as follows.
Deprecation date: June 8, 2022 (Wed)
End of life date: September 13, 2022 (Tue)
Yahoo! JAPAN Ads API v5 will also end on the following scheduled
date as previously announced in "Yahoo! JAPAN Ads API v7 released
(Document Number: APIE-FY21-2312)."
End of life date: June 8, 2022 (Wed)
*We have ended the user support for this version already.
If you have any questions, please contact us.
Sincerely,
Yahoo! JAPAN Ads API support team