ディメンション： region

寸法： region

このトピックでは、 Analytics API region 寸法。の region ディメンションは、動画が視聴されたブラウザに関する情報を提供します。ISO-3611-2地域コードを返します（例：US-WA）。地域の定義方法は国によって異なります

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 完成した広告モード
engagement_score -で再生された動画の平均エンゲージメントスコア player
play_request - 動画の再生が要求された合計回数
play_rate - 動画の平均再生率（動画の再生回数/表示回数）
player_load -回数a player 読み込まれた
region - 標準的な地域の略語 - 「地域」としてカウントされるものは国によって異なります
region_name - 報告された場合、地域の名前
video_impression -に読み込まれた動画の総数 player
video_percent_viewed -での動画の視聴率の合計 player
video_seconds_viewed -で視聴されたビデオの合計秒数 player
video_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

寸法： region