Skip to content
This repository has been archived by the owner on Nov 30, 2021. It is now read-only.

Latest commit

 

History

History
206 lines (165 loc) · 11.1 KB

releasenotes.md

File metadata and controls

206 lines (165 loc) · 11.1 KB

リリースノート

リリースバージョン  

V201907(WSDLバージョン V201907)

本リリースの主な内容

※対象データオブジェクトとEnumerationは、データオブジェクト(Enumeration)集をご確認ください。

1. 動的ディスプレイ広告の機能改善

動的ディスプレイ広告の機能改善として、商品リストファイルのアップロードに以下の機能を追加しました。

  • デバッグモードに対応
  • ファイルアップロード時にアップロード経路やエラー情報などの詳細情報を取得
  • 定期アップロードに関するステータスを追加
対象ウェブサービス

2. 画像・動画のアスペクト比による入稿

画像・動画のアスペクト比による入稿に対応しました。
これに伴い、「DictionaryService」のgetMediaAdFormatで、アスペクト比による入稿が可能かを示すフラグ、アスペクト比、最大画像サイズなどの取得に対応しました。

対象ウェブサービス

3. PCブランドパネルの入稿に対応

広告掲載方式「PCブランドパネル」の入稿に対応するため、以下の変更を実施しました。

  • CampaignService(公開中の全バージョン):
     「PCブランドパネル(静止画)」、「PCブランドパネル(動画)」のキャンペーン作成取得、更新、削除に対応
  • AdGroupAdService:
     バナー(動画)広告の作成、取得、更新、削除に対応
     ※「PCブランドパネル」は一部のお客様のみに提供している広告掲載方式です。

対象ウェブサービス

4. 効果測定指標の追加、変更

パフォーマンスレポートや統計情報に使用する測定指標を追加、変更しました。

計測方法の変更

以下の指標について、計測方法をクライアントサイド計測に変更しました。

  • インプレッション数
  • クリック率
     ※2019年6月30日以前の数値は取得できません。
     ※従来のサーバーサイド計測の数値は、新たに追加する「インプレッション数(旧)」「クリック率(旧)」でご確認ください。

定義の変更

平均CPVの定義を、以下のとおり変更しました。

  • 従来  動画再生にかかったコスト÷課金が発生した動画再生数
  • 変更後 動画再生にかかったコスト÷動画の10秒再生数
    ※動画の10秒再生数は、課金が発生した動画再生数と同様です。

測定タイミングの変更 ※API全バージョンが対象

「ビューアブルインプレッション数」(従来の名称は「ビューインプレッション数」)の測定タイミングを、以下のとおり変更しました。実施日以降に発生したビューアブルインプレッションのみが対象です。

  • 従来  広告の配信日時を発生日時として測定
  • 変更後  広告がビューアブル(ユーザーの視認範囲に広告が表示された状態)になった時点を発生日時として測定

指標の追加

新たに以下の指標を追加しました。

日本語表示名パフォーマンスレポートのフィールド名統計情報のフィールド名説明
インプレッション数(旧)IMPS_PREVimpsPrevサーバーサイド計測によるインプレッション数。
2019年6月30日以前のインプレッション数は、この指標でご確認ください。
クリック率(旧)CLICK_RATE_PREVclickRatePrevサーバーサイド計測によるクリック率。
2019年6月30日以前のクリック率は、この指標でご確認ください。
メジャードインプレッション数MEASURED_IMPSmeasuredImpsクライアントサイド計測による、ビューアブルインプレッション数の計測が可能なインプレッション数
メジャードインプレッション測定率MEASURED_IMPS_RATEmeasuredImpsRateクライアントサイド計測による、インプレッションに対するメジャードインプレッションの測定率。
ビューアブルインプレッション率VIEWABLE_IMPS_RATEviewableImpsRateクライアントサイド計測による、ビューアブルインプレッション数の計測が可能なインプレッション率。
ビューアブルクリック数VIEWABLE_CLICKviewableClicksクライアントサイド計測による、ビューアブルインプレッションに対するクリック数。
ビューアブルクリック率VIEWABLE_CLICK_RATEviewableClickRateクライアントサイド計測による、ビューアブルインプレッションに対するクリック率。
動画の10秒再生数VIDEO_VIEWS_TO_10_SECvideoViewsTo10Sec動画が10秒以上再生された回数。
※課金が発生した動画再生数と同数になります。
対象ウェブサービス

