releasenotes.md

リリースノート

リリースバージョン　　

V201812（WSDLバージョン V201812）

本リリースの主な内容

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

1. 動画視聴コンバージョンの測定対応

Yahoo!ディスプレイアドネットワーク（YDN）の動画広告において、動画を10秒以上視聴したユーザーが、視聴後に広告クリック以外の方法でコンバージョンに至った件数の測定に対応しました。これに伴い、以下の点を変更しました。

■パフォーマンスデータおよびレポートにおけるコンバージョン関連指標の仕様変更

• 既存のコンバージョン関連の指標におけるコンバージョン定義の拡大
  　変更前：
  　広告のクリック経由でサイトを訪問したユーザーによるコンバージョンをカウント対象とする
  　変更後：
  　広告のクリック経由でサイトを訪問したユーザー、および、動画広告の動画を10秒以上視聴した後に広告のクリック以外の経路でサイトを訪問したユーザーによるコンバージョンをカウント対象とする
  　※10秒未満の動画の場合は、視聴を完了した時点で10秒視聴と同義とします。
  
• 新指標の追加
  　-広告のクリック経由で発生したコンバージョンのみをカウント対象とする指標
  　-デバイスをまたいだコンバージョン数を確認する指標
  

■視聴ビーコンURL項目を追加

AdGroupAdServiceに、動画コンバージョンを測定する視聴ビーコンURL関連の項目を追加しました。
また、AuditLogService、BulkServiceのダウンロードファイルにも追加しました。
※ダウンロードファイルへの追加は、提供中の全バージョンが対象です。

■コンバージョンタグの設定項目の追加

ConversionTrackerServiceに、動画の視聴からコンバージョンが発生するまでの測定期間を設定する項目「measurementPeriodView」を追加しました。測定期間は1日～30日間の範囲で設定できます。
また、AuditLogServiceのダウンロードファイルにも同項目を追加しました。
※ダウンロードファイルへの追加は、提供中の全バージョンが対象です。

対象ウェブサービス

• AdGroupAdService
• AuditLogService
• BulkService
• ConversionTrackerService
• ReportDefinitionService
• ReportService
• StatsService

2. 動画広告にアスペクト比1:1の動画フォーマットを追加

動画広告にアスペクト比1：1（ピクセルサイズ　600×600）の新フォーマットを追加しました。なお、APIインターフェース上の変更はありません。
※提供中の全バージョンが対象です。

対象ウェブサービス

• ReportService

3. サーチターゲティングの機能変更

リクエストにおいて、以下を変更しました。

• keywordsとkeywordIdsの指定が必須ではなくなり、両方同時指定のみ不可に変更
• keywordsの上限数を100から200に変更
• スペースの半角・全角の区別を廃止
• 以下の項目を追加
  　　- sortField（ソート項目）
  　　- sortType（ソート方法）
  　　- matchType（検索方法）

また、レスポンスに「releaseDate」（キーワード追加日）を追加しました。

対象ウェブサービス

• SearchKeywordIdeaService

4. システムの保守、改善の実施

システムの保守、改善として以下を実施しました。 「Serviceの変更による各Versionへの影響」の項目も、あわせてご確認ください。

• ReportDefinitionServiceおよびReportServiceから、古いレポート項目を削除
• 仕様書のレポートフィールド集に「動作区分/Behavior Type」列を追加
  各レポートフィールドの動作を表す「動作区分/Behavior Type」列を追加しました。
  ※提供中の全バージョンが対象です。

対象ウェブサービス

• ReportDefinitionService
• ReportService
• StatsService

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

Service	V201809以前	V201812
ConversionTrackerService	・以下の指標で、広告クリックのコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv	・以下の指標で、広告クリックおよび10秒以上の動画視聴のコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv ・以下の指標を新たに追加 　- conversionsViaAdClick 　- conversionRateViaAdClick 　- convValueViaAdClick 　- costPerConvViaAdClick 　- valuePerConvViaAdClick 　- crossDeviceConversions ・動画の視聴からコンバージョンが発生するまでの測定期間を設定する項目「measurementPeriodView」を追加
StatsService	・以下の指標で、広告クリックのコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv ・以下のレポート項目を表示 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays	・以下の指標で、広告クリックおよび10秒以上の動画視聴のコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv ・以下の指標を新たに追加 　- conversionsViaAdClick 　- conversionRateViaAdClick 　- convValueViaAdClick 　- costPerConvViaAdClick 　- valuePerConvViaAdClick 　- crossDeviceConversions ・以下のレポート項目を削除 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays
AdGroupAdService	・動画視聴コンバージョン用ビーコンURLを登録できない	・動画視聴コンバージョン用ビーコンURLを登録できる ・動画視聴コンバージョン用ビーコン関連の以下項目を追加 　- videoStartBeaconUrls 　- isRemoveVideoStartBeaconUrls 　- video3SecBeaconUrls 　- isRemoveVideo3SecBeaconUrls 　- videoPaidBeaconUrls 　- isRemoveVideoPaidBeaconUrls 　- videoCompleteBeaconUrls 　- isRemoveVideoCompleteBeaconUrls
ReportDefinitionService	・以下のレポート項目を表示 　- totalConversionsOld 　- totalConversionRateOld 　- convValueOld 　- costTotalConversionsOld 　- valuePerConvOld 　- totalRevenueOld 　- revenueTotalConversionOld 　- revenue 　- revenuePerConv 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays	・以下の指標で、広告クリックおよび10秒以上の動画視聴のコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv ・以下の指標を新たに追加 　- conversionsViaAdClick 　- conversionRateViaAdClick 　- convValueViaAdClick 　- costPerConvViaAdClick 　- valuePerConvViaAdClick 　- crossDeviceConversions ・以下のレポート項目を削除 　- totalConversionsOld 　- totalConversionRateOld 　- convValueOld 　- costTotalConversionsOld 　- valuePerConvOld 　- totalRevenueOld 　- revenueTotalConversionOld 　- revenue 　- revenuePerConv 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays
ReportService	・以下のレポート項目を表示 　- totalConversionsOld 　- totalConversionRateOld 　- convValueOld 　- costTotalConversionsOld 　- valuePerConvOld 　- totalRevenueOld 　- revenueTotalConversionOld 　- revenue 　- revenuePerConv 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays	・以下の指標で、広告クリックおよび10秒以上の動画視聴のコンバージョンを測定 　- convRate 　- convValue 　- costPerConv 　- valuePerConv 　- allConv 　- allConvRate 　- allConvValue 　- costPerAllConv 　- valuePerAllConv ・以下の指標を新たに追加 　- conversionsViaAdClick 　- conversionRateViaAdClick 　- convValueViaAdClick 　- costPerConvViaAdClick 　- valuePerConvViaAdClick 　- crossDeviceConversions ・以下のレポート項目を削除 　- totalConversionsOld 　- totalConversionRateOld 　- convValueOld 　- costTotalConversionsOld 　- valuePerConvOld 　- totalRevenueOld 　- revenueTotalConversionOld 　- revenue 　- revenuePerConv 　- videoViewedRate 　- videoPlays 　- autoVideoPlays 　- clickVideoPlays
SearchKeywordIdeaService	・リクエストで、keywordsとkeywordIdsの指定が必須	・リクエストでkeywordsとkeywordIdsの指定が必須ではなくなる。また、以下の項目の指定が可能。 　-searchMatchType 　-sortField 　-sortKey ・レスポンスで、releaseDate項目を追加
AuditLogService		・動画視聴コンバージョン用ビーコン関連の以下項目を追加 　- videoStartBeaconUrls 　- video3SecBeaconUrls 　- videoPaidBeaconUrls 　- videoCompleteBeaconUrls
BulkService		・動画視聴コンバージョン用ビーコン関連の以下項目を追加 　- videoStartBeaconUrls 　- video3SecBeaconUrls 　- videoPaidBeaconUrls 　- videoCompleteBeaconUrls

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

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

• サポート終了日：2019年1月15日（火）
• システム終了日：2019年4月15日（月）