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

    寸法: 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 返品するアイテムの数 いいえ positive integer 10
    offset スキップするアイテムの数 いいえ positive integer 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日