Analytics par listes de lecture

Dans cet exemple, vous apprendrez comment utiliser le CMS API et Analytics API ensemble pour sélectionner une playlist dans votre compte et obtenir des données d'analyse pour toutes les vidéos de la playlist.

Contraintes

Vous devez récupérer les données de la liste de lecture et sélectionner une playlist avant de soumettre la demande à l'API Analytics
Pour les listes de lecture intelligentes, les données d'analyse sont renvoyées pour les vidéos actuellement dans la liste de lecture. Les données ne seront pas retournées pour les vidéos qui ne figurent plus dans la liste de lecture car elles ont été désactivées, supprimées ou supprimées car la définition de la playlist a changé
Si l'une des vidéos est également publiée dans un seul lecteur vidéo ou dans plusieurs playlists, vous devez spécifier le lecteur pour obtenir des données précises pour une playlist spécifique
Les données renvoyées incluent les données pour les vidéos individuelles ainsi que les valeurs cumulatives ou moyennes pour la liste de lecture
Si les données renvoyées n'incluent pas d'éléments pour toutes les vidéos de la liste de lecture, aucune donnée n'a été renvoyée pour ces vidéos sur la période spécifiée

Logique d'application

Il s'agit d'une application hybride qui utilise CMS API pour récupérer les informations de la liste de lecture, puis Analytics API pour récupérer des analyses pour les vidéos de la liste de lecture. Il y a une légère tournure : pour la playlist EXPLICITE (manuelle), les métadonnées incluent les identifiants vidéo, de sorte que nous pouvons les apporter directement à l'API Analytics ; pour les playlists intelligentes, cependant, nous devons revenir à CMS API l'utilisation des critères de recherche, de tri et de limiter la liste de lecture à obtenir les informations vidéo, que nous pouvons ensuite apporter à l'API Analytics :

Obtenir des informations

Pour obtenir un client_id et client_secret , vous devez aller à l'interface utilisateur OAuth et enregistrer cette application :

Gestion des informations d'identification d'authentification API

Voici les autorisations dont vous aurez besoin :

Vous pouvez également obtenir vos informations d'identification via CURL ou Postman - voir :

Si vous obtenez des informations d'identification directement à partir de l'API, voici les autorisations dont vous avez besoin :

      [
        "video-cloud/analytics/read",
        "video-cloud/video/read",
        "video-cloud/video/read"
      ]

CodePen

Code source

Trouvez tout le code associé à cet exemple dans ce dépôt GitHub.

Exemple d'application

Voir l' exemple d'API Pen Analytics/CMS : Analytics par playlists par Brightcove Learning Services (@rcrooks1969 ) sur CodePen.

Utilisation du CodePen

Voici quelques conseils pour utiliser efficacement le CodePen ci-dessus :

Basculez l'affichage réel de l'application en cliquant sur le bouton Résultat .
Cliquez sur les boutons HTML/CSS/JS pour afficher L'UN des types de code.
Cliquez sur Modifier sur CodePen dans le coin supérieur droit pour incorporer ce CodePen dans votre propre compte.
Trouvez tout le code associé à cet exemple dans ce dépôt GitHub.

Code proxy

Afin de construire votre propre version de l'exemple d'application sur cette page, vous devez créer et héberger votre propre proxy. (Les proxy utilisés par Brightcove Learning Services acceptent uniquement les demandes des domaines Brightcove.) Un exemple de proxy, très similaire à celui que nous utilisons, mais sans les contrôles qui bloquent les demandes provenant de domaines non-BrightCove, peut être trouvé dans ce dépôt GitHub. Vous trouverez également des instructions de base pour l'utiliser là-bas, ainsi qu'un guide plus élaboré pour créer des applications autour du proxy dans Utilisation des API REST.