soporte Contactar con asistencia técnica | estado del sistema Estado del Sistema
Contenido de la página

    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 uno o más identificadores de cuenta como una lista delimitada por comas ninguna
    dimensions La dimensión (s) para informar sobre 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

    Página actualizada por última vez el 12 jun 2020