Puntos finales de análisis en vivo
Además de live_stream
dimensión tratada en este tema, también hay puntos finales especiales para recuperar datos analíticos adicionales para trabajos de transmisión en vivo de Brightcove. Ver el Referencia de la API de Analytics para detalles.
Parámetros de URL
Los informes de la API de Analytics admiten los siguientes 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:
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:
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.
bytes_delivered
- bytes totales entregados para transmisiones en vivo, incluido el reproductor y todos los medios asociadosorigin_bytes_delivered
- bytes entregados para las propias transmisiones en vivolive_stream
- id de la transmisión en vivo, si está disponible
Filtrar valores
Si se utiliza como filtro, una dimensión le permite limitar los resultados.
Valores de 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=live_stream
Solicitud de filtro
No aplica
Respuesta de muestra
{
"item_count": 1,
"items": [
{
"live_stream": nulo
}
],
"resumen": {}
}