Yahoo! JAPAN Ads API v9 released

Document Number: APIE-FY22-2315


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 v9 release (Document Number:
APIE-FY22-2276)." Please see the following details.
                
1. Product:
 Yahoo! JAPAN Ads Search Ads API
 Yahoo! JAPAN Ads Display Ads API

2. Version released:
 v9

3. Date
 September 13, 2022 (Tue)

4. Changes on Search Ads API:
 ■Ending Extended Text Ads Data Assignment
  We will end adding new ads of Extended Text Ads. In addition, the
  Data Assignment List will no longer be available in Ad Customizer
  that can be used for Extended Text Ads and Dynamic Ads for Search.
  *The end of life date is scheduled for September 28, 2022 (Wed),
  not the release date of v9.
  See the following release note for more detail.
  [Search Ads] End of Extended Text Ads and data assignment list, and
  add features on Responsive Ads for Search
  https://ads-promo.yahoo.co.jp/support/release/30270459.html#article_en

 ■Changing the names of items along with the renewal of the Campaign
 Management Tool
  Along with the renewal of the Campaign Management Tool, we have
  changed the names of items related to campaigns and ad groups.

 ■Adding items that can be specified in CampaignExportService (all
 versions)
  We have added some items to CampaignExportService (getExportFields).
  *We correct that the keywordTrackId listed as an additional item
  in the previous announcement is no longer applicable.

 ■Adding corporate number on the views of create and edit ad account
  We have added corporate number on the views of create and edit ad
  account. See the following release note for more detail.
  [Yahoo! JAPAN Ads] Adding "corporate number" on the views of
  create and edit ad account
  https://ads-promo.yahoo.co.jp/support/release/30324058.html#article_en

 ■Maintenance release
 ・We have removed items that return the previous format conversion
  tags and site retargeting tags.
  *This feature is already closed on the Campaign Management Tool.
 ・We have removed KeywordEstimatorService. Since this is no longer
  available in all versions, use KeywordForecastMetricsService in the
  future.

5. Changes on Display Ads API:
 ■Targeting using app lists
  We have started supporting targeting using app lists by the
  Audience Manager.
  It allows you to separate targeting of multiple smartphone apps and
  the management of audience lists will be easier.
  *Available from October 17, 2022 (tentative)
  We will make another announcement once details have been decided.
 ・Services that will have change
  AudienceListService
  AdGroupTargetService
  AppLinkService *New

 ■Adding corporate number on the views of create and edit ad account
  We have added corporate number on the views of create and edit ad
  account.
  *This feature is already available on the Campaign Management Tool.
  See the following release note for more detail.
  [Yahoo! JAPAN Ads] Adding "corporate number" on the views of create
  and edit ad account
  https://ads-promo.yahoo.co.jp/support/release/30324058.html#article_en

 ■Optimization score released
  We have released the optimization score that is the ratings for
  your autobidding to maximize achievement of your business.
  *This feature is already available on the Campaign Management Tool.
  See the following release note for more detail.
  [Display Ads (Auction)] Optimization score released
  https://ads-promo.yahoo.co.jp/support/release/30336196.html#article_en

 ■Closing features of Display Ads (Guaranteed) services
  In consideration of usage conditions and other factors, we have
  closed some Display Ads (Guaranteed) services.
  *Display Ads (Guaranteed) services is a limited function for some
  customers. There is no impact to the customers not currently using
  the services.

 ■Maintenance release
  ・Bid strategy renaming
  In the bid strategy for campaigns and ad groups, we have changed
  the method of specifying TargetCPA as follows.
  We will make another announcement once details have been decided.
  - Before v8
  Specify TARGET_CPA in Enum and enter targetCpa value (no change
  from previous)
  - After v9
  Specify MAXIMIZE_CONVERSIONS in Enum and then specify the item to
  enter the targetCpa value
  Value is entered in the specified field
  *The operation history is recorded as tCPA.
  In addition, all bid strategies no longer return past values after
  v9. See the release note for more detail.
  ・We have removed items that return the previous format conversion
  tags and site retargeting tags.
  The services and fields are as follows.
  *This feature is already closed on the Campaign Management Tool.
  ・Removed webConversion/snippet[]/tag field of
  ConversionTrackerService
  ・Removed retargetingTag/tag field of RetargetingTagService
  ・We have changed the maximum number of items that CamapignService
  can get.
  - Upper limit of campaignIds
   Before v8: 500
   v9: 2000
  - Upper limit of numberResults
   Before v8: 500
   v9: 2000

6. Remarks:
 ・More details will be available on the release note and reference
  document provided on the new version release.
  - Search Ads API
  https://ads-developers.yahoo.co.jp/developercenter/en/developers-guide/ysa-v9.html
  - Display Ads API
  https://ads-developers.yahoo.co.jp/developercenter/en/developers-guide/yda-v9.html
  - Reference
  https://ads-developers.yahoo.co.jp/reference/en/

 ・We will hold an online seminar to give an overview of v9 along with
  the release. The following announcement describes the details.
  https://ads-developers.yahoo.co.jp/developercenter/en/announcement/222295.html

7. Yahoo! JAPAN Ads API v7 Sunset:
 Yahoo! JAPAN Ads API v7 sunset is scheduled as follows.
  End of life date: February 27, 2023 (Mon)
  *We have ended the user support on September 13, 2022 (Tue).

 Yahoo! JAPAN Ads API v6 has also ended on the following scheduled
 date as previously announced in "Yahoo! JAPAN Ads API v8 released
 (Document Number: APIE-FY22-2224)."
  End of life date: September 13, 2022 (Tue)
  *We have ended the user support for this version already.

If you have any questions, please contact us.

Sincerely,
Yahoo! JAPAN API support team