サポート サポート問い合わせ先 | システムステータス システムステータス

寸法: video

このトピックでは、 Analytics API video 寸法。 の video ディメンションは、ビデオによる分析を提供します。 注:「動画」を含める場合。 フィールド(など video.name)レスポンスでは、クライアント認証情報にCMS:ビデオの読み取り権限が含まれている必要があります。 また、返品はできませんが video.custom_fields、あなたは戻ることができます video.custom_fields.{field_name}.

URLパラメータ

Analytics API レポートは、次のURLパラメータをサポートしています。

URLパラメータ
パラメーター 説明 必須 バリュー デフォルト
account レポートするアカウント はい カンマ区切りのリストとしてのXNUMXつ以上のアカウントID なし
dimensions レポートするディメンション はい コンマ区切りのリストとしてのXNUMXつ以上のディメンション(一部の組み合わせは無効です) なし
where レポートのフィルターを指定するために使用されます いいえ {dimension} == {value}-セミコロンで区切られたリストとしてのXNUMXつ以上 なし
limit 返品するアイテムの数 いいえ 正の整数 10
offset スキップするアイテムの数 いいえ 正の整数 0
sort アイテムを並べ替えるためのフィールド いいえ リクエストの有効なフィールド video_view
fields 返すフィールド いいえ レポートするディメンションによって異なります video_view
format 結果を返す形式 いいえ json | csv | xlxs JSON
reconciled 含まれている場合、結果を履歴データまたはリアルタイムデータに制限します いいえ 本当| 偽 true
from リクエストの日付範囲の始まり いいえ ISO 8601の日付(YYYY-MM-DD)、ミリ秒単位のエポック時間、文字列alltime、または相対日付(-1m)。 エンゲージメントエンドポイント、またはreconciled = falseの場合、過去32日以内の日付のみが許可されます。 今から30日前
to リクエストの日付範囲の終わり いいえ ISO 8601の日付(YYYY-MM-DD)、ミリ秒単位のエポック時間、現在の文字列、または相対データ(+ 7d)。 エンゲージメントエンドポイント、またはreconciled = falseの場合、過去32日以内の日付のみが許可されます。

利用可能なフィールド

次のフィールドがディメンションに対して返されます。

  • ad_mode_begin -回数 player 広告モードに入った
  • ad_mode_complete -回数 player 完成した広告モード
  • bytes_delivered -クライアントマシンに配信された合計バイト数 player および関連メディア
  • engagement_score - 動画のエンゲージメントスコア
  • play_request - 動画の再生が要求された合計回数
  • play_rate - 動画の平均再生率(動画の再生回数/表示回数)
  • video - 動画ID
  • video_duration - 動画の再生時間(報告されている場合)
  • video_engagement_1 - 動画の1パーセントポイントでの再生数
  • video_engagement_100 - ビデオ期間の100パーセントポイントでの合計再生回数
  • video_engagement_25 - ビデオ期間の25パーセントポイントでの合計再生回数
  • video_engagement_50 - ビデオ期間の50パーセントポイントでの合計再生回数
  • video_engagement_75 - ビデオ期間の75パーセントポイントでの総ビュー数<
  • video_impression -動画が読み込まれた合計回数 players
  • video_name - 時間枠内の最新のインプレッション時のビデオの名前
  • video_percent_viewed - すべての動画再生について表示された動画の割合の合計。 たとえば、期間内に2つのビューがあり、一方のビューで表示されている割合が78%、もう一方のビューで59%であるとします。 video_percent_viewed 返される 137.
  • video_seconds_viewed - 各動画ビューで視聴された平均秒数
  • video_view - 動画の再生が開始された回数
  • video.reference_id - 動画の参照ID
  • video.name - 動画の現在の名前
  • video.description - 動画の現在の説明
  • video.complete - ビデオ処理が完了したかどうか
  • video.created_at - 動画が作成された日時
  • video.duration - 動画の現在の期間
  • video.economics - 動画で広告が有効になっているかどうか
  • video.long_description - 動画の詳しい説明
  • video.state - 動画が現在のものかどうか ACTIVE or INACTIVE
  • video.tags - 動画のタグ
  • video.updated_at - 動画が最後に変更された日時
  • video.custom_fields.{field_name} - という名前の動画のカスタムフィールドの値 {field_name}
  • video_download_request - オフライン再生が有効になっている動画のダウンロード要求数
  • video_download_complete - オフライン再生が有効になっている動画が完全にダウンロードされた回数
  • video_download_cancellation - オフライン再生が有効になっている動画のダウンロードがキャンセルされた回数(ダウンロードが完了する前にページが閉じられた回数を含む)
  • video_download_error - オフライン再生が有効になっている動画のダウンロードがエラーのために失敗した回数

フィルター値

フィルターとして使用すると、ディメンションを使用して結果を絞り込むことができます。

フィルター値:コンマ区切りのリストとしてのビデオIDまたはvideo.q == {ビデオフィールド}:{値}

ディメンションの結合

これでどの次元と組み合わせることができるのか、そしてどのフィールドがその組み合わせに利用できるのかを見るためには、 寸法とフィールド.

リクエストの例

ディメンションリクエスト

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video

フィルター要求

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001

レスポンス

    Response will appear here when you test a request

ページの最終更新日:12年2020月XNUMX日