Yahoo!広告 API | Developer Center

English

2023/06/13

Yahoo!広告 API v11 システムリリース完了のお知らせ

Yahoo!広告 APIの新バージョンをリリースしました。詳細を下記のとおりお知らせいたしますので、ご確認ください。

対象サービス

Yahoo!広告 検索広告 API
Yahoo!広告 ディスプレイ広告 API

リリースのバージョン

v11

実施日

2023年6月12日（月）

検索広告 APIの変更点

■レポート項目名称の変更
Yahoo!広告 検索広告 APIとYahoo!広告 ディスプレイ広告 APIでレポートの項目名称を統一するため、対象のフィールド名を変更しました。

■ConversionTrackerServiceの統計情報取得の仕様変更
ConversionTrackerServiceにおいて、従来はget、add、setで統計情報を返却していましたが、getのみ返却する仕様に変更しました。

■操作履歴ファイル一部文字コードの削除
操作履歴ファイルのエンコード形式から、文字コード「UTF16LE」を削除しました。

■提供終了済みサービスの削除
提供を終了したサービスをインターフェースから削除しました。

ディスプレイ広告 APIの変更点

■最適化提案の改善に伴うインターフェースの変更
最適化提案の機能改善に伴い、インターフェースを変更しました。なお、v10以前のバージョンも併せて変更しています。改善内容の詳細は以下のお知らせをご確認ください。
【ディスプレイ広告（運用型）】最適化提案における画像・動画の更新提案の変更について

■ConversionTrackerServiceの統計情報取得の仕様変更
ConversionTrackerServiceにおいて、従来はget、add、setで統計情報を返却していましたが、getのみ返却する仕様に変更しました。

■統計情報の集計可能な期間を拡大
統計情報において、集計可能な期間を過去25カ月分から過去37カ月分に変更します。実際に利用可能になるのは2023年6月21日（水）を予定しています。詳しくは以下のお知らせをご確認ください。
ディスプレイ広告 パフォーマンスデータの集計可能な期間の拡大について

■コンテンツキーワードターゲティングのレポート取得に対応
コンテンツキーワードターゲティングのレポートが作成できるようになりました。

■入札戦略の拡張クリック単価を追加
入札戦略においてベータ版として提供している「拡張クリック単価（eCPC）」に対応しました。

■リンク先URLのフィールドを削除
リンク先URLが設定されている広告は2022年11月以降に掲載を停止しており、現在は利用していないため、リンク先URLのフィールドを削除しました。

■レポート項目名称の変更
Yahoo!広告 ディスプレイ広告 APIとYahoo!広告 検索広告 APIでレポートの項目名称を統一するため、検索広告 APIと名称をあわせたフィールドを追加しました。従来のフィールドも利用可能ですが、今後廃止予定のため、新しいフィールドをご利用ください。

■利用不可の入札戦略を削除
利用できない入札戦略「AUTO」および「NONE」を削除しました。

■操作履歴ファイルの文字コード指定に対応
操作履歴ファイルの作成時に文字コードの指定が可能になりました。

■保守改善

  • AdTypeによる絞り込み検索に対応
    AdGroupAdService（get）およびGuaranteedAdGroupAdService（get）のリクエストにadTypesを追加しました。

  • プレイスメントリストのURL候補から広告タイプ情報を削除
    PlacementUrlIdeaServiceのリクエストおよびレスポンスからAdFormatを削除しました。

Java利用者向けのクライアントライブラリのリリースに関するお知らせ

■概要
Java利用者向けに公開しているYahoo!広告 APIのクライアントライブラリのv11対応版より、Spring Framework 5系, 6系それぞれに対応するバージョンをリリースします。Spring boot 3系にも対応しているため、ご利用の動作環境に合わせてSpring Framework 5系, もしくは6系に対応するクライアントライブラリを選択してください。ライブラリの各リリースタグと動作環境は以下の通りです。

release tagjava versionspring framework
5.0.0-spring5 8+ 5.3.x
5.0.0 17+ 6.x.x

※これまでの動作環境を維持したい場合は「5.0.0-spring5」をご利用ください。Javaのバージョンや依存関係を変更することなく、引き続きクライアントライブラリをご利用いただけます。
※「5.0.0-spring5」などの「-spring5」がついたバージョンは、今後、一定の期間を経てサポートを終了する予定です。ご利用される場合はなるべく早めに「-spring5」がついていないバージョン（Spring Framework 6系）への移行をお願いいたします。

■リリーススケジュール

  • 5.0.0-spring5　近日公開

  • 5.0.0　　　　　2023年7月頭
    ※スケジュールは変更になる場合があります。

クライアントライブラリについて、詳しくは以下を参照してください。
https://github.com/yahoojp-marketing/ads-display-api-java-lib
https://github.com/yahoojp-marketing/ads-search-api-java-lib

補足

旧バージョンの終了について

Yahoo!広告 APIv9の提供を以下の日程で終了します。
　　サポート終了日：2023年6月26日（月）
　　システム終了日：2023年10月23日（月）

また、Yahoo!広告 APIv8の提供を以下の日程で終了します。
　　システム終了日：2023年6月26日（月）
　　※サポートは終了済みです。

Developer Center

関連サイト