date_hour
ディメンションは、時間ごとのセグメントで分析データを提供します。 ユーザーはfromおよびtoパラメーターを yyyy-MM-dd or ミリ秒単位のエポック時間 フォーマット。 何時間にもわたってレポートするには、ミリ秒形式を使用する必要があります。toおよびfromの値は、クエリを実行する開始時間と終了時間の範囲内にあります。 ユーザーが指定した日付範囲は、アカウントの現在のタイムゾーンに解釈されます。 date_hour
レポートは、過去32日以内の範囲でのみ有効です。 from値が32日以上前の場合、エラーが返されます。概要
date_hourディメンションは、分析データを32時間ごとのセグメントで提供します。 ユーザーは、yyyy-MM-ddまたはエポック時間(ミリ秒形式)でfromおよびtoパラメーターを指定できます。 数時間にわたってレポートするには、ミリ秒形式を使用する必要があります。これには、クエリを実行する開始時間と終了時間内の値が含まれます。 ユーザーが指定した日付範囲は、アカウントの現在のタイムゾーンに解釈されます。 date_hourレポートは、過去32日間の範囲でのみ有効です。 from値がXNUMX日以上前の場合、エラーが返されます。
URLパラメータ
Analytics API レポートは、次のURLパラメータをサポートしています。
パラメーター | 説明 | 必須 | 価値観 | デフォルト |
---|---|---|---|---|
account |
レポートするアカウント | はい | カンマ区切りのリストとしてのXNUMXつ以上のアカウントID | なし |
dimensions |
レポートするディメンション | はい | コンマ区切りのリストとしてのXNUMXつ以上のディメンション(一部の組み合わせは無効です) | なし |
limit |
返品するアイテムの数 | いいえ | positive integer | 10 |
offset |
スキップするアイテムの数 | いいえ | positive integer | 0 |
sort |
アイテムを並べ替えるためのフィールド | いいえ | リクエストの有効なフィールド | video_view |
fields |
返すフィールド | いいえ | レポートするディメンションによって異なります | video_view |
format |
結果を返す形式 | いいえ | json | csv | xlxs | JSON |
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 完成した広告モードdate_hour
- ISO 8601日時フォーマットの日時engagement_score
- 平均 engage動画のスコアplay_request
- 動画の再生が要求された合計回数play_rate
- 動画の平均再生率(動画の再生回数/表示回数)player_load
-の総数 player 負荷video_impression
-動画が読み込まれた合計回数 playersvideo_percent_viewed
- すべての動画の再生回数の合計(平均ではなく合計)video_seconds_viewed
- すべての動画で閲覧された合計秒数video_view
- 動画の再生が開始された合計回数
フィルター値
フィルターとして使用すると、ディメンションを使用して結果を絞り込むことができます。
フィルター値:date_hourディメンションはフィルターとして使用されません。
ディメンションの結合
これでどの次元と組み合わせることができるのか、そしてどのフィールドがその組み合わせに利用できるのかを見るためには、 寸法とフィールド.
リクエストの例
ディメンションリクエスト
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=date_hour&from=-6h
フィルター要求
Not applicable
対応
Response will appear here when you test a request