Dimensión: video

Dimensión: video

En este tema, aprenderá sobre el Analytics API video dimensión. los video dimensión proporciona análisis por video. NOTA: si desea incluir cualquier "video". campos (como video.name) en la respuesta, sus credenciales de cliente deben incluir el CMS: permiso de lectura de video. También tenga en cuenta que si bien no puede regresar video.custom_fields, puedes volver video.custom_fields.{field_name}.

Parámetros de URL

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

Parámetros de URL
Parámetro	Descripción	Requerido	Valores	Predeterminado
`account`	Las cuentas que desea reportar	Sí	uno o más identificadores de cuenta como una lista delimitada por comas	ninguna
`dimensions`	La dimensión (s) para informar sobre	Sí	una o más dimensiones como una lista delimitada por comas (algunas combinaciones no son válidas)	ninguna
`where`	Se utiliza para especificar filtros para informes	no	{dimensión} == {valor} - uno o más como una lista delimitada por puntos y coma	ninguna
`limit`	Número de artículos a devolver	no	entero positivo	10
`offset`	Número de elementos a saltar	no	entero positivo	0
`sort`	Campo para ordenar los artículos en	no	un campo válido para la solicitud	video_view
`fields`	Campos para regresar	no	Varía de acuerdo con 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	cierto \| falso	verdadero
`from`	El comienzo del rango de fechas para la solicitud.	no	Una fecha ISO 8601 (AAAA-MM-DD), tiempo de época en milisegundos, la cadena de todos los tiempos o fecha relativa (-1m); solo se permiten fechas dentro de los últimos 32 días para los puntos finales del compromiso o si se reconcilia = falso.	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); solo se permiten fechas dentro de los últimos 32 días para los puntos finales del compromiso o si se reconcilia = falso.	ahora

Campos disponibles

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

ad_mode_begin - la cantidad de veces que player modo de anuncio ingresado
ad_mode_complete - la cantidad de veces que player modo de anuncio completado
bytes_delivered - bytes totales entregados a las máquinas cliente para player y medios asociados
engagement_score - el puntaje de compromiso para un video
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 un video
video - la identificación del video
video_duration - la duración del video (si se reporta)
video_engagement_1 - el número de visualizaciones en el punto porcentual de 1 del video
video_engagement_100 - el número total de reproducciones en el punto porcentual 100 de la duración del video
video_engagement_25 - el número total de reproducciones en el punto porcentual 25 de la duración del video
video_engagement_50 - el número total de reproducciones en el punto porcentual 50 de la duración del video
video_engagement_75 - el número total de reproducciones en el punto porcentual 75 de la duración del video <
video_impression - la cantidad total de veces que se cargó el video players
video_name - el nombre del video en el momento de la impresión más reciente en el marco de tiempo
video_percent_viewed - la suma del porcentaje del video visualizado para todas las vistas de video. Por ejemplo, si hubo dos vistas en el período, y el porcentaje visto en una vista fue 78%, y 59% en la otra, el video_percent_viewed devuelto sería 137.
video_seconds_viewed - segundos promedio vistos para cada vista de video
video_view - el número de veces que comenzó la reproducción de video
video.reference_id - la identificación de referencia del video
video.name - el nombre actual del video
video.description - La descripción actual del video.
video.complete - si el procesamiento de video está completo
video.created_at - la fecha / hora en que se creó el video
video.duration - duración actual del video
video.economics - si el video está habilitado para anuncios
video.long_description - La descripción larga del video.
video.state - si el video es actualmente ACTIVE or INACTIVE
video.tags - las etiquetas del video
video.updated_at - fecha / hora en que el video fue modificado por última vez
video.custom_fields.{field_name} - Valor para el campo personalizado del video llamado {field_name}
video_download_request - Número de solicitudes de descarga de un video habilitado para reproducción fuera de línea.
video_download_complete - Número de veces que se descargó completamente un video habilitado para la reproducción fuera de línea
video_download_cancellation - el número de veces que se canceló la descarga de un video habilitado para la reproducción fuera de línea (incluidas las veces que se cerró la página antes de que se completara la descarga)
video_download_error - el número de veces que la descarga de un video habilitado para reproducción fuera de línea falló debido a un error

Valores de filtro

Utilizado como filtro, una dimensión le permite restringir los resultados.

Valores de filtro: los identificadores de video como una lista delimitada por comas o video.q == {campo de video}: {valor}

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=video

Solicitud de filtro

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001

Respuesta

    Response will appear here when you test a request