サポート問い合わせ先
システムステータス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）。 エンゲージメントエンドポイント、またはreconciled = falseの場合、過去32日以内の日付のみが許可されます。 | 今から30日前 |
to |
リクエストの日付範囲の終わり | いいえ | ISO 8601の日付（YYYY-MM-DD）、ミリ秒単位のエポック時間、現在の文字列、または相対データ（+ 7d）。 エンゲージメントエンドポイント、またはreconciled = falseの場合、過去32日以内の日付のみが許可されます。 | 今 |
利用可能なフィールド
次のフィールドがディメンションに対して返されます。
ad_mode_begin-回数 player 広告モードに入ったad_mode_complete-回数 player 完成した広告モードdate_hour- ISO 8601日時フォーマットの日時engagement_score- 動画の平均エンゲージメントスコア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