Points de terminaison d'analyse en direct
En plus de live_stream
dimension couverte dans cette rubrique, il existe également des points de terminaison spéciaux pour récupérer des données d'analyse supplémentaires pour les tâches de streaming Brightcove Live. Voir le Référence de l'API d'analyse pour les détails.
Paramètres d'URL
Les rapports de l'API Analytics prennent en charge les paramètres d'URL suivants.
Paramètre | Description | Obligatoire | Valeurs | Défaut |
---|---|---|---|---|
account |
Les comptes sur lesquels vous souhaitez créer un rapport | Oui | un ou plusieurs identifiants de compte sous forme de liste délimitée par des virgules | aucun |
dimensions |
La ou les dimensions à signaler | Oui | une ou plusieurs dimensions sous forme de liste délimitée par des virgules (certaines combinaisons ne sont pas valables - utilisez l'outil interactif ici pour déterminer si une combinaison est valable) | aucun |
where |
Utilisé pour spécifier des filtres pour les rapports | non | {dimension}=={valeur} - un ou plusieurs éléments sous forme de liste délimitée par des points-virgules. La valeur sera une ou plusieurs valeurs pour la métrique primaire de cette dimension. Par exemple : video==video_id country=country-code , ou viewer=viewer_id (dans ce dernier cas, la forme du viewer_id varie selon que vous capturez et envoyez vous-même une sorte de viewer_id ou selon la valeur générée par le système d'analyse). |
aucun |
limit |
Nombre d'articles à retourner | non | entier positif | 10 |
offset |
Nombre d'éléments à ignorer | non | entier positif | 0 |
sort |
Champ sur lequel trier les éléments | non | tout champ renvoyé par la requête | Video_View |
fields |
Champs à retourner | non | varie en fonction de la dimension sur laquelle vous créez un rapport | video,video_view |
format |
Format pour renvoyer les résultats dans | non | json (par défaut) | csv | xlxs | json |
reconciled |
Si elle est incluse, elle limitera les résultats aux données historiques ou en temps réel. Les données analytiques proviennent de plusieurs sources : certaines sont envoyées par le lecteur, mais d'autres sont collectées à partir des CDN et du système Video Cloud. Afin de fournir des analyses le plus rapidement possible, nous commençons à fournir des données « en temps réel » dès qu'elles sont disponibles, puis nous ajustons les analyses ultérieurement lorsque les données de toutes les sources ont été collectées et traitées. Les données entièrement traitées sont appelées réconciliées | non | vrai | faux | true |
from |
Le début de la plage de dates de la demande | non |
L'un des éléments suivants :
Seules les dates des 32 derniers jours sont autorisées pour les points finaux d'engagement ou si reconciled=false. |
-30d |
to |
La fin de la plage de dates pour la demande | non |
L'un des éléments suivants :
Seules les dates des 32 derniers jours sont autorisées pour les points finaux d'engagement ou si reconciled=false. |
maintenant |
Champs disponibles
Les champs suivants peuvent être renvoyés pour la dimension.
bytes_delivered
- nombre total d'octets délivrés pour les flux en direct, y compris le lecteur et tous les médias associésorigin_bytes_delivered
- octets délivrés pour les flux en direct eux-mêmeslive_stream
- id du flux en direct, si disponible
Filtrer les valeurs
Utilisée comme filtre, une dimension permet d'affiner les résultats.
Filtrer les valeurs :
Combinaison de dimensions
Pour voir avec quelles dimensions cet élément peut être combiné et quels champs sont disponibles pour la combinaison, voir Dimension et champs.
Exemples de demandes
Demande de dimension
https ://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=live_stream
Demande de filtre
N'est pas applicable
Exemple de réponse
{
"item_count" : 1,
"items" : [
{
"live_stream" : null
}
],
"résumé" : {}
}