Dimensión: video

En este tema, aprenderá acerca de la Analytics API video dimensión. La video dimension proporciona análisis por video. NOTA: si desea incluir algún "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 regresar video.custom_fields.{field_name}

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
  • bytes_delivered- bytes totales entregados a las máquinas cliente para el reproductor y los medios asociados
  • engagement_score- la puntuación de participación de 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) de un video
  • video- la identificación del video
  • video_duration- la duración del video (si se informa)
  • video_engagement_1- la cantidad de vistas en el punto del 1 por ciento 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- el número total de vistas en el punto del 75 por ciento de duración del video <
  • video_impression- la cantidad total de veces que se cargó el video en los reproductores
  • video_name- el nombre del video en el momento de la impresión más reciente en el período de tiempo
  • video_percent_viewed- la suma del porcentaje del video visto para todas las vistas de video. Por ejemplo, si hubo dos vistas en el período y el porcentaje de vistas en una vista fue del 78% y del 59% en la otra, el video_percent_viewed devuelto sería 137.
  • video_seconds_viewed- segundos totales vistos para cada vista de video
  • video_view- la cantidad 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- la 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 está actualmente ACTIVE o INACTIVE
  • video.tags- las etiquetas del video
  • video.updated_at- fecha / hora de la última modificación del video
  • 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 sin conexión
  • video_download_complete- número de veces que se descargó por completo un video habilitado para la reproducción sin conexión
  • video_download_cancellation- número de veces que se canceló la descarga de un video habilitado para la reproducción sin conexión (incluidas las veces que se cerró la página antes de que se completara la descarga)
  • video_download_error- número de veces que la descarga de un video habilitada para la reproducción sin conexión falló debido a un error

Filtrar valores

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

Valores de filtro: ID 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 de muestra 
{
	"item_count": 123,
	"items": [
		{
			"video": &quot;2180741085001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;4446941108001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;2535301903001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;5323136098001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;1732474228567874935&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;1723783757463121178&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;4454620114001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;5271819050001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;2026627035001&quot;,
			"vista_de_video": 1
		},
		{
			"video": &quot;4446941103001&quot;,
			"vista_de_video": 2
		}
	],
	"resumen": {
		"vista_de_video": 45136
	}
}