from
そしてto
のパラメータyyyy-mm-ddフォーマット。これにより、ユーザーは分析システムにクエリを実行して、from
そしてto
日付範囲。ユーザーが指定した日付範囲は、アカウントの現在のタイムゾーンに解釈されます。リクエストの日付範囲は包括的で、排他的です。つまり、ユーザーがリクエストを行った場合です。from=2013-09-24&to=2013-09-27
、応答には2013-09-2400:00:00から2013-09-2700:00:00までの結果が含まれます。URL パラメータ
分析 API レポートでは、次の URL パラメータがサポートされています。
パラメーター | 説明 | 必須 | 値 | デフォルト |
---|---|---|---|---|
account |
報告したいアカウント | はい | 1 つ以上のアカウント ID をカンマで区切ったリスト | なし |
dimensions |
レポートするディメンション | はい | 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
-プレイヤーが広告モードを完了した回数active_media
-アカウント内のアクティブな動画の数bytes_delivered
-プレーヤーと関連メディアのクライアントマシンに配信された合計バイト数daily_unique_viewers
-1日の平均ユニークユーザーdate
-ISO 8601 日付 (YYYY-MM-DD) 形式の日付drm_bytes_packaged
-パッケージ化された DRM バイト数engagement_score
-動画の平均エンゲージメントスコアlicenses_served
-提供された DRM ライセンスの数live_seconds_streamed
-配信されたライブストリーミングの合計秒数play_request
-ビデオ再生がリクエストされた合計回数play_rate
-動画の平均再生率(動画の視聴回数をインプレッション数で割ったもの)player_load
-プレーヤーの負荷の合計数video_engagement_1
-動画再生時間の 1% ポイントでの総再生数video_engagement_100
-動画再生時間の 100% ポイントにおける総再生数video_engagement_25
-動画再生時間の 25% ポイントでの総再生数video_engagement_50
-動画再生時間の 50% ポイントでの総再生数video_engagement_75
-動画再生時間の 75% ポイントにおける総再生数video_impression
-動画がプレイヤーにロードされた回数の合計video_percent_viewed
-すべての動画再生数の合計視聴率(平均ではなく合計)video_seconds_viewed
-すべての動画で視聴された合計秒数video_view
-ビデオ再生が開始された合計回数
フィルタ値
フィルタとして使用すると、ディメンションを使用して結果を絞り込むことができます。
フィルタ値:日付ディメンションはフィルタとして使用されません。
寸法を組み合わせる
この組み合わせに使用できるディメンションと、その組み合わせで使用できるフィールドについては、ディメンションとフィールドを参照してください。
リクエスト例
ディメンションリクエスト
https: //analytics.api.brightcove.com/V1/data? accounts=1752604059001&dimensions=日付
フィルタ要求
該当なし
応答
リクエストをテストすると、応答がここに表示されます