Dimensión: date

En este tema, aprenderá acerca de la Analytics API dimensión de la fecha. La dimensión de fecha devuelve análisis de un solo día. El usuario puede especificar el from y to parámetros en aaaa-mm-dd formato. Esto permite a un usuario consultar el sistema de análisis para generar un informe por días dentro del from y to rango de fechas. Cualquier intervalo de fechas especificado por el usuario se interpretará en la zona horaria actual de la cuenta. Los rangos de fechas para la solicitud son inclusivos, exclusivos, es decir, si el usuario realiza una solicitud from=2013-09-24&to=2013-09-27 , la respuesta incluirá los resultados de 2013-09-24 00:00:00 a 2013-09-27 00:00:00.

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
  • active_media- la cantidad de videos activos en la cuenta
  • bytes_delivered- bytes totales entregados a las máquinas cliente para el reproductor y los medios asociados
  • daily_unique_viewers- usuarios únicos diarios promedio
  • date- la fecha en formato de fecha ISO 8601 (AAAA-MM-DD)
  • drm_bytes_packaged- el número de bytes DRM empaquetados
  • engagement_score- la puntuación media de interacción de los vídeos
  • licenses_served- el número de licencias DRM servidas
  • live_seconds_streamed- la cantidad total de segundos de transmisión en vivo entregados
  • 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_engagement_1- la cantidad total de vistas en el punto del 1 por ciento de duración del video
  • video_engagement_100- la cantidad total de vistas en el punto del 100 por ciento de duración del video
  • video_engagement_25- la cantidad total de vistas en el punto del 25 por ciento de duración del video
  • video_engagement_50- la cantidad total de vistas en el punto del 50 por ciento de duración del video
  • video_engagement_75- la cantidad total de vistas en el punto del 75 por ciento de duración del video
  • 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 de fecha 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

Solicitud de filtro

    No aplica
Respuesta de muestra 
{
  "item_count": 31,
  "items": [
    {
      "fecha": "2022-04-30",
      "vista_de_video": 160
    },
    {
      "fecha": "2022-05-07",
      "vista_de_video": 220
    },
    {
      "fecha": "2022-05-21",
      "vista_de_video": 226
    },
    {
      "fecha": "2022-05-08",
      "vista_de_video": 236
    },
    {
      "fecha": "2022-05-28",
      "vista_de_video": 261
    },
    {
      "fecha": "2022-05-29",
      "vista_de_video": 280
    },
    {
      "fecha": "2022-05-01",
      "vista_de_video": 307
    },
    {
      "fecha": "2022-05-03",
      "vista_de_video": 431
    },
    {
      "fecha": "2022-05-02",
      "vista_de_video": 512
    },
    {
      "fecha": "2022-05-30",
      "vista_de_video": 518
    }
  ],
  "resumen": {
    "vista_de_video": 45117
  }
}