Yahoo! JAPAN Ads API | Developer Center
日本語Search Ads API v7 Release Note
Release version
v7
Release date
January 17, 2022 (Mon)
Main Contents of this release
*More about objects and other details are described on the Reference document.
1. Bid strategy renaming
Names on bid strategy changed.
Service
CampaignService
BiddingStrategyService
KeywordForecastMetricsService
KeywordEstimatorService
AdGroupWebpageService
AdGroupCriterionService
AdGroupService
Description
・Following ENUM names changed on the services.
|
Before |
After |
|
MANUAL_CPC |
CPC |
|
TARGET_SPEND |
MAXIMIZE_CLICKS |
・Following field names changed on the services.
|
Before |
After |
|
manualCpcBiddingScheme |
cpcBiddingScheme |
|
targetSpendBiddingScheme |
maximizeClicksBiddingScheme |
|
maxCpc |
cpc |
|
adGroupMaxCpc |
adGroupCpc |
|
keywordMaxCpc |
keywordCpc |
2. Changes on final URL
There were renaming and removing fields related to the final URL.
Service
AdGroupAdService
AdGroupCriterionService
Description
・Following fields were removed from the services.
・additionalAdvancedMobileUrls
・additionalAdvancedUrls
・Following field names changed on the services.
|
Before |
After |
|
advancedUrl |
finalUrl |
|
advancedMobileUrl |
smartphoneFinalUrl |
|
reviewAdvancedUrl |
reviewFinalUrl |
|
reviewAdvancedMobileUrl |
reviewSmartphoneFinalUrl |
3. Subdivision of conversion tracking purpose
ConversionTrackerServiceCategory was added and renamed to subdivide the conversion tracking purposes.
It will be available around the spring of 2022. More details will be announced later.
Service
ConversionTrackerService
4. New ad display options
Along with the new ad display options, some services were added on API v6 and v7.
It will be available around the spring of 2022.
See the following release note for more detail.
[Search Ads] New format of Ad Display Options
Service
AssetService
AdGroupAssetService
CampaignAssetService
Description
We have added these new services Available methods of these services are as follows.
AssetService / add, get, set, setTrademarkStatus
AdGroupAssetService / get, set, replace
CampaignAssetService / get, set, replace
Notes
The FeedItemService provided in v6 and earlier versions will be discontinued in the near future.
We will inform you of the end of service schedule later.
5. Format of site retargeting tag
We have changed the format of renewed site retargeting tag that can be acquired by advancedSnippet of RetargetingListService/get to a format that includes site retargeting tags common to the Campaign Management Tool.
Service
RetargetingListService
6. Improving response (for all available versions)
If a duplicate of an existing ad item such as a campaign or keyword is found when you add, the ID of the existing ad item that is duplicated will be responded in addition to the error code.
This makes it easier to find existing items that are subject to duplication. This change was applied to all versions.
Service
AdGroupAdService
AdGroupCriterionService
AdGroupService
CampaignService
Description
Item IDs that will be responded on the services are as follows.
|
Service |
ID that is responded to when it overlaps |
|
CampaignService |
campaignId |
|
AdGroupService |
adGroupId |
|
AdGroupAdService |
adId |
|
AdGroupCriterionService |
criterionId |
Search Ads API v5 Sunset
Search Ads API v5 is scheduled to sunset as follows.
・Deprecation Date: February 24, 2022 (Thu)
・End of life date: June 8, 2022 (Wed)
Search Ads API v4 sunset is scheduled as follows.
・End of Life Date : February 24, 2022 (Thu)
*We have ended the user support for this version already.