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á a la zona horaria actual de la cuenta. Los intervalos 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á resultados de 2013-09-24 00:00:00 a 2013-09-27 00:00:00.Parámetros URL
Los informes de API de Analytics admiten los siguientes parámetros de URL.
Parámetros | Descripción | Obligatorio | Valores | Predeterminado |
---|---|---|---|---|
account |
Las cuentas sobre las que desea informar | yes | uno o más identificadores de cuenta como lista delimitada por comas | ninguno |
dimensions |
La (s) dimensión (s) que se debe informar sobre | yes | una o más dimensiones como una lista delimitada por comas (algunas combinaciones no son válidas) | 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 | un campo válido para la solicitud | video_view |
fields |
Campos a devolver | no | varía según la dimensión sobre la que está informando | video_view |
format |
Formato para devolver resultados en | no | json | csv | xlxs | json |
reconciled |
Si se incluye, limitará los resultados a datos históricos o en tiempo real. | no | true | false | true |
from |
El comienzo del intervalo de fechas para la solicitud | no | Una fecha ISO 8601 (AAAA-MM-DD), tiempo de época en milisegundos, la cadena alltime o la fecha relativa (-1m); sólo se permiten fechas dentro de los últimos 32 días para los extremos de interacción o si se reconcilian = false. | 30 días antes de ahora |
to |
El final del intervalo de fechas para la solicitud | no | Una fecha ISO 8601 (AAAA-MM-DD), tiempo de época en milisegundos, la cadena ahora o datos relativos (+7d); sólo se permiten fechas dentro de los últimos 32 días para los extremos de interacción o si se reconcilian = false. | ahora |
Campos disponibles
Se pueden devolver los siguientes campos para la dimensión.
ad_mode_begin
- el número de veces que el reproductor entró en el modo de anuncioad_mode_complete
- el número de veces que el reproductor completó el modo de anuncioactive_media
- el número de vídeos activos en la cuentabytes_delivered
- total de bytes entregados a las máquinas cliente para el reproductor y los medios asociadosdaily_unique_viewers
- promedio diario de usuarios únicosdate
- la fecha en formato de fecha ISO 8601 (AAAA-MM-DD)drm_bytes_packaged
- el número de bytes DRM empaquetadosengagement_score
- la puntuación media de participación de los vídeoslicenses_served
- el número de licencias DRM servidaslive_seconds_streamed
- el número total de segundos de transmisión en vivo entregadosplay_request
- número total de veces que se solicitó la reproducción de vídeoplay_rate
- la velocidad media de reproducción (vistas de vídeo divididas por impresiones) de los vídeosplayer_load
- el número total de cargas de jugadoresvideo_engagement_1
- el número total de visitas en el punto 1% de duración del vídeovideo_engagement_100
- el número total de visitas en el punto 100 por ciento de duración del vídeovideo_engagement_25
- el número total de visitas en el punto 25 por ciento de duración del vídeovideo_engagement_50
- el número total de visitas en el punto 50 por ciento de duración del vídeovideo_engagement_75
- el número total de visitas en el punto 75 por ciento de duración del vídeovideo_impression
- el número total de veces que los vídeos se cargaron en los reproductoresvideo_percent_viewed
- porcentaje total visualizado para todas las vistas de vídeo (una suma, no una media)video_seconds_viewed
- el total de segundos visualizados para todos los vídeosvideo_view
- el número total de veces que comenzó la reproducción de vídeo
Valores de filtro
Utilizada como filtro, una dimensión permite limitar los resultados.
Valores de filtro: La dimensión de fecha no se utiliza como filtro.
Combinación de dimensiones
Para ver en qué dimensiones se pueden combinar 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=fecha
Solicitud de filtro
No aplicable
Respuesta
La respuesta aparecerá aquí cuando pruebe una solicitud