Display Ads API v5 Release Note

Release version

v5

Release date

June 8, 2021 (Tue)

Main Contents of this Release

* More about objects and other details are described on the Reference document.

1. Gets reject reasons and violation

When your ad is rejected by the editorial review (the review status is "declined" or "removed"), you can obtain the reason for the rejection and the location of the violation.

 Service
 ・Add the followings to AdGroupAdService
  - adGroupAd
  - disapprovalReasonDescription

 ・AdGroupAdService
  Added the violation part to the content of disapprovalReasonDescription

 ・GuaranteedAdGroupAdService
  Added the violation part to the content of disapprovalReasonDescription

2. Supports SKAdNetwork measurement

SKAdNetwork measuring of iOS apps became available on app promotion campaigns of Display Ads (Auction).
* This feature is already available on the Campaign Management Tool. See the following release note for more detail.
 [Display Ads (Auction)] SKAdNetwork for measuring iOS app

 Service
  ・CampaignService
   Changed to return the set advertising measurement tool name with campaign.vendorName

3. Supports app installation measuring by view through conversion

App install (view-through conversion) measurements of users who have viewed ads but have not clicked (or viewed a video) became available on Display Ads (Auction).
* This feature is already available on the Campaign Management Tool. See the following release note for more detail.
 [Display Ads] Added functions related to measuring ad performance

 Service
  ・Add the followings to AdGroupAdService
   - adGroupAd.viewableImpressionBeaconUrls
   - adGroupAd.isRemoveViewableImpressionBeaconUrls
   ・Change "adGroupAd.isRemoveBeaconUrls" to "isRemoveImpressionBeaconUrls"

4. Supports proposals of various image sizes by Recommendation

Proposals of Responsive Ads for Search with various image sizes became available on the Recommendations feature of Display Ads (Auction).
* This feature is already available on the Campaign Management Tool. See the following release note for more detail.
 [Display Ads] Responsive ads additional suggestion feature on Display Ads (Auction)

 Service
  ・RecommendationService
   Added Enum campaignsForAddingAds

5. Changes on Age Targeting report of Display Ads

We will change the age groups of age targeting to new groups. Along with this change, we have updated reporting item names for age groups.
This change was applied on all available versions.
* We have announced this change in May 2021. See the following announcement for the details.
 Changes on Age Targeting report of Display Ads

 Service
  ・ReportDefinitionService
   Change display name of age groups

6. Maintenance release

・Following report item names changed
 
BeforeAfter
Japanese インストリーム広告 インストリーム
English In-stream ads In-stream


Display Ads API v3 Sunset

Display Ads API v3 is scheduled to sunset as follows.
・Deprecation Date : July 20, 2021 (Tue)
・End of life date: October 20, 2021 (Wed)

Display Ads API v2 sunset is scheduled as follows.
・End of Life Date : July 20, 2021 (Tue)
 * We have ended the user support for this version already.