5. 一部のAdTypeに関する名称の変更

YDNでの広告タイプの名称変更に伴い、一部のEnum名およびEntity名を変更しました。
公開中の全バージョンのインポート用テンプレートおよび操作履歴でも、上記の名称に変更されています。なお、インポート用テンプレートを使ったインポートでは、従来の名称も利用可能です。
※V201907においてレポートのフィルターでAdTypeを設定する場合は、変更後のAdType名称での設定が必要です。

従来の従来のEnum名従来のEntity名変更後のEnum名変更後のEntity名
RESPONSIVE_ADResponsiveAdRESPONSIVE_IMAGE_ADResponsiveImageAd
VIDEO_ADVideoAdRESPONSIVE_VIDEO_ADResponsiveVideoAd
NONENoneBANNER_IMAGE_ADBannerImageAd
対象ウェブサービス

6. アニメーションGIF画像のアップロード停止

アニメーションGIF画像のアップロード停止に伴い、DictionaryServiceのgetMediaAdFormatから「animation」フィールドを廃止しました。

対象ウェブサービス

7. 機能名および効果測定指標名の変更

一部の機能と効果測定指標の名称を変更しました。詳細はこちらでご確認ください。
これに伴い、統計情報(StatsService)で以下項目の名称を変更しました。

  • totalClickCost → cost
  • avgClickCost → avgCpc
対象ウェブサービス

8. 保守対応

レポート関連サービスの統合

ReportServiceをReportDefinitionServiceと統合しました。
以後のレポート定義とレポートジョブは、ReportDefinitionServiceで作成してください。詳細は以下の仕様ドキュメントでご確認ください。

定期レポートの実行を停止(公開中の全バージョン)

V201806以前に作成した定期レポートについて、intervalTypeをONETIMEに変更しました。これにより、定期レポートの実行はすべて停止されています。

LocationServiceの廃止

LocationServiceを廃止しました。

対象ウェブサービス

Serviceの変更による各Versionへの主な影響

Service V201903以前 V201907
FeedDataService インターフェイス変更なし
・getUploadUrlで、デバッグモードを利用できる
・getUploadStatusで、ファイルアップロード経路、エラー率、取り込み完了日時、定期アップロード用に追加されたステータスを取得できる
DictionaryService インターフェイス変更なし ・animation、idフィールドは取得できない
・アスペクト比入稿向けの情報を取得できる
AdGroupAdService PCブランドパネルのキャンペーンを作成、更新、取得、削除できる ・PCブランドパネルのキャンペーンを作成、更新、取得、削除できる
・BannerVideoAd広告(バナー(動画)広告)を作成、更新、取得、削除できる
・名称変更後のAdTypeのEnum名、Entity名を取得できる
StatsService インターフェイス変更なし クライアントサイド計測による新指標、及び名称が変更された旧指標を取得できる
ReportDefinitionService インターフェイス変更なし ・クライアントサイド計測による新指標、及び名称が変更された旧指標を取得できる
・レポート定義の作成とジョブ登録を同時に行える
ReportService インターフェイス変更なし 廃止
LocationService 同じロケーションが一律で返却される(既存ユーザーへの影響はなし) 廃止

YDN API V201812の提供終了について

以下の日程でYDN API V201812のサポートおよびシステムの提供を終了いたします。

  • サポート終了日:2019年9月2日(月)
  • システム終了日:2019年12月2日(月)