Yahoo! JAPAN Ads API | Developer Center

2020/02/20

Yahoo! Ads API official version released

Document Number: APIE-FY19-2096

Dear customer,

Thank you for using Yahoo! Ads.

Yahoo! Ads API official version has been released, as previously
announced in "Yahoo! Ads API official version release (Document Number :
APIE-FY19-2071)."
Yahoo! JAPAN Promotional Ads API is closing as planned. Please see the
following details.

Once again, thank you for using Yahoo! Ads.

1. Yahoo! Ads API official version release:

　1-1. Service:
　　Yahoo! Ads Search Ads API
　　Yahoo! Ads Display Ads API

　1-2. Version released:
　　v1

　1-3. Release date:
　　February 20, 2020 (Thu) JST

　1-4. How to start using:
　　If you are using Yahoo! Ads API Beta version, you don't need
　　application to use the official version.
　　You can start using Yahoo! Ads API official version.

2. Major new features on Yahoo! Ads API official version:
　The following new features are updates from Yahoo! Ads API beta version.

　[Search Ads API]
　　- Import feature for offline conversions
　　　With this feature the conversion data that occurred outside of the
　　　website will be imported to the Campaign Management Tool using
　　　"YCLID", a parameter that identifies who clicked the ad.
　　　
　　　This was released in November 2019 on the Campaign Management Tool.
　　　See the following announcement for the details.
　　　Offline conversion import feature release
　　　https://promotionalads.yahoo.co.jp/support/release/773324.html#article_en

　　- Enhancement for Extended Text Ads
　　　Added the following fields to "ExtendedTextAd" of AdGroupAdService
　　　due to the enhancement of Extended Text Ads scheduled in Spring 2020.
　　　　headline3 (Title3)
　　　　description2 (Description2)

　　- Change of ReportDefinitionService
　　　Specifying the value of "1" to "5" for "sortFields" of the
　　　ReportDefinition object became available.
　　　The following item is added to the report field as well.
　　　　ACCOUNT_ID (account ID)
　　　　ACCOUNT_NAME (account name)

　[Display Ads (Auction)]
　　- 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.
　　　
　　- Operation history
　　　The new service "AuditLogService" for acquiring operation history
　　　data became available.

　　- Migration of YDN campaigns to the campaigns of Display Ads (Auction)
　　　The new service CampaignMigrationService for migrating existing
　　　campaigns of Display Ads (YDN) to the new Display Ads (Auction)
　　　format campaigns.
　　　Please refer to the following release note for further details
　　　including maintenance release.Note
　　　https://ads-developers.yahoo.co.jp/developercenter/en/developers-guide/release-note.html

　　Please also refer the following reference documents.
　　- Search Ads API
　　https://yahoojp-marketing.github.io/ads-search-api-documents/
　　- Display Ads API
　　https://yahoojp-marketing.github.io/ads-display-api-documents/

3. Closing Yahoo! JAPAN Promotional Ads API:
　Yahoo! JAPAN Promotional Ads API sunset is scheduled as follows.　
　*Schedule may change without prior notice.

　[Sponsored Search API]
　　- Deprecation Date
　　　V201901 : February 27, 2020 (Thu)
　　　V201909 : June 30, 2020 (Tue)
　　- End of Life Date
　　　V201901 and V201909 : September 30, 2020 (Wed)

　[YDN API]
　　- Deprecation Date
　　　V201907 : March 25, 2020 (Wed)
　　　V201911 : June 30, 2020 (Tue)
　　- End of Life Date
　　　V201907 and V201911 : December 16, 2020 (Wed)

If you have any questions, please contact us.

Sincerely,
Yahoo! JAPAN API support team