Yahoo! JAPAN Ads API | Developer Center
日本語Display Ads API v9 Release Note
Release version
v9
Release date
September 13, 2022 (Tue)
Main Contents of this release
*More about objects and other details are described on the Reference document.
1. 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
AudienceListService
AdGroupTargetService
AppLinkService *New
Description
App user lists will be available when creating lists and ad groups. In addition, link IDs and their accompanying information will be available for reference.
We have added the following items to the above services.
Added APP_USER to audienceListType
Added appLink under audienceListContent
2. 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
Service
AccountManagementService (add)
Description
client.corporateNumber is added as an entry field for the corporate number.
3. 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
Services
CampaignService
RecommendationService
Description
Optimization scores are now available in CampaignService. In addition, suggestions for improving the optimization score have been added to the RecommendationService.
4. 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.
Services
GuaranteedSimulationService
GuaranteedInventoryService
GuaranteedReservationService
GuaranteedPreviewService
The following services will stop.
GuaranteedCampaignService (set)
GuaranteedAdGroupService (add, set)
GuaranteedAdGroupAdService (add, set)
DictionaryService (getStationPlacementCategory)
5. 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 following table for more detail.
| Campaign's bid strategy | Value returned by v9 | Value not returned by v9 |
|---|---|---|
|
Manual bidding and viewable cost-per-thousand impressions (vCPM) |
vcpmBiddingScheme.vcpm | cpvBiddingScheme cpcBiddingScheme maximizeConversionsBiddingScheme |
|
Manual bidding and cost per click (CPC) |
cpcBiddingScheme.cpc | cpvBiddingScheme vcpmBiddingScheme maximizeConversionsBiddingScheme |
|
Manual bidding and cost per video view (CPV) |
cpvBiddingScheme.cpv | vcpmBiddingScheme cpcBiddingScheme maximizeConversionsBiddingScheme |
|
Autobidding (maximize conversions with target value) |
maximizeConversionsBiddingScheme.targetCpa | vcpmBiddingScheme cpcBiddingScheme cpvBiddingScheme |
| ・Autobidding (maximize conversions without target value) ・Other bid strategies |
None | vcpmBiddingScheme cpcBiddingScheme cpvBiddingScheme maximizeConversionsBiddingScheme |
Services
CampaignService
AdGroupService
・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
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.