Ce document décrit les similitudes et les différences d'accès aux données YouTube Analytics entre les API YouTube Analytics et YouTube Reporting. L'objectif du document est de vous aider à choisir l'API adaptée à votre application.
Ces deux API permettent aux développeurs de récupérer les données YouTube Analytics. En outre, les deux API sont compatibles avec les propriétaires de chaîne et les propriétaires de contenu YouTube, qui ont chacun accès à un ensemble spécifique de rapports:
-
Les rapports sur les canaux contiennent les métriques d'activité des utilisateurs pour un canal spécifié.
-
Les rapports de propriétaires de contenu regroupent les métriques de toutes les chaînes associées à un propriétaire de contenu YouTube spécifique. Par exemple, une maison de disques peut récupérer un rapport contenant des statistiques combinées pour les chaînes YouTube de tous les artistes de cette maison de disques. Certains rapports sur les propriétaires de contenu contiennent des métriques sur l'activité des utilisateurs, d'autres sur les revenus et les performances des annonces.
L'API Reporting permet également à certains propriétaires de contenu d'accéder aux rapports sur les revenus publicitaires gérés par le système. Les données des rapports gérés par le système ne peuvent être récupérées qu'avec l'API Reporting.
Toutes les demandes de l'API YouTube Analytics et YouTube Reporting doivent être autorisées par la chaîne ou le propriétaire de contenu qui détient les données demandées.
Contenu du rapport
Les rapports récupérés par les API contiennent deux types de données:
-
Les dimensions sont des critères couramment utilisés pour regrouper les données, comme la date de l'activité de l'utilisateur ou le pays où il se trouvait.
Dans un rapport, chaque ligne de données comporte une combinaison unique de valeurs des dimensions. Par conséquent, la combinaison de valeurs des dimensions de chaque ligne sert de clé primaire pour cette ligne.
-
Les métriques correspondent à des mesures individuelles de l'activité des utilisateurs, des performances des annonces ou des revenus estimés. Les métriques d'activité des utilisateurs incluent le nombre de vues et les avis sur les vidéos ("J'aime" et "Je n'aime pas").
Choisissez l'API adaptée à votre application
- L'API YouTube Analytics
- L'API YouTube Analytics permet de générer des requêtes ciblées en temps réel pour générer des rapports YouTube Analytics personnalisés. L'API fournit des paramètres de filtrage et de tri. L'application appelante n'a donc pas besoin de prendre en charge de manière native ces fonctions.
Chaque requête API spécifie la plage de dates pour laquelle les données seront renvoyées. L'API vous permet également de récupérer des ensembles de données hebdomadaires et mensuels. Par conséquent, l'application appelante n'a pas besoin de stocker des ensembles de données récupérés ni de statistiques globales sur différentes plages de dates. - API de création de rapports YouTube
- L'API YouTube Reporting récupère les rapports groupés contenant les données YouTube Analytics pour une chaîne ou un propriétaire de contenu. Il est conçu pour les applications qui peuvent importer de grands ensembles de données et qui fournissent des outils pour filtrer, trier et explorer ces données.
Chaque rapport contient un ensemble prédéfini de champs. Les développeurs utilisent l'API pour planifier les tâches de création de rapports, chacune identifiant un rapport que YouTube doit générer. YouTube génère ensuite un rapport quotidien qui peut être téléchargé de manière asynchrone. Chaque rapport contient des données sur une période unique de 24 heures.
De plus, YouTube génère automatiquement un ensemble de rapports gérés par le système pour les propriétaires de contenu qui ont accès aux rapports correspondants dans YouTube Creator Studio. Ces rapports fournissent un accès programmatique aux données sur les revenus publicitaires. - Activité des utilisateurs liée aux sous-titres
- Données sur la rétention d'audience pour les playlists
- Rapports sur les revenus estimés pour les propriétaires de contenu (deux rapports différents sont disponibles)
- Rapports sur les assets pour les propriétaires de contenu (11 rapports différents sont disponibles)
Rapports acceptés
Le tableau suivant identifie les différents types de rapports que vous pouvez récupérer à l'aide des API. Les requêtes ciblées sont disponibles via l'API YouTube Analytics, tandis que les rapports groupés sont disponibles via l'API YouTube Reporting.
Les données disponibles dans une API peuvent ne pas l'être dans l'autre. Par exemple, l'API YouTube Analytics vous permet de récupérer les métriques d'activité des utilisateurs sur une base hebdomadaire ou mensuelle, alors que l'API YouTube Reporting exige que vous agrégiez vous-même ces données. En revanche, l'API YouTube Reporting accepte les rapports sur les assets pour les propriétaires de contenu, mais ces données ne sont pas disponibles dans l'API YouTube Analytics.
| Types de rapports | |
|---|---|
| Signalements de vidéos | Compatible avec les chaînes (requêtes ou groupées) et les propriétaires de contenu (requêtes ou groupées). Les rapports sur les vidéos fournissent des statistiques sur toutes les activités des utilisateurs liées aux vidéos d'une chaîne ou d'un propriétaire de contenu. Par exemple, ces rapports indiquent le nombre de vues enregistrées par vos vidéos. Dans l'API YouTube Analytics, certains rapports sur les vidéos des propriétaires de contenu incluent également des métriques sur les revenus estimés et les performances des annonces. |
| Rapports sur les playlists | Compatible avec les chaînes (requêtes ou groupées) et les propriétaires de contenu (requêtes ou groupées). Les rapports sur les playlists fournissent des statistiques spécifiquement associées aux vues des vidéos d'une playlist. L'API YouTube Reporting accepte les rapports sur la rétention d'audience pour les playlists, mais pas l'API YouTube Analytics. |
| Rapport sur les performances des annonces | Compatible avec les propriétaires de contenu (requête ou groupés). Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant les lectures de la vidéo. Ces métriques tiennent compte de chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions. |
| Rapports sur les revenus prévisionnels | Compatible avec les propriétaires de contenu (groupés). Les rapports sur les revenus estimés correspondent au total des revenus estimés pour les vidéos provenant de sources publicitaires vendues par Google et d'autres sources. Ces rapports contiennent également des métriques sur les performances des annonces. Notez que les rapports gérés par le système contiennent des revenus réels. |
| Rapports sur les éléments | Compatible avec les propriétaires de contenu (groupés). Les rapports sur les assets fournissent des métriques sur l'activité des utilisateurs concernant les vidéos associées aux assets d'un propriétaire de contenu. Une vidéo est incluse dans le rapport d'un propriétaire de contenu si celui-ci a revendiqué la vidéo grâce à l'un des assets du propriétaire. La vidéo peut avoir été mise en ligne par le propriétaire du contenu ou par un autre utilisateur YouTube. |
| Rapports gérés par le système | Compatible avec les propriétaires de contenu qui ont accès aux rapports correspondants dans la section Rapports de Creator Studio. Les rapports gérés par le système fournissent les données réelles sur les revenus générés par les assets et les vidéos. Un rapport supplémentaire liste les vidéos revendiquées et les assets correspondants. Notez que tous les rapports Creator Studio ne sont actuellement pas disponibles dans l'API. Remarque:YouTube génère automatiquement des rapports gérés par le système pour les propriétaires de contenu qui ont accès aux rapports correspondants dans Creator Studio. Le processus de récupération de ces rapports est donc différent de celui des autres types de rapports de cette liste. Pour en savoir plus, consultez la documentation sur les rapports gérés par le système. |
Différences majeures
Le tableau suivant met en évidence les principales différences entre les API YouTube Analytics et Reporting.
| Caractéristique | L'API YouTube Analytics | API de création de rapports YouTube |
|---|---|---|
| Processus de récupération des données | Chaque requête API spécifie les dimensions et les métriques à afficher, ainsi que la période pour laquelle les données seront renvoyées. | Les applications planifient des tâches de création de rapports. Pour chaque tâche, YouTube génère des rapports quotidiens qui peuvent être téléchargés de manière asynchrone. |
| Périodes | Certains rapports de l'API indiquent la date à laquelle l'activité de l'utilisateur a eu lieu. Certains de ces rapports acceptent des dimensions pour agréger les métriques d'activité des utilisateurs par mois. | Tous les rapports de l'API indiquent le jour où l'activité de l'utilisateur a eu lieu. Les applications qui utilisent l'API peuvent implémenter des fonctionnalités pour agréger des données à intervalles réguliers. |
| Filtrer les données | Vous pouvez filtrer les rapports pour n'inclure que les lignes pour lesquelles une dimension a une valeur spécifique. L'API accepte également certaines dimensions, telles que continent et subContinent, qui ne sont utilisées qu'en tant que filtres. | L'API permet le téléchargement groupé d'ensembles de données complets. Il ne permet pas de filtrer ni de renvoyer des données pour les dimensions basées uniquement sur des filtres. L'application cliente stocke les données téléchargées et implémente ses propres fonctionnalités pour les filtrer. |
| Tri | Les rapports peuvent être triés en fonction des valeurs de métriques renvoyées. Certains rapports n'affichent qu'un nombre limité de résultats. Par exemple, le rapport qui liste les vidéos les plus regardées d'une chaîne ne peut pas contenir plus de 200 lignes. | Cette API permet le téléchargement groupé d'ensembles de données complets. Les applications clientes peuvent implémenter leurs propres fonctionnalités pour trier les données téléchargées. |
| Énumérations | Les rapports de l'API contiennent des valeurs textuelles, telles que "ANDROID" ou "CHANNEL", pour identifier les valeurs de dimension énumérées. | Les rapports de l'API contiennent des entiers pouvant être mappés avec des valeurs textuelles. |
| Quotas | Le serveur d'API évalue chaque requête pour déterminer son coût de quota. La section Utilisation du quota décrit la méthodologie plus en détail. | L'utilisation du quota n'est pas un problème, car les données sont récupérées une fois, puis filtrées, triées et interrogées dans l'application. |
| Rapports uniques |
|
|
| Dimensions uniques | groupe (dimension "filtre uniquement") continent (dimension "filtre uniquement") sous-continent (dimension "filtre uniquement") mois isCurated==1 (dimension "filtre uniquement") viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Métriques uniques | uniques relativeRetainPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_imp_clicks card_teaser_click_rate card_teaser_clicks card_teaser_impressions Estimated_partner_adsense_revenue } |
Différences de noms entre les API
Les deux API utilisent actuellement différentes conventions de dénomination pour identifier les dimensions et les métriques. Pour le moment, les noms de l'API YouTube Analytics utilisent camelCase, tandis que les noms de l'API YouTube Reporting utilisent des noms séparés par des traits de soulignement.
Les tableaux suivants identifient les différents noms utilisés par les deux API pour identifier les mêmes métriques et dimensions. Dans certains cas, la différence entre les deux noms est plus importante que ce que vous obtiendrez après avoir converti un nom de camelCase en traits de soulignement. Par exemple, la dimension video dans l'API YouTube Analytics s'appelle video_id dans l'API YouTube Reporting.