social_platform dimensión. los social_platform dimension proporciona análisis para plataformas sociales como Twitter, Facebook y YouTube, si distribuyó sus videos a esas plataformas utilizando el módulo Video Cloud Radius.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.
social_lifetime_seconds_viewed- los segundos de todos los tiempos vistos en la plataforma socialsocial_lifetime_views- reproducciones de videos de todos los tiempos en la plataforma socialsocial_platform- el nombre de la plataforma socialsocial_seconds_viewed- segundos de video vistos en la plataforma en el período de tiempo designadosocial_views- vistas de video en la plataforma en el período de tiempo designado
Filtrar valores
Si se utiliza como filtro, una dimensión le permite limitar los resultados.
Valores de filtro: facebook, twitter, youtube
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=social_platform
Solicitud de filtro
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=account&where=social_platform==twitter
Respuesta de muestra
{
"item_count": 0,
"elementos": [],
"resumen": {}
}