Dimensión: date_hour

los date_hour La dimensión proporciona datos analíticos en segmentos por hora. El usuario puede especificar los parámetros desde y hasta en aaaa-MM-dd o tiempo de época en milisegundos formato. Para informar sobre un lapso de horas, deberá usar el formato de milisegundos, con valores hacia y desde dentro de las horas de inicio y finalización en las que desea realizar la consulta. Cualquier intervalo de fechas especificado por el usuario se interpretará en la zona horaria actual de la cuenta. date_hour los informes solo son válidos para rangos dentro de los últimos 32 días. Si el valor de from es de hace más de 32 días, se devolverá un error.

Resumen

La dimensión date_hour proporciona datos analíticos en segmentos por hora. El usuario puede especificar los parámetros desde y hasta en aaaa-MM-dd o tiempo de época en formato de milisegundos. Para informar sobre un lapso de horas, deberá usar el formato de milisegundos, con valores hacia y desde dentro de las horas de inicio y finalización en las que desea realizar la consulta. Cualquier intervalo de fechas especificado por el usuario se interpretará en la zona horaria actual de la cuenta. date_hour los informes solo son válidos para rangos dentro de los últimos 32 días. Si el valor de from es de hace más de 32 días, se devolverá un error.

Parámetros de URL

Los informes de la API de Analytics admiten los siguientes parámetros de URL.

Parámetros de URL
Parámetro Descripción Requerido Valores Predeterminado
account Las cuentas sobre las que desea informar sí uno o más ID de cuenta como una lista delimitada por comas ninguno
dimensions Las dimensiones sobre las que informar sí una o más dimensiones como una lista delimitada por comas (algunas combinaciones no son válidas; use la herramienta interactiva aquí para determinar si una combinación es válida) ninguno
where Se utiliza para especificar filtros para informes. no {dimensión}=={valor}: uno o más como una lista delimitada por punto y coma. El valor será uno o más valores para la métrica principal de esa dimensión. Por ejemplo: video==video_id , country=country-code , o viewer=viewer_id (en este último caso, la forma del viewer_id variará dependiendo de si usted mismo está capturando y enviando algún tipo de viewer_id o dependiendo del valor generado por el sistema de análisis). ninguno
limit Número de artículos a devolver no entero positivo 10
offset Número de elementos para omitir no entero positivo 0
sort Campo en el que ordenar los elementos no cualquier campo que está siendo devuelto por la solicitud video_view
fields Campos para devolver no varía según la dimensión sobre la que está informando vídeo,vista_de_video
format Formato para devolver resultados en no json (predeterminado) | CSV | xlxs json
reconciled Si se incluye, limitará los resultados a datos históricos o en tiempo real. Los datos de análisis se derivan de varias fuentes: algunos los envía el reproductor, pero otros datos se recopilan de los CDN y el sistema Video Cloud. Para entregar análisis lo más rápido posible, comenzamos a entregar datos "en tiempo real" tan pronto como estén disponibles, y luego ajustamos los análisis más tarde cuando los datos de todas las fuentes se han recopilado y procesado. Los datos totalmente procesados se denominan reconciliados. no verdadero | falso verdadero
from El comienzo del rango de fechas para la solicitud no Uno de los siguientes:
  • Una fecha ISO 8601 (AAAA-MM-DD)
  • Tiempo de época en milisegundos (ejemplo: 1659641316719 [= jueves, 4 de agosto de 2022 7:28:36.719 p. m. GMT]). Ver el convertidor de tiempo de Epoch.
  • Una cuerda: from=alltime
  • +/- fechas relativas en días (d), semanas (w) o meses (m) - ejemplo: from=-6m&to=%2B2w (el período desde hace 6 meses hasta 2 semanas después de eso; tenga en cuenta que el signo + debe codificarse como URI %2B)

Solo se permiten las fechas dentro de los últimos 32 días para los puntos de finalización del compromiso o si se concilian = false.

 -30d
to El final del rango de fechas para la solicitud no Uno de los siguientes:
  • Una fecha ISO 8601 (AAAA-MM-DD)
  • Tiempo de época en milisegundos (ejemplo: 1659641316719 [= jueves, 4 de agosto de 2022 7:28:36.719 p. m. GMT]). Ver el convertidor de tiempo de Epoch.
  • Una cuerda: to=now
  • +/- fechas relativas en días (d), semanas (w) o meses (m) - ejemplo: from=-6m&to=%2B2w (el período desde hace 6 meses hasta 2 semanas después de eso; tenga en cuenta que el signo + debe codificarse como URI %2B)

Solo se permiten las fechas dentro de los últimos 32 días para los puntos de finalización del compromiso o si se concilian = false.

 ahora

Campos disponibles

Los siguientes campos se pueden devolver para la dimensión.

  • ad_mode_begin- la cantidad de veces que el jugador ingresó al modo de anuncios
  • ad_mode_complete- la cantidad de veces que el jugador completó el modo de anuncio
  • date_hour- la fecha y hora en formato de fecha y hora ISO 8601
  • engagement_score- la puntuación media de interacción de los vídeos
  • play_request- número total de veces que se solicitó la reproducción de video
  • play_rate- la tasa de reproducción promedio (vistas de video divididas por impresiones) para videos
  • player_load- el número total de cargas de jugadores
  • video_impression- la cantidad total de veces que se cargaron videos en los reproductores
  • video_percent_viewed- porcentaje total de visualizaciones de todas las visualizaciones de vídeo (una suma, no un promedio)
  • video_seconds_viewed- el total de segundos vistos para todos los videos
  • video_view- la cantidad total de veces que comenzó la reproducción de video

Filtrar valores

Si se utiliza como filtro, una dimensión le permite limitar los resultados.

Valores de filtro: La dimensión date_hour no se utiliza como filtro.

Combinando dimensiones

Para ver con qué dimensiones se puede combinar esto y qué campos están disponibles para la combinación, consulte Dimensión y campos.

Ejemplos de solicitud

Solicitud de dimensión

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=date_hour&from=-6h

Solicitud de filtro

    No aplica
Respuesta de muestra 
{
  "item_count": 7,
  "items": [
    {
      "date_hour": "2022-05-30T11:00:00-04:00",
      "vista_de_video": 8
    },
    {
      "date_hour": "2022-05-30T10:00:00-04:00",
      "vista_de_video": 11
    },
    {
      "date_hour": "2022-05-30T08:00:00-04:00",
      "vista_de_video": 26
    },
    {
      "date_hour": "2022-05-30T07:00:00-04:00",
      "vista_de_video": 30
    },
    {
      "date_hour": "2022-05-30T09:00:00-04:00",
      "vista_de_video": 34
    },
    {
      "date_hour": "2022-05-30T06:00:00-04:00",
      "vista_de_video": 43
    },
    {
      "date_hour": "2022-05-30T05:00:00-04:00",
      "vista_de_video": 46
    }
  ],
  "resumen": {
    "vista_de_video": 198
  }
}