品質パラメーター quality-parameters
このトピックでは、コンテキストデータ値など、アドビがソリューション変数を通じて収集する Quality of Experience(QoE/QoS)データを示します。
表のデータの説明は次のとおりです。
-
実装: 実装に関する値と要件の詳細。
- キー - 変数。アプリで手動で設定するか、Adobe Media SDK によって自動的に設定されます。
- 必須 - 基本的なビデオトラッキングでパラメーターが必須かどうかを表します。
- 型 - 設定する変数の型(文字列または数値)を表します。
- 送信タイミング - データが送信されるタイミング。メディア開始 の場合はメディアの開始時に分析の呼び出しが送信され、広告開始 の場合は広告の開始時に分析の呼び出しが送信されます。終了 の場合は、メディアセッションや広告、チャプターなどの終了時に、コンパイル済みの分析の呼び出しがハートビートサーバーから分析サーバーに直接送信されます。終了の呼び出しは、ネットワークパケットの呼び出しでは利用できません。
- 最小のSDK のバージョン - パラメーターにアクセスするのに必要な SDK のバージョン。
- 値の例 - 変数の一般的な利用方法の例。
-
ネットワークパラメーター: Adobe Analytics またはハートビートサーバーに渡される値。この列には、Adobe Media SDK によって生成されるネットワーク呼び出しに含まれるパラメーターの名前が示されています。
-
レポート: ビデオデータの確認方法と分析方法に関する詳細。
- 利用可能 - デフォルトでもデータをレポートで確認できる場合は 可、カスタム設定が必要な場合は カスタム。
- 予約変数 - 予約変数で取得されるデータの形式(イベント、eVar、prop または分類)。
- レポート名 - Adobe Aanlytics の変数のレポート名。
- コンテキストデータ - レポートサーバーに渡され、処理ルールで使用される Adobe Analytics のコンテキストデータの名前。
- データフィード - クリックストリームまたはライブストリームデータフィード内の変数の列の名前。
- Audience Manager - Adobe Audience Manager 内の特性名。
品質メタデータ quality-metadata
平均ビットレート
実装
ネットワークパラメーター
レポート
- SDK キー:
bitrate - API キー:
media.qoe.bitrate - 必須:
いいえ - 型:
数値 - 送信タイミング:
終了 - 最小のSDK のバージョン: すべて可
- 値の例:
800-899 - 説明:
平均ビットレート(kbps)。値は、100 kbps の間隔で事前定義されたグループです。平均ビットレートは、再生セッション中に発生した再生時間に関連するすべてのビットレート値の加重平均として計算されます。
- Adobe Analytics:
(a.media.qoe.
bitrateAverageBucket) - ハートビート:
(l:stream:bitrate
)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
平均ビットレート - コンテキストデータ:
(a.media.qoe.
bitrateAverageBucket) - データフィード:
videoqoebitrateaverageevar - Audience Manager:
(c_contextdata.
a.media.qoe.
bitrateAverageBucket) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bitrateAverageBucket - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.
bitrate - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
bitrateAverageBucket
開始時間
実装
ネットワークパラメーター
レポート
- SDK キー:
- API キー:
media.qoe.timeToStart - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア開始、メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
30,000 - 説明:
この値は、QoSObject を使用して設定しない場合、デフォルトでは 0 に設定されます。この値はミリ秒単位で設定します。値は時間形式(HH:MM:SS)で表示されます
(Analysis Workspaceおよび Reports & Analytics において)。 データフィード、Data Warehouse およびレポート API では、値は秒単位で表示されます。
- Adobe Analytics:
(a.media.qoe.
timeToStart) - ハートビート:
(l:stream:startup_time
)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
開始時間 - コンテキストデータ:
(a.media.qoe.
timeToStart) - データフィード:
videoqoetimetostartevar - Audience Manager:
(c_contextdata.
a.media.qoe.
timeToStart) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.timeToStart.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.timeToStart - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.timeToStart
フレーム/秒
実装
ネットワークパラメーター
レポート
- SDK キー:
- API キー:
media.qoe.framesPerSecond - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア開始、メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
24 - 説明:
フレーム/秒単位のストリームフレームレートの現在の値。フィールドは、クローズコールで fps フィールドにマッピングされ、処理ルールを通じてアクセスできます。
- Adobe Analytics:
- ハートビート:
(l:stream:fps
)
- 利用可能:
不可 - 予約変数:
なし - レポート名:
なし - コンテキストデータ:
- データフィード:
なし - Audience Manager:
- XDM フィールドパス:
- コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.framesPerSecond - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.framesPerSecond
ドロップフレーム
実装
ネットワークパラメーター
レポート
- SDK キー:
droppedFrames - API キー:
media.qoe.droppedFrames - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
3 - 説明:
ドロップフレームの数(整数)。この値は、再生セッション中のすべてのドロップフレームの合計として計算されます。この値は、(l:stream:dropped_frames
)をクリックします。
- Adobe Analytics:
(a.media.qoe.
droppedFrameCount) - ハートビート:
(l:stream:
dropped_frames)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
ドロップフレーム - コンテキストデータ:
(a.media.qoe.
droppedFrameCount) - データフィード:
videoqoedroppedframecountevar - Audience Manager:
(c_contextdata.
a.media.qoe.
droppedFrameCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.droppedFrames.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.
droppedFrames - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
droppedFrames
バッファーイベント
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
2 - 説明:
バッファーイベントの数。この指標は、再生セッション中に発生した複数のバッファー状態の総数として計算されます。プレーヤーが他の状態(再生、一時停止など)からバッファー状態に移行した回数となります。
- Adobe Analytics:
(a.media.qoe.
bufferCount) - ハートビート:
(s:event:
type=buffer)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
バッファーイベント - コンテキストデータ:
(a.media.qoe.
bufferCount) - データフィード:
videoqoebuffercountevar - Audience Manager:
(c_contextdata.
a.media.qoe.
bufferCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.buffers.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.bufferCount
合計バッファー時間
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK バージョン:
- 値の例:
30 - 説明:
バッファリングに費やした合計時間(秒)。この値は、再生セッション中に発生したすべてのバッファーイベントの時間の合計として計算されます。値は時間形式(HH:MM:SS)で表示されます
(Analysis Workspaceおよび Reports & Analytics において)。 データフィード、Data Warehouse およびレポート API では、値は秒単位で表示されます。
リリース日:2018 年 9 月 13 日
- Adobe Analytics:
(a.media.qoe.
bufferTime) - ハートビート:
(l:event:duration
)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
合計バッファー時間 - コンテキストデータ:
(a.media.qoe.
bufferTime) - データフィード:
videoqoebuffertimeevar - Audience Manager:
(c_contextdata.
a.media.qoe.
bufferTime) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bufferTime.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.bufferTime
ビットレート変更
実装
ネットワークパラメーター
レポート
- SDK キー:
- API キー:
media.qoe.bitrateChange - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
3 - 説明:
ビットレートの変更数(整数)。この値は、再生セッション中に発生したすべてのビットレート変更イベントの合計として計算されます。
- Adobe Analytics:
(a.media.qoe.
bitrateChangeCount) - ハートビート:
(s:event:
type=bitrate_change)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
ビットレート変更 - コンテキストデータ:
(a.media.qoe.
bitrateChangeCount) - データフィード:
videoqoebitratechangecountevar - Audience Manager:
(c_contextdata.
a.media.qoe.
bitrateChangeCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bitrateChanges.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.
bitrateChangeCount - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
bitrateChangeCount
エラー/エラーイベント
実装
ネットワークパラメーター
レポート
- SDK キー:
- API キー:
- 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
1 - 説明:
エラーが発生した回数(整数)。この値は、再生セッション中に発生したすべてのエラーイベントの合計として計算されます。
- Adobe Analytics:
(a.media.qoe.
errorCount) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
エラー - コンテキストデータ:
(a.media.qoe.
errorCount) - データフィード:
videoqoeerrorcountevar - Audience Manager:
(c_contextdata.
a.media.qoe.
errorCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.errors.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.errorCount
プレーヤー SDK のエラー ID
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
- 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
- 説明:
プレーヤー SDK によって生成される固有のエラー ID。お客様は、実装時に提供されたエラー API を使用してエラーコードや ID を指定する必要があります。
- Adobe Analytics:
(a.media.qoe.
playerSdkErrors) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
Player SDK エラー ID - コンテキストデータ:
(a.media.qoe.
playerSdkErrors) - データフィード:
videoqoeplayersdkerrors - Audience Manager:
(c_contextdata.
a.media.qoe.
playerSdkErrors) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.playerSdkErrors - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
playerSdkErrors
外部エラー ID
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
- 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
- 説明:
任意の外部ソースからの一意のエラー ID(CDN エラーなど)。お客様は、実装時に提供されたエラー API を使用してエラーコードや ID を指定する必要があります。
- Adobe Analytics:
(a.media.qoe.
externalErrors) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
外部エラー ID - コンテキストデータ:
(a.media.qoe.
externalErrors) - データフィード:
videoqoeextneralerrors - Audience Manager:
(c_contextdata.
a.media.qoe.
externalErrors) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.externalSdkErrors - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
externalErrors
メディア SDK のエラー ID
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
- 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
- 説明:
再生時にメディア SDK によって生成される一意のエラー ID。
- Adobe Analytics:
(a.media.qoe.
mediaSdkErrors) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
eVar - 有効期限:
ヒット時 - レポート名:
カスタム - コンテキストデータ:
(a.media.qoe.
mediaSdkErrors) - データフィード:
mediaqoeexternalerrors - Audience Manager:
(c_contextdata.
a.media.qoe.
mediaSdkErrors) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.mediaSdkErrors - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
mediaSdkErrors
セッション終了 session-end
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
- 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: 2.1
- 値の例:
end - 説明:
end イベントは、SDK が close 呼び出しをバックエンドに送信したことを意味します。バックエンドがこのイベントを受信すると、そのビデオのセッションを終了し、それ以上処理をおこないません。
メディアが 100%まで完了した場合、これはs:event:type=complete.
の後に送信される必要があります。関連情報については、コンテンツ完了を参照してください。
- Adobe Analytics:
なし - ハートビート:
(s:event:type=end
)
- 利用可能:
カスタムの処理ルールを使用 - 予約変数:
イベント - レポート名:
なし - コンテキストデータ:
- データフィード:
なし - Audience Manager:
- XDM フィールドパス:
品質指標 quality-metrics
開始時間
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
30,000 - 説明:
この値は、QoSObject を使用して設定しない場合、デフォルトでは 0 に設定されます。この値はミリ秒単位で設定します。値は時間形式(HH:MM:SS)で表示されます
(Analysis Workspaceおよび Reports & Analytics において)。 データフィード、Data Warehouse およびレポート API では、値は秒単位で表示されます。
リリース日:2018 年 9 月 13 日
- Adobe Analytics:
(a.media.qoe.
timeToStart) - ハートビート:
(l:stream:startup_time
)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
開始時間 - コンテキストデータ:
(a.media.qoe.
timeToStart) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
timeToStart) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.timeToStart.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.timeToStart - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.timeToStart
バッファーイベント
実装
ネットワークパラメーター
レポート
- SDK キー:
startupTime - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
2 - 説明:
バッファーイベントの数(整数)。この指標は、再生セッション中に発生したバッファーイベントの総数として計算されます。
- Adobe Analytics:
(a.media.qoe.
bufferCount) - ハートビート:
(s:event:
type=buffer)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
バッファーイベント - コンテキストデータ:
(a.media.qoe.
bufferCount) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
bufferCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.buffers.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.bufferCount
合計バッファー時間
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
15 - 説明:
バッファリングに費やした合計時間(秒、整数)。この値は、再生セッション中に発生したすべてのバッファーイベントの時間の合計として計算されます。値は時間形式(HH:MM:SS)で表示されます
(Analysis Workspaceおよび Reports & Analytics において)。 データフィード、Data Warehouse およびレポート API では、値は秒単位で表示されます。
リリース日:2018 年 9 月 13 日
- Adobe Analytics:
(a.media.qoe.
bufferTime) - ハートビート:
(l:event:duration
)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
合計バッファー時間 - コンテキストデータ:
(a.media.qoe.
bufferTime) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
bufferTime) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bufferTime.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.bufferTime
ビットレート変更
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
イベント - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
3 - 説明:
ビットレートを変更した数。この値は、再生セッション中に発生したすべてのビットレート変更イベントの合計として計算されます。
- Adobe Analytics:
(a.media.qoe.
bitrateChangeCount) - ハートビート:
(s:event:
type=bitrate_change)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
ビットレート変更 - コンテキストデータ:
(a.media.qoe.
bitrateChangeCount) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
bitrateChangeCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bitrateChanges.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.
bitrateChangeCount - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
bitrateChangeCount
エラー
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
1 - 説明:
エラーが発生した回数(整数)。この値は、再生セッション中に発生したすべてのエラーイベントの合計として計算されます。
- Adobe Analytics:
(a.media.qoe.
errorCount) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
エラーイベント - コンテキストデータ:
(a.media.qoe.
errorCount) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
errorCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.errors.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.errorCount
ドロップフレーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
1 - 説明:
ドロップフレームの数(整数)。この値は、再生セッション中のすべてのドロップフレームの合計として計算されます。
- Adobe Analytics:
(a.media.qoe.
droppedFrameCount) - ハートビート:
(l:stream:
dropped_frames)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
ドロップフレーム - コンテキストデータ:
(a.media.qoe.
droppedFrameCount) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
droppedFrameCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.droppedFrames.value - コレクション XDM フィールドのパス:
mediaCollection.qoeDataDetails.
droppedFrames - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
droppedFrames
開始前にドロップ
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
TRUE - 説明:
ユーザーがビデオを開始する前に終了した回数。この指標は、広告とは無関係に、コンテンツがレンダリングされなかった場合に 1 に設定されます。
- Adobe Analytics:
(a.media.qoe.
dropBeforeStart) - ハートビート:
(s:event:
type=aa_start)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
開始前にドロップ - コンテキストデータ:
(a.media.qoe.
dropBeforeStart) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
dropBeforeStart) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.dropBeforeStarts.value >= 1 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
isDroppedBeforeStart
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
バッファーの影響を受けたストリーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
TRUE - 説明:
バッファリングの影響を受けたストリームの数。この指標は、再生セッション中に少なくとも 1 つのバッファーイベントが発生した場合にのみ、1 に設定されます。
- Adobe Analytics:
(a.media.qoe.
buffer) - ハートビート:
(s:event:
type=buffer)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
バッファーの影響を受けたストリーム - コンテキストデータ:
(a.media.qoe.
buffer) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
buffer) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bufferImpactedStreams.value >= 1 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
hasBufferImpactedStreams
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
ビットレート変更の影響を受けたストリーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
TRUE - 説明:
ビットレートの変更が発生したストリームの数。この指標は、再生セッション中に少なくとも 1 つのビットレート変更イベントが発生した場合にのみ、1 に設定されます。
- Adobe Analytics:
(a.media.qoe.
bitrateChange) - ハートビート:
(s:event:
type=bitrate_change)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
ビットレート変更の影響を受けたストリーム - コンテキストデータ:
(a.media.qoe.
bitrateChange) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
bitrateChange) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bitrateChangeImpactedStreams.value >= 1 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
hasBitrateChangeImpactedStreams
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
平均ビットレート
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
3200 - 説明:
平均ビットレート(kbps、整数)。この指標は、再生セッション中に発生した再生時間に関連するすべてのビットレート値の加重平均として計算されます。
- Adobe Analytics:
(a.media.qoe.
bitrateAverage) - ハートビート:
(l:stream:bitrate
)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
平均ビットレート - コンテキストデータ:
(a.media.qoe.
bitrateAverage) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
bitrateAverage) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.bitrateAverage.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
bitrateAverage
エラーの影響を受けたストリーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
TRUE - 説明:
エラーイベントが発生した(つまり、再生セッション中にtrackError
が呼び出され、type=error
ハートビート呼び出しが生成された)ストリームの数。
- Adobe Analytics:
(a.media.qoe.
error) - ハートビート:
(s:event:
type=error)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
エラーの影響を受けたストリーム - コンテキストデータ:
(a.media.qoe.
error) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
error) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.errorImpactedStreams.value > 0 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
hasErrorImpactedStreams
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
ドロップフレームの影響を受けたストリーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: すべて可
- 値の例:
TRUE - 説明:
ドロップフレームが発生したストリームの数。この指標は、再生セッション中に少なくとも 1 つのフレームがドロップした場合にのみ、1 に設定されます。
- Adobe Analytics:
(a.media.qoe.
droppedFrames) - ハートビート:
(l:stream:
dropped_frames)
- 利用可能:
可 - 予約変数:
イベント - レポート名:
ドロップフレームの影響を受けたストリーム - コンテキストデータ:
(a.media.qoe.
droppedFrames) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
droppedFrames) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.droppedFrameImpactedStreams.value >= 1 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.
hasDroppedFrameImpactedStreams
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
停止の影響を受けたストリーム
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: 1.5 以上
- 値の例:
TRUE - 説明:
停止されたイベントが発生したストリームの数。この指標は、再生セッション中に少なくとも 1 回、停止が発生した場合にのみ 1 に設定されます。レポートでこの値を参照できるようにするためには、独自の処理ルールを作成する必要があります。
- Adobe Analytics:
(a.media.qoe.
stall) - ハートビート:
(s:event:
type=stall)
- 利用可能:
カスタムの処理ルールを使用 - 予約変数:
イベント - レポート名:
カスタム - データフィード:
なし - コンテキストデータ:
(a.media.qoe.
stall) - Audience Manager:
(c_contextdata.
a.media.qoe.
stall) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.stallingImpactedStreams.value >= 1 => 「TRUE」 - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.hasStallImpactedStreams
IMPORTANT
このイベントを設定すると、値は TRUE のみになります。このイベントを設定しない場合は、値が送信されません。
停止イベント
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
文字列 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: 1.5 以上
- 値の例:
3 - 説明:
再生セッション中に再生が停止された回数。レポートでこの値を参照できるようにするためには、独自の処理ルールを作成する必要があります。
- Adobe Analytics:
(a.media.qoe.
stallCount) - ハートビート:
(s:event:
type=stall)
- 利用可能:
カスタムの処理ルールを使用 - 予約変数:
イベント - レポート名:
カスタム - コンテキストデータ:
(a.media.qoe.
stallCount) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
stallCount) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.stalls.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.stallCount
合計停止時間
実装
ネットワークパラメーター
レポート
- SDK キー:
自動設定 - API キー:
なし - 必須:
いいえ - 型:
数値 - 送信タイミング:
メディア終了 - 最小のSDK のバージョン: 1.5 以上
- 値の例:
12 - 説明:
再生セッション中に再生が停止された合計時間(秒、整数)。レポートでこの値を参照できるようにするためには、独自の処理ルールを作成する必要があります。
- Adobe Analytics:
(a.media.qoe.
stallTime) - ハートビート:
(s:event:
type=stall)
- 利用可能:
カスタムの処理ルールを使用 - 予約変数:
イベント - レポート名:
カスタム - コンテキストデータ:
(a.media.qoe.
stallTime) - データフィード:
なし - Audience Manager:
(c_contextdata.
a.media.qoe.
stallTime) - XDM フィールドのパス
:media.mediaTimed.primaryAssetViewDetails.
qoe.stallTime.value - レポート XDM フィールドのパス:
mediaReporting.qoeDataDetails.stallTime
関連する API related_apis_section
- Android - createQoSObject
- iOS - createQoSObjectWithBitrate
- JavaScript - createQoSObject
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb