Introduction

Ce document explique les similitudes et les différences entre les API YouTube Analytics et YouTube Reporting pour accéder aux données YouTube Analytics. L'objectif de ce document est de vous aider à choisir l'API adaptée à votre application.

Les deux API permettent aux développeurs d'extraire des données YouTube Analytics. En outre, les deux API sont compatibles avec les propriétaires de chaînes et de contenu YouTube, qui peuvent chacun accéder à un ensemble spécifique de rapports:

  • Les rapports sur les canaux contiennent les 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 combinées des chaînes YouTube de tous ses artistes. Certains rapports de propriétaires de contenu contiennent des métriques sur l'activité des utilisateurs, tandis que d'autres contiennent des métriques sur les revenus et les 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 demandes liées à YouTube Analytics et à l'API 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 permettant d'agréger des données, comme la date à laquelle l'utilisateur a effectué une activité ou le pays dans lequel il se trouvait.

    Dans un rapport, chaque ligne de données est associée à une combinaison unique de valeurs de dimension. Par conséquent, la combinaison de valeurs de dimension 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 sur l'activité des utilisateurs incluent des éléments tels que le nombre de vues des vidéos et les notes (les "J'aime" et "Je n'aime pas").

Choisissez l'API adaptée à votre application

L'API YouTube Analytics
L'API YouTube Analytics accepte les 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 ces fonctions de manière native.

Chaque requête API spécifie la plage de dates pour laquelle des données doivent être renvoyées. L'API vous permet également d'extraire 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 les statistiques agrégées sur l'ensemble des plages de dates.
API de création de rapports YouTube
L'API YouTube Reporting permet de récupérer les rapports groupés contenant les données YouTube Analytics d'une chaîne ou d'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 exploiter ces données.

Chaque rapport contient un ensemble prédéfini de champs. Les développeurs utilisent l'API pour planifier des tâches de création de rapports, chacune d'elles identifiant un rapport que YouTube doit générer. YouTube génère ensuite un rapport quotidien que vous pouvez télécharger 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 via l'API YouTube Analytics, et les rapports groupés 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 des métriques sur l'activité des utilisateurs chaque semaine ou chaque mois, mais vous devez les agréger vous-même. En revanche, l'API YouTube Reporting permet aux propriétaires de contenu de générer des rapports sur les assets, 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ête ou groupée) et les propriétaires de contenu (requête ou groupées).

Les rapports sur les vidéos fournissent des statistiques sur toutes les activités des utilisateurs en lien avec les vidéos d'une chaîne ou d'un propriétaire de contenu. Par exemple, ils indiquent le nombre de vues enregistrées par vos vidéos. Dans l'API YouTube Analytics, certains rapports sur les vidéos de 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ête ou groupée) et les propriétaires de contenu (requête ou groupées).

Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos incluses dans une playlist. L'API YouTube Reporting prend en charge 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ée).

Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées lors des lectures de vidéos. Ces métriques prennent en compte chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
Rapports sur les revenus prévisionnels Compatible pour les propriétaires de contenu (opérations groupées).

Les rapports sur les revenus estimés indiquent le total des revenus estimés générés par les vidéos provenant de sources publicitaires vendues par Google et 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 pour les propriétaires de contenu (opérations groupées).

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é cette vidéo 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 la section Rapports de YouTube Studio.

Les rapports gérés par le système présentent les données sur les revenus réels générés par les éléments et les vidéos. Un rapport supplémentaire liste les vidéos revendiquées et les éléments qui leur correspondent. 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. Par conséquent, le processus de récupération de ces rapports est différent de celui des autres types de rapports de cette liste. Pour en savoir plus, consultez la documentation relative aux rapports gérés par le système.

Différences majeures

Le tableau suivant met en évidence les différences importantes 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 à renvoyer, ainsi que la période pour laquelle les données doivent être renvoyées. Les applications planifient les tâches de création de rapports. Pour chaque mission, YouTube génère des rapports quotidiens pouvant ê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 s'est produite. Certains de ces rapports acceptent des dimensions permettant de regrouper les métriques sur l'activité des utilisateurs par mois. Tous les rapports de l'API spécifient le jour où l'activité de l'utilisateur s'est produite. Les applications qui utilisent l'API peuvent mettre en œuvre des fonctionnalités permettant d'agréger des données à intervalles réguliers.
Filtrer des 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, comme continent et sous-continent, qui ne sont utilisées qu'en tant que filtres. L'API permet le téléchargement groupé d'ensembles de données complets. Elle ne permet pas de filtrer ni d'afficher des données pour des dimensions basées uniquement sur le filtrage. L'application cliente stocke les données téléchargées et implémente ses propres fonctionnalités pour filtrer les données.
Tri Les rapports peuvent être triés en fonction des valeurs des métriques renvoyées. Certains rapports n'acceptent qu'un nombre limité de résultats. Par exemple, le rapport qui répertorie les vidéos les plus regardées d'une chaîne affiche 200 lignes au maximum. 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, comme "ANDROID" ou "CHANNEL", pour identifier les valeurs de dimension énumérées. Les rapports de l'API contiennent des entiers pouvant être mappés sur des valeurs textuelles.
Quotas Le serveur d'API évalue chaque requête pour déterminer le coût de son quota. La section Utilisation des quotas explique 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
  • Activité de l'utilisateur concernant les 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)
Dimensions uniques groupe (dimension filtre uniquement)
continent (dimension filtre uniquement)
subContinent (dimension basée uniquement sur le filtre)
mois
isCurated==1 (dimension de filtrage uniquement)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
langue_sous-titre
Métriques uniques uniques
relativeConservationPerformance
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_save_revenue{17/added_playlist_playlist

Différences de noms entre les API

Actuellement, les deux API utilisent des conventions d'attribution de noms différentes pour identifier les dimensions et les métriques. Pour le moment, les noms des API YouTube Analytics utilisent camelCase, tandis que les noms des API YouTube Reporting utilisent 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 de l'API YouTube Analytics est nommée video_id dans l'API YouTube Reporting.

Dimensions

Nom de l'API YouTube Analytics Nom de l'API YouTube Reporting
adType ad_type [type_annonce]
ageGroup age_group [tranche_d'âge]
élément asset_id
typeaudience audience_retention_type
channel channel_id
claimedStatus (État revendiqué) état_revendiqué
Propriétaire du contenu content_owner_id
pays country_code [code_pays]
jour date
deviceType (Type d'appareil) device_type [type_appareil]
elapsedVideoTimeRatio elapsed_video_time_percentage
sexe sexe
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type [type_de_lecture_de_lecture]
insightTrafficSourceDetail traffic_source_detail (détail_source du trafic)
insightTrafficSourceType traffic_source_type (type de source du trafic)
liveOrOnDemand en direct ou à la demande
OperatingSystem (Système d'exploitation) système_exploitation
playlist id_playlist
province province_code
sharingService service_partage
subscribedStatus (État abonné) état_abonné
subtitleLangue subtitle_language
Type d'importation type_utilisateur_importateur
vidéo video_id [id_vidéo]

Métriques

Nom de l'API YouTube Analytics Nom de l'API YouTube Reporting
adRevenueings estimated_partner_ad_revenue
annotationImpressions annotation_impressions
annotationClickableImpressions annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickthroughRate annotation_click_through_rate
annotationClosableImpressions. annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate
audienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
cardClickRate card_click_rate
cardClicks card_clicks
fichesimpression card_impressions
cardTeaserClickRate card_teaser_click_rate
cardTeaserClicks card_teaser_clicks
cardTeaserImpressions. card_teaser_impressions
comments comments
Je n'aime pas Je n'aime pas
revenus Revenus estimés du partenaire
estimatedMinutesWatched (Nombre de minutes de visionnage estimées) watch_time_minutes
estimationPartnerAdSenseRevenue estimated_partner_adsense_revenue
Revenus estimésPartnerDoubleClick estimated_partner_doubleclick_revenue
GrossRevenue revenus_ad_estimés_youtube
Cpm basée sur les impressions estimation_cpm
impressions ad_impressions
J'aime J'aime
monetizationdPlaybacks (lectures monétisées) estimated_monetizationd_playbacks [lectures_totales_estimées]
CPM basée sur les lectures estimated_playback_based_cpm
débuts de lecture débuts_playlists
Ajouteenregistrement ajouts_de_playlists
savesRemoved playlist_saves_supprimée
partages partages
abonnés gagnés subscribers_gained
abonnés perdus abonnés_perdus
videosAjoutées auxPlaylists vidéos_ajoutées_aux_playlists
videosRemovedFromPlaylists (Vidéos supprimées des playlists) vidéos_supprimées_de_playlist
viewerPercentage views_percentage
vues vues