Yahoo! JAPAN Ads API v3 released

Document Number: APIE-FY20-2101


Dear customer,

Thank you for using Yahoo! JAPAN Ads.

Yahoo! JAPAN Ads API new version has been released, as previously
announced in "Yahoo! JAPAN Ads API v3 release (Document Number :
APIE-FY20-2091)." Please see the following details.

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


1. Product:
 Yahoo! JAPAN Ads Search Ads API
 Yahoo! JAPAN Ads Display Ads API

2. Version released:
 v3

3. Effective date:
 October 20, 2020 (Tue)

4. Changes on Search Ads API:
 ■Dynamic Ads for Search
  We have added "Entire domain" and "Entire domain and page feed"
  options to specify target webpages for ad delivery on Dynamic Ads
  for Search.
  By selecting the website domain (site top URL), you will be able to
  set all websites under the domain to be eligible for Dynamic Ads
  for Search and save your effort on advertising operation.
  
  See also the following announcement.
  [Search Ads] Dynamic Ads for Search "Entire domain" option official release
  
 ■Maintenance release
  -Supports filtering by creation date for campaigns, ad groups, and ads.
  -The creation date is now returned on getting campaign, ad group, ad.
  -New BudgetOrderService was added to get and update account budget
  information, for a feature enhancement in the future.
  Due to this change, AccountService for get/update account budget
  information became out of support.

5. Changes on Display Ads API:
 ■Importing customers data
  Importing customer's data that you stored for using a custom list for
  ad delivery will become available.

  See also the following announcement.
  [Display Ads] Data importing feature enhancement
  
 ■Cross-campaign Reach report and Conversion Path reportNew reports,
  "Cross-campaign Reach report" and "Conversion Path report", became
  available.
  
  See also the following announcement.
  [Display Ads] New reports release
  
 ■Changes on Site general tag
  Getting site general tag in a new format provided on the Campaign
  Management Tool became available on API.
  
 ■Maintenance release
  -Supports filtering by creation date and time for campaigns,
  ad groups, ads, images, and videos.
  
  -Supports returning the creation date and time on getting campaigns,
  ad groups, ads, images, and videos.

  -New BudgetOrderService was added to get and update account budget
  information, for a feature enhancement in the future.
  Due to this change, AccountService for get/update account budget
  information became out of support.

  -We have added a field to remove values of "brandColor," "prefix"
  and "suffix" of ads on Dynamic Ads for Display.
  
  -We have added mediaRichFormatFlg that describes whether the image
  is for ads of Display Ads (Guaranteed) on "get" response for images.

  -We will add MediaAdFormat on Display Ads (Guaranteed) and will
  change some part of existing MediaAdFormat on November 26, 2020.
  More details are available on the page of Developer Center below.

6. Changes on Search Ads API:
 We have made the following changes as maintenance release of Search Ads API.

 ■Effective date
  October 20, 2020 (Tue)

 ■Effected versions:
  All available versions (v1, v2, v3)

 ■Changes:
  We have ended the following items for Extended text ads.
  - ReportDefinitionService
   TITLE
   DESC
   DESCRIPTION
  - CampaignExportService
   HEADLINE
   DESCRIPTION_ETA
   DESCRIPTION

  After the effective date, the information on the ended items is unavailable.
  See also the following announcement.
  Search Ads API Extended Text Ads enhancement
  
  The number of reject reasons you can get on editorial review increased.
  You can get up to 30 reasons for ads and keywords and you can refer
  those reasons when you request re-review.
   
7. Changes on Display Ads API:
 We will make the following changes as maintenance release of Search Ads API.

 ■Schedule:
  November 25, 2020 (Wed)
  *Schedule may change without prior notice.

 ■Effected versions:
  All available versions (v1, v2, v3)

 ■Changes:
  The number of reject reasons you can get on editorial review will
  increase. You can get up to 30 reasons for ads and you can refer those
  reasons when you request re-review.

8. Changes on Yahoo! JAPAN Ads API Management Console:
 We have made the following changes.

 ■Effective date
  October 19, 2020 (Mon)

 ■Changes:
  We have increased the maximum number of Redirect URIs that can be set
  in an application from 10 to 50.

9. Reference:
 More details are available on the release note and reference document
 provided.
 Also note that we have renewed our reference website. The entire page
 has been redesigned, and URLs have been set for each Service or Action
 to make it easier to access.

 ■Release note
 - Search Ads API
 - Display Ads API
 
 ■Reference
 https://ads-developers.yahoo.co.jp/reference/en

 We will hold an online seminar to give an overview of v3.
 See the following details.
 Yahoo! JAPAN Ads API Webinar information
 
10. Yahoo! JAPAN Ads API v1 Sunset:
 Yahoo! JAPAN Ads API v1 sunset is scheduled as follows.
  -Deprecation Date : November 30, 2020 (Mon)
  -End of Life Date : March 22, 2021 (Mon)

 Also Yahoo! JAPAN Ads API v0 will end on the following scheduled date
 as previously announced in "Yahoo! JAPAN Ads API v2 released (Document
 Number: APIE-FY20-2050)."
  -End of Life Date : November 19, 2020 (Thu)
   *We have ended the user support for v1 already.

11. Yahoo! JAPAN Promotional Ads API Sunset
 Yahoo! JAPAN Promotional Ads has ended support.
 Please consider to migrate to Yahoo! Ads API if you are using Yahoo!
 JAPAN Promotional Ads API.
 
 -YDN API
  End of Life Date
  v201907 and V201911 are scheduled on December 16, 2020 (Wed)
  *We have ended the user support for v1 already.

 -Sponsored Search API
  *We have ended all versions already.


If you have any questions, please contact us.

Sincerely,
Yahoo! JAPAN API support team