The date_hour dimension provides analytics data in hourly segments. The user can specify the from and to parameters in yyyy-MM-dd or epoch time in milliseconds format. To report over a span of hours, you will need to use the milliseconds format, with to and from values falling within the start and end hours that you want to query on. Any date range specified by the user will be interpreted to the current timezone for the account. date_hour reports are only valid for ranges within the past 32 days. If the from value is more than 32 days ago, an error will be returned.
Analytics API reports support the following URL parameters.
||The accounts you want to report on||yes||one or more account ids as a comma-delimited list||none|
||The dimension(s) to report on||yes||one or more dimensions as a comma-delimited list (some combinations are not valid)||none|
||Number of items to return||no||positive integer||10|
||Number of items to skip||no||positive integer||0|
||Field to sort items on||no||a valid field for the request||video_view|
||Fields to return||no||varies according to the dimension you are reporting on||video_view|
||Format to return results in||no||json | csv | xlxs||json|
||The beginning of the date range for the request||no||An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string alltime, or relative date (-1m); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.||30 days prior to now|
||The end of the date range for the request||no||An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string now, or relative data (+7d); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.||now|
The following fields can be returned for the dimension.
ad_mode_begin- the number of times the player entered ad mode
ad_mode_complete- the number of times the player completed ad mode
date_hour- the date-time in ISO 8601 date-time format
engagement_score- the average engagement score for videos
play_request- total number of times video playback was requested
play_rate- the average play rate (video views divided by impressions) for videos
player_load- the total number of player loads
video_impression- the total number of times videos were loaded into players
video_percent_viewed- total percent viewed for all video views (a sum, not an average)
video_seconds_viewed- the total seconds viewed for all videos
video_view- the total number of times video playback began
Used as a filter, a dimension allows you to narrow the results.
Filter values: The date_hour dimension is not used as a filter.
To see what dimensions this on can be combined with, and what fields are available for the combination, see Dimension and Fields.
Response will appear here when you test a request