region
寸法。 の region
ディメンションは、動画が視聴されたブラウザに関する情報を提供します。ISO-3611-2地域コードを返します(例:US-WA)。 地域の定義方法は国によって異なりますURLパラメータ
Analytics API レポートは、次の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)。 過去32日以内の日付のみが許可されます engageエンドポイントを調整するか、reconciled = falseの場合。 | 今から30日前 |
to |
リクエストの日付範囲の終わり | いいえ | ISO 8601日付(YYYY-MM-DD)、ミリ秒単位のエポック時間、現在の文字列、または相対データ(+ 7d)。 過去32日以内の日付のみが許可されます engageエンドポイントを調整するか、reconciled = falseの場合。 | 今 |
利用可能なフィールド
次のフィールドがディメンションに対して返されます。
ad_mode_begin
-回数 player 広告モードに入ったad_mode_complete
-回数 player 完成した広告モードengagement_score
- 平均 engageで再生された動画のスコア playerplay_request
- 動画の再生が要求された合計回数play_rate
- 動画の平均再生率(動画の再生回数/表示回数)player_load
-回数a player 読み込まれたregion
- 標準的な地域の略語 - 「地域」としてカウントされるものは国によって異なりますregion_name
- 報告された場合、地域の名前video_impression
-に読み込まれた動画の総数 playervideo_percent_viewed
-での動画の視聴率の合計 playervideo_seconds_viewed
-で視聴されたビデオの合計秒数 playervideo_view
-でビデオ再生が開始された合計時間 player
フィルター値
フィルターとして使用すると、ディメンションを使用して結果を絞り込むことができます。
フィルター値:ISO-3611-2地域コードのコンマ区切りリスト - 例えばUS-WA
ディメンションの結合
これでどの次元と組み合わせることができるのか、そしてどのフィールドがその組み合わせに利用できるのかを見るためには、 寸法とフィールド.
リクエストの例
ディメンションリクエスト
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=region
フィルター要求
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=country&where=region==US-MA
対応
Response will appear here when you test a request