country
dimensión. La country
dimensión proporciona información sobre el país en el que se vieron los vídeos.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 |
where |
Se utiliza para especificar filtros para informes | no | {dimension} == {value} - uno o más como una lista delimitada por punto y coma | 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 anunciocountry
- el código de dos letras para el paíscountry_name
- el nombre del paísengagement_score
- la puntuación media de interacción de los vídeos reproducidos en un reproductorplay_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 un vídeoplayer_load
- el número de veces que se ha cargado un jugadorvideo_impression
- el número total de vídeos cargados en el reproductorvideo_percent_viewed
- la suma del porcentaje visto de vídeos en el reproductorvideo_seconds_viewed
- segundos totales de vídeos vistos en el reproductorvideo_view
- el total de veces que se inició la reproducción de vídeo en el reproductor
Valores de filtro
Utilizada como filtro, una dimensión permite limitar los resultados.
Valores de filtro: lista delimitada por comas de códigos de país ISO-3166-1, por ejemplo: KO, NOSOTROS
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=país
Solicitud de filtro
https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensions=City&where=país==US, GB, JA, KO&fields=nombre_país
Respuesta
La respuesta aparecerá aquí cuando pruebe una solicitud