サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    寸法: video

    このトピックでは、Analytics APIvideo寸法。ザ・videoディメンションは、ビデオによる分析を提供します。注:「ビデオ」を含めたい場合。フィールド(などvideo.name)応答では、クライアントの資格情報にCMSが含まれている必要があります。ビデオ読み取り許可。また、戻ることはできませんがvideo.custom_fields、あなたは戻ることができますvideo.custom_fields.{field_name}

    URL パラメータ

    分析 API レポートでは、次の URL パラメータがサポートされています。

    URL パラメータ
    パラメーター 説明 必須 デフォルト
    account 報告したいアカウント はい 1 つ以上のアカウント ID をカンマで区切ったリスト なし
    dimensions レポートするディメンション はい 1つ以上の次元をカンマで区切ったリスト (一部の組合せは無効です) なし
    where レポートのフィルタを指定するために使用します いいえ {ディメンション} == {value}-セミコロンで区切られたリストとして 1 つまたは複数 なし
    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)。エンゲージメントエンドポイントでは、過去 32 日以内の日付のみが許可されるか、または recalciled=false の場合も許可されます。 今までの30日前
    to リクエストの日付範囲の終わり いいえ ISO 8601 日付 (YYYY-MM-DD)、エポック時間 (ミリ秒)、現在の文字列、または相対データ (+7d)。エンゲージメントエンドポイントでは、過去 32 日以内の日付のみが許可されるか、または recalciled = false の場合に許可されます。 今すぐ

    使用可能なフィールド

    ディメンションの次のフィールドを返すことができます。

    • ad_mode_begin -プレイヤーが広告モードに入った回数
    • ad_mode_complete -プレイヤーが広告モードを完了した回数
    • bytes_delivered -プレーヤーと関連メディアのクライアントマシンに配信された合計バイト数
    • 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 -動画がプレーヤーに読み込まれた合計回数
    • 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または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 -オフライン再生が有効になっているビデオのダウンロードがエラーのために失敗した回数

    フィルタ値

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

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

    寸法を組み合わせる

    この組み合わせに使用できるディメンションと、その組み合わせで使用できるフィールドについては、ディメンションとフィールドを参照してください

    リクエスト例

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

        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

    応答

        リクエストをテストすると、応答がここに表示されます