Yahoo!広告 API | Developer Center
English検索広告 API v7 リリースノート
リリースバージョン
v7
リリース日
2022年１月17日（月）
本リリースの主な内容
※オブジェクトなどの詳細は、リファレンスをご確認ください。
1. 入札戦略の名称変更
入札戦略に関する名称を変更しました。
対象サービス
CampaignService
BiddingStrategyService
KeywordForecastMetricsService
KeywordEstimatorService
AdGroupWebpageService
AdGroupCriterionService
AdGroupService
内容
・対象サービスにおいて、以下のENUMの名称を変更しました。
| 変更前 | 変更後 |
|---|---|
| MANUAL_CPC | CPC |
| TARGET_SPEND | MAXIMIZE_CLICKS |
・対象サービスにおいて、以下のフィールドの名称を変更しました。
| 変更前 | 変更後 |
|---|---|
| manualCpcBiddingScheme | cpcBiddingScheme |
| targetSpendBiddingScheme | maximizeClicksBiddingScheme |
| maxCpc | cpc |
| adGroupMaxCpc | adGroupCpc |
| keywordMaxCpc | keywordCpc |
2. 最終リンク先URLに関するフィールドの削除および名称変更
最終リンク先URLに関するフィールドの削除および名称変更を行いました。
対象サービス
AdGroupAdService
AdGroupCriterionService
内容
・対象サービスにおいて、以下のフィールドを削除しました。
・additionalAdvancedMobileUrls
・additionalAdvancedUrls
・対象サービスにおいて、以下のフィールドの名称を変更しました。
| 変更前 | 変更後 |
|---|---|
| advancedUrl | finalUrl |
| advancedMobileUrl | smartphoneFinalUrl |
| reviewAdvancedUrl | reviewFinalUrl |
| reviewAdvancedMobileUrl | reviewSmartphoneFinalUrl |
3. コンバージョン測定の目的の細分化
コンバージョン測定の目的を細分化するためConversionTrackerServiceCategoryの追加、名称変更を行いました。
実際に利用可能になるのは、 2022年春頃を予定しています。機能の詳細は追ってご連絡いたします。
対象サービス
ConversionTrackerService
4. 新広告表示オプションの対応
新しい広告表示オプションの提供に伴い、v6、v7にサービスを追加しました。
実際に利用可能になるのは、2022年早春を予定しています。
機能の詳細は、以下のリリースノートを参照してください。
【検索広告】新形式の広告表示オプションの提供開始について
対象サービス
AssetService
AdGroupAssetService
CampaignAssetService
内容
上記の対象サービスを新設しました。各サービスのメソッドは以下のとおりです。
AssetService / add, get, set, setTrademarkStatus
AdGroupAssetService / get, set, replace
CampaignAssetService / get, set, replace
ご注意
v6以前のバージョンで提供しているFeedItemServiceは、今後、提供を終了する予定です。
提供終了のスケジュールは追ってご連絡いたします。
5. サイトリターゲティングタグの形式を広告管理ツールと共通化
RetargetingListService/getのadvancedSnippetで取得できるリニューアル版のサイトリターゲティングタグを、
広告管理ツールと共通のサイトジェネラルタグを含む形式に変更しました。
対象サービス
RetargetingListService
6. add時の入稿アイテム名やキーワードにおける重複エラーのレスポンス改善（全バージョン）
キャンペーンやキーワードなどの入稿アイテムのadd時に既存の入稿アイテムとの重複が見つかった場合、
エラーコードに加えて重複する既存入稿アイテムのIDをレスポンスします。
これにより、重複対象となる既存のアイテムを見つけやすくなりました。この変更は全バージョンに実施しました。
対象サービス
AdGroupAdService
AdGroupCriterionService
AdGroupService
CampaignService
内容
各対象サービスでレスポンスされる入稿アイテムIDは、以下のとおりです。
| 対象サービス | 重複した場合にレスポンスされるID |
|---|---|
| CampaignService | campaignId |
| AdGroupService | adGroupId |
| AdGroupAdService | adId |
| AdGroupCriterionService | criterionId |
検索広告 API v5の提供終了について
以下の日程で検索広告 API v5のサポート、およびシステムの提供を終了いたします。
・サポート終了日：2022年2月24日（木）
・システム終了日：2022年６月８日（水）
また、以前にお伝えしたとおり、検索広告 API v４を以下の日程で終了します。
・システム終了日：2022年2月24日（木）
※サポートは終了済みです。