Ce document explique les similitudes et les différences entre l'API YouTube Analytics et l'API YouTube Reporting pour accéder aux données YouTube Analytics. Vous pourrez ainsi choisir l'API adaptée à votre application.
Les deux API vous permettent de récupérer des données YouTube Analytics. De plus, les deux API sont compatibles avec les propriétaires de chaînes et de contenus YouTube, qui peuvent chacun accéder à un ensemble spécifique de rapports :
-
Les rapports sur les chaînes contiennent des métriques sur l'activité des utilisateurs pour une chaîne spécifique.
-
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 les statistiques cumulées des chaînes YouTube de tous les artistes qu'elle représente. Certains rapports sur les propriétaires de contenu contiennent des métriques sur l'activité des utilisateurs, tandis que d'autres contiennent des métriques liées aux revenus et aux performances des annonces.
L'API Reporting permet également à certains propriétaires de contenu d'accéder à des 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 requêtes envoyées aux API YouTube Analytics et YouTube Reporting doivent être autorisées par le propriétaire de la chaîne ou du 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 courants utilisés pour agréger les données, comme la date à laquelle l'activité de l'utilisateur s'est produite ou le pays dans lequel se trouvaient les utilisateurs.
Dans un rapport, chaque ligne de données présente une combinaison unique de valeurs de dimension. Ainsi, la combinaison de valeurs de dimension de chaque ligne sert de clé primaire pour cette ligne.
-
Les métriques sont 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 des vidéos et les notes (J'aime et Je n'aime pas).
Choisir l'API adaptée à votre application
- L'API YouTube Analytics
- L'API YouTube Analytics est compatible avec les requêtes ciblées en temps réel, et génère 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 ces fonctions de manière native.
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 les ensembles de données récupérés ni d'agréger les statistiques sur des plages de dates. - API de création de rapports YouTube
- L'API YouTube Reporting permet de récupérer des rapports groupés contenant des données YouTube Analytics pour une chaîne ou un propriétaire de contenu. Elle est conçue pour les applications qui peuvent importer de grands ensembles de données et qui fournissent des outils pour filtrer, trier et exploiter ces données.
Chaque rapport contient un ensemble prédéfini de champs. Vous utilisez l'API pour planifier des jobs de création de rapports, chacun d'eux 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 pour 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 permettent d'accéder de manière programmatique aux données sur les revenus publicitaires.
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 avec l'API YouTube Analytics, et les rapports groupés avec l'API YouTube Reporting.
Il est possible que des données disponibles dans une API ne le soient pas 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, mais l'API YouTube Reporting vous oblige à agréger ces données vous-même. En revanche, l'API YouTube Reporting est compatible avec 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 (query ou bulk) et les propriétaires de contenu (query ou bulk). Les rapports sur les vidéos fournissent des statistiques sur l'ensemble de l'activité des utilisateurs concernant les vidéos d'une chaîne ou d'un propriétaire de contenu. Par exemple, ces rapports contiennent 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 (query ou bulk) et les propriétaires de contenu (query ou bulk). Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos qui se produisent dans le contexte d'une playlist. L'API YouTube Reporting est compatible avec les rapports sur la rétention de l'audience pour les playlists, mais l'API YouTube Analytics ne l'est pas. |
| Rapport sur les performances des annonces | Compatible avec les propriétaires de contenu (query ou bulk). Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant la lecture des vidéos. Ces métriques tiennent compte de chaque impression d'annonce. Chaque lecture de vidéo peut générer plusieurs impressions. |
| Rapports sur les revenus prévisionnels | Compatible avec les propriétaires de contenu (en masse). Les rapports sur les revenus estimés indiquent le total des revenus estimés générés par les vidéos à partir de sources publicitaires vendues par Google et de sources non publicitaires. Ces rapports contiennent également des métriques sur les performances des annonces. Notez que les rapports gérés par le système contiennent les revenus réels. |
| Rapports sur les éléments | Compatible avec les propriétaires de contenu (en masse). Les rapports sur les éléments fournissent des métriques sur l'activité des utilisateurs concernant les vidéos associées aux éléments d'un propriétaire de contenu. Une vidéo est incluse dans le rapport d'un propriétaire de contenu si celui-ci l'a revendiquée comme correspondant à l'un de ses éléments. La vidéo a peut-être été mise en ligne par le propriétaire du contenu ou par un autre utilisateur YouTube. |
| Rapports gérés par le système | Disponible pour les propriétaires de contenu qui ont accès aux rapports correspondants dans le menu "Rapports" de YouTube Creator Studio. Les rapports gérés par le système présentent les revenus réels générés par les éléments et les vidéos. Un autre rapport liste les vidéos revendiquées et les éléments auxquels elles correspondent. Certains rapports Creator Studio ne sont 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. Par conséquent, la procédure pour récupérer ces rapports est différente de celle 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. |
Principales différences
Le tableau suivant met en évidence les principales différences entre les API YouTube Analytics et YouTube Reporting.
| Fonctionnalité | 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 à renvoyer, ainsi que la période pour laquelle les données seront renvoyées. | Les applications planifient les jobs de création de rapports. Pour chaque job, 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 spécifient la date à laquelle l'activité de l'utilisateur a eu lieu. Certains de ces rapports sont compatibles avec les dimensions permettant d'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 utilisant l'API peuvent implémenter des fonctionnalités permettant d'agréger les données pour des intervalles périodiques. |
| 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 est également compatible avec certaines dimensions, comme continent et subContinent, qui ne sont utilisées que comme filtres. | L'API permet de télécharger des ensembles de données complets de manière groupée. Il n'est pas possible de filtrer les données ni d'en renvoyer pour les dimensions de filtre uniquement. 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'acceptent qu'un nombre limité de résultats. Par exemple, le rapport qui liste les vidéos les plus regardées d'une chaîne renvoie un maximum de 200 lignes. | Cette API permet de télécharger des ensembles de données complets de manière groupée. 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 de texte, comme "ANDROID" ou "CHANNEL", pour identifier les valeurs de dimension énumérées. | Les rapports de l'API contiennent des nombres entiers qui peuvent être associés à des valeurs textuelles. |
| Quota | Le serveur d'API évalue chaque requête pour déterminer son coût en termes de quota. La section Utilisation du quota explique la méthodologie plus en détail. | L'utilisation du quota ne pose pas de problème, car les données sont récupérées une seule fois, puis filtrées, triées et interrogées dans l'application. |
| Rapports uniques |
|
|
| Dimensions uniques | group (dimension de filtre uniquement) continent (dimension de filtre uniquement) subContinent (dimension de filtre uniquement) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Métriques uniques | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
Différences de dénomination entre les API
Les deux API utilisent des conventions de dénomination différentes pour identifier les dimensions et les métriques. Les noms des API YouTube Analytics utilisent la casse mixte (camelCase), comme adType. Les noms de l'API YouTube Reporting sont en minuscules et utilisent des traits de soulignement, comme ad_type.
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 celle que vous obtiendriez après avoir converti un nom de camelCase en underscores. Par exemple, la dimension video dans l'API YouTube Analytics est nommée video_id dans l'API YouTube Reporting.