ディスプレイ広告 API v4 リリースノート

リリースバージョン

v4

リリース日

2021年2月24日(水)

本リリースの主な内容

※オブジェクトなどの詳細は、リファレンスをご確認ください。

1. MCCアカウント対応

MCCアカウントの検索、参照、変更に対応しました。機能についての詳細は、以下を参照してください。
【Yahoo!広告】MCCアカウントの提供開始について
※MCCアカウントの作成と広告アカウントの関連付けは、広告管理ツールからの操作が必要です。

対象サービス
・AccountLinkServiceを新設し、MCCアカウントのアカウントリンク情報取得に対応
 ※事前に広告管理ツールから、MCCアカウントの作成および広告アカウントの関連付け(アカウントリンク)が必要です。
・AccountService
 - managerAccountId、およびcanManageAccountsを削除
 - getリクエスト時、includeManagerAccountを追加
 - get、setのレスポンスにisManagerAccountを追加

2. ターゲットリスト共有

MCCアカウント配下の広告アカウント間で、サイトリターゲティングのターゲットリストが共有可能になります。
※この機能は2021年3月10日(予定)以降に利用可能です。詳細は以下のリリースノートを参照してください。
 【ディスプレイ広告】ターゲットリスト共有機能の提供について

以下の機能はディスプレイ広告 APIの全バージョンで利用できます。
・MCCアカウントでのサイトリターゲティングタグの作成、取得
・MCCアカウントでのターゲットリストの追加、更新、取得、削除
・広告アカウント間で共有したターゲットリストの参照、更新、広告グループへの関連付け

以下の機能はv4のみ利用可能です。
・ターゲットリストの共有元アカウントIDおよびアカウント名の取得
・ターゲットリストが共有済みかを示すフラグの取得
・ターゲットリストの共有状況を指定した絞り込み

対象サービス
RetargetingListService
RetargetingTagService ※インターフェイスの変更はありません。

3. 動画の再生完了率の取得

動画の再生完了率を取得できるようになりました。
※広告管理ツールではすでに提供中の機能です。詳細は以下のリリースノートを参照してください。
 【ディスプレイ広告】統計項目「動画の再生完了率」追加のお知らせ

対象サービス
StatsService

4. レポート関連の変更

・MCCアカウントをご利用の場合、以下のレポートで複数アカウントの集計に対応します。
 - コンバージョン経路レポート
 - 横断リーチレポート

※この機能は2021年3月3日(予定)以降に利用可能です。詳細は以下のリリースノートを参照してください。
 ディスプレイ広告 一部レポートでの複数アカウント集計対応について

・ReportDefinitionServiceにおいて、以下の変更を実施しました。
  - レポートの「ヘッダ行」「合計行」の有無を指定可能
  - 小数点を含む数値項目の表示タイプを「全て表示」「簡易表示」から選択可能
  - 返却する項目名の「動画の平均再生開始率」を「動画の平均再生率」に変更
  - レポートで返却するキャンペーン掲載タイプの値の表記「E-commerce」を、「Ecommerce」に変更
  - ダウンロードファイルの文字コードを示すEnumで、値の表記「UTF-8」を「UTF8」に変更

5. 各種ターゲティングの機能改善

以下のターゲティング機能について、1つの広告グループに複数のリストを設定し、またリストごとに入札価格調整率を設定可能になりました。
 ・サーチキーワードターゲティング
 ・サイトリターゲティング
 ・プレイスメントターゲティング

上記はディスプレイ広告APIの全バージョンで利用可能です。
v4ではさらに、以下の機能も利用できます。
 ・プレイスメントターゲティングでの除外専用リストの操作
 ・サーチキーワードリスト、ターゲットリスト、プレイスメントリストのパフォーマンスデータ取得
 ・サーチキーワードリスト、ターゲットリスト、プレイスメントリストのレポート取得

機能の詳細は以下のリリースノートを参照してください。
 ディスプレイ広告(運用型)ターゲティング機能改善について

対象サービス
・AdGroupTargetService
・PlacementUrlListService
・ReportDefinitionService
・SearchKeywordIdeaService
・StatsService

6. 保守改善

AccountServiceからアカウント管理者のYahoo! JAPANビジネスIDを更新できるようになりました。

ディスプレイ広告 API v2の提供終了について

以下の日程でディスプレイ広告 API v2のサポート、およびシステムの提供を終了いたします。
・サポート終了日:2021年3月22日(月)
・システム終了日:2021年7月20日(火)

また、以前にお伝えしたとおり、ディスプレイ広告 API v1を以下の日程で終了します。
・システム終了日:2021年3月22日(月)
 ※サポートは終了済みです。