Exemples de requêtes API

Cette page présente des exemples de requêtes API YouTube Analytics. Chaque exemple décrit brièvement le rapport récupéré, puis affiche les valeurs des paramètres dimensions, metrics, filters et sort correspondantes. Les documents des rapports sur les canaux et sur les rapports sur les propriétaires de contenu identifient les rapports compatibles avec l'API.

Chaque exemple est associé à Google APIs Explorer et renseigne les valeurs affichées dans cet outil. Les exemples utilisent également les dates de début et de fin par défaut (YYYY-MM-DD) de 2023-09-01 et 2024-03-31.

Après avoir associé APIs Explorer, vous devez toujours spécifier la chaîne ou le propriétaire de contenu pour lesquels vous souhaitez récupérer des rapports. APIs Explorer insérera la valeur du paramètre ids avec channel==MINE ou contentOwner==CONTENT_OWNER_ID, selon la requête sur laquelle vous avez cliqué. Pour les rapports sur les canaux, vous pouvez remplacer MINE par l'ID de la chaîne de l'utilisateur authentifié. Pour les rapports sur les propriétaires de contenu, vous devez remplacer CONTENT_OWNER_ID par votre ID de propriétaire de contenu.

Vous devez également être authentifié en tant que chaîne ou propriétaire de contenu spécifié pour qu'APIs Explorer puisse autoriser vos requêtes API à l'aide de OAuth 2.0.

  1. Trier les demandes selon plusieurs dimensions/métriques
  2. Rapports sur les canaux
  3. Rapports de propriétaires de contenu

Tri des demandes selon plusieurs dimensions/métriques

L'API permet de trier les données de réponse à l'aide de plusieurs dimensions ou métriques. Par exemple, la requête ci-dessous permet de récupérer les données sur les sources de trafic quotidien pour les vidéos d'une chaîne spécifique. Chaque ligne de l'ensemble de résultats identifie le nombre de vues et la durée de visionnage estimée d'une source de trafic spécifique (par exemple, EXT_URL) pour un jour donné.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

Dans la réponse, les résultats sont triés chronologiquement. Dans l'ensemble des résultats pour chaque jour, les résultats sont triés par ordre décroissant du nombre de vues. Ainsi, la première ligne de l'ensemble de résultats contient les données sur la source de trafic ayant généré le plus de vues le premier jour de la plage de dates demandée. La deuxième ligne contient les données relatives à la source de trafic ayant généré le nombre de vues suivant le plus élevé le premier jour.

Rapports sur les canaux

Statistiques de base

Signalements de vidéos

Nombre total de vues, durée de visionnage estimée et plus encore pour une chaîne

Cette requête permet de récupérer des métriques agrégées sur le contenu de la chaîne. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Nombre de vues par pays (et plus) pour une chaîne

Cette requête récupère les métriques d'un pays spécifique pour les vidéos d'une chaîne. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Top 10 : vidéos les plus regardées d'une chaîne

Cette requête permet de récupérer les 10 vidéos les plus regardées d'une chaîne sur la base de l'estimation du nombre de minutes regardées au cours de la période spécifiée. Les résultats sont triés en fonction de l'estimation du nombre de minutes regardées, dans l'ordre décroissant.

Remarque:Dans ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne

Cette requête permet de connaître le nombre de vues, le taux de clics sur les annotations, le taux de fermeture des annotations et le nombre d'impressions d'annotations pour les 10 vidéos les plus regardées de la chaîne. Les résultats sont triés par nombre de vues et par ordre décroissant, ce qui signifie que la vidéo la plus regardée apparaît en premier.

Remarque:Dans ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Rapports sur les playlists

Nombre total de vues des playlists pour une chaîne

Cette demande permet de récupérer le nombre total de lancements de la playlist, l'estimation du nombre de minutes regardées et les vues (un métrique vidéo agrégée), les vues de playlists (métrique dans une playlist) ; et le nombre de vues par playlist sont lancés sur la chaîne de l'utilisateur authentifié.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Statistiques concernant une playlist spécifique

Cette demande permet de récupérer le nombre total de lancements de la playlist, l'estimation du nombre de minutes regardées et les vues (un métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; et le nombre de vues par playlist. Notez que pour exécuter cette requête dans les API, Explorer, vous devez remplacer la chaîne PLAYLIST_ID dans filters par l'ID d'une playlist sur la chaîne de l'utilisateur authentifié.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Pour récupérer les statistiques globales de plusieurs playlists, vous pouvez également remplacer la chaîne PLAYLIST_ID par une liste de 500 ID de playlists (au maximum) séparés par une virgule, pour les playlists de la chaîne de l'utilisateur authentifié.

Top 10 : playlists les plus regardées d'une chaîne

Cette requête permet de récupérer les 10 playlists les plus regardées d'une chaîne en fonction du nombre de vues de la playlist. au cours de la période spécifiée. Il récupère également d'autres métriques sur les playlists, comme le nombre de fois où les internautes ont lancé la lecture de chaque playlist et le nombre moyen Durée pendant laquelle un spectateur a regardé des vidéos de la playlist après son lancement. Les résultats sont triées par nombre de vues de la playlist, dans l'ordre décroissant.

Remarque:Étant donné que ce rapport utilise la dimension playlist, vous devez spécifier une valeur pour le paramètre de requête sort et définir également le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews
Basés sur le temps

Signalements de vidéos

Métriques sur la durée de visionnage quotidienne des vidéos d'une chaîne

Cette requête permet de récupérer le nombre de vues quotidiennes, des métriques sur la durée de visionnage et le nombre de nouveaux abonnés pour les vidéos d'une chaîne. Le rapport renvoie une ligne de données pour chaque jour de la plage de dates demandée. Les lignes sont triées dans l'ordre chronologique.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Métriques quotidiennes sur les annotations pour les vidéos d'une chaîne

Cette requête permet d'obtenir le nombre de vues quotidien, le taux de clics des annotations, le taux de fermeture des annotations et le nombre d'impressions d'annotations pour le contenu de la chaîne. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Rapports sur les playlists

Nombre de vues quotidiennes de la playlist d'une chaîne

Cette requête récupère le nombre de vues quotidiennes (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; les débuts de lecture de la playlist, le nombre de minutes regardées et le nombre de vues par lancement pour la playlist authentifiée. la chaîne de l'utilisateur. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day
Zone géographique

Signalements de vidéos

Métriques sur la durée de visionnage des vidéos d'une chaîne par pays

Cette requête permet d'obtenir le nombre de vues, des métriques sur la durée de visionnage et le nombre d'abonnements par pays pour les vidéos d'une chaîne. Le rapport affiche une ligne de données pour chaque pays où les vidéos de la chaîne ont été visionnées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Métriques sur les annotations par pays pour les vidéos d'une chaîne

Cette requête indique le nombre de vues, les taux de clics et de fermeture des annotations et les impressions d'annotations par pays pour les vidéos de la chaîne. Les résultats sont triés par taux de clics sur les annotations dans l'ordre décroissant, ce qui signifie que le pays présentant le taux de clics sur les annotations le plus élevé sera répertorié en premier.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Métriques spécifiques à une province pour les États américains et Washington D.C.

Cette demande permet d'obtenir la répartition du nombre de vues, de l'estimation du nombre de minutes regardées et de la durée moyenne de visionnage des vidéos de la province par province. Les données couvrent les États américains et Washington D.C. Les résultats sont triés par ordre alphabétique des provinces Codes ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 : vidéos les plus regardées dans un pays donné

Cette requête permet d'extraire les 10 vidéos les plus regardées de la chaîne, en fonction du nombre de vues enregistrées au cours de la période spécifiée, dans un pays donné. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

Remarque:Dans ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Top 10 des villes des États-Unis par nombre total de vues

Cette requête permet d'obtenir la liste des 10 villes américaines qui ont enregistré le plus de vues du contenu de la chaîne pendant la période spécifiée. La requête peut être modifiée afin de demander des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer les données d'un sous-continent, tel que l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. D'autres filtres sont également acceptés. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 des villes américaines par nombre total de vues pour chaque type de contenu

Cette requête permet d'obtenir la liste des 10 villes américaines qui ont comptabilisé le plus de vues du contenu de la chaîne pendant la période spécifiée, pour chaque creatorContentType accepté. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 des villes américaines par durée de visionnage totale

Cette requête permet d'obtenir la liste des 10 premiers jours de la période spécifiée, au cours de laquelle une ville des États-Unis a enregistré la durée totale de visionnage quotidienne la plus élevée pour le contenu de la chaîne. Les résultats de la requête indiquent la durée totale de visionnage, la date à laquelle la durée de visionnage a eu lieu et la ville où le contenu a été estimé comme ayant été visionné. Les résultats sont triés par ordre décroissant de la durée totale de visionnage.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 : vidéos les plus regardées en Europe

Cette requête permet d'extraire les 10 vidéos les plus regardées de la chaîne en Europe, selon le nombre de vues enregistré au cours de la période spécifiée. La requête peut être modifiée afin de demander les données d'un autre continent en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer les données d'un sous-continent, tel que l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

Remarque:Dans ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Rapports sur les playlists

Métriques sur la durée de visionnage des playlists d'une chaîne par pays

Cette requête récupère le nombre de vues par pays (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; et la durée de visionnage des playlists d'une chaîne. Le rapport renvoie une ligne de données pour chaque pays dans lequel les playlists de la chaîne ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 : playlists les plus lancées aux États-Unis

Cette requête permet de récupérer les 10 playlists que les spectateurs aux États-Unis ont commencé à regarder le plus souvent au cours de la période spécifiée. Les résultats sont triés par nombre de lancements de playlists dans l'ordre décroissant.

Remarque:Étant donné que ce rapport utilise la dimension playlist, vous devez spécifier une valeur pour le paramètre de requête sort et définir également le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Contexte de lecture

Signalements de vidéos

Le nombre de vues et la durée de visionnage pour différents contextes de lecture

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée des vidéos d'une chaîne spécifique. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues. Ils sont triés par ordre décroissant du nombre de vues.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Nombre de vues et durée de visionnage par jour pour différents contextes de lecture

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos d'une chaîne spécifique aux États-Unis. Les résultats sont regroupés par jour pour chaque type de page ou d'application sur laquelle les vidéos ont été lues. Les résultats sont triés par ordre chronologique.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 – Sites tiers qui génèrent le plus de vues pour une vidéo intégrée

Cette requête récupère le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifique. Les résultats sont regroupés en fonction du site tiers sur lequel la vidéo a été intégrée. Les résultats sont triés par ordre décroissant du nombre de vues. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'un ou de plusieurs ID vidéo de vos vidéos mises en ligne, séparés par une virgule.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Rapports sur les playlists

Nombre de vues des playlists et durée de visionnage selon les pays de lecture

Cette requête récupère le nombre de vues (un métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; une estimation de la durée de visionnage et le lancement de la playlist d'une chaîne spécifique. Les résultats sont agrégées en fonction du type de page ou d'application sur lequel les vidéos ont été lues ; les résultats sont triés par ordre décroissant en fonction des lancements de playlists.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Nombre de vues de playlists quotidiennes et durée de visionnage selon les emplacements de lecture

Cette requête récupère les lancements quotidiens de la playlist, le nombre de vues (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; et la durée de visionnage estimée aux États-Unis pour les playlists d'une chaîne spécifique. Résultats sont regroupés par jour pour chaque type de page ou d'application où des vues de playlists ont été enregistrées. Résultats sont triées dans l’ordre chronologique.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day
Source de trafic

Signalements de vidéos

Le nombre de vues et la durée de visionnage provenant de différentes sources de trafic dans un pays

Cette demande permet d'obtenir le nombre de vues et la durée de visionnage estimée des vidéos de la chaîne dans un pays donné. Les métriques sont regroupées par source de trafic, c'est-à-dire de la manière dont les utilisateurs ont accédé à la vidéo.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Nombre de vues et durée de visionnage par jour provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos de la chaîne chaque jour. Les métriques sont agrégées quotidiennement par source de trafic et triées par ordre chronologique.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10 : termes de recherche YouTube qui génèrent le plus de trafic pour une vidéo

Cette requête extrait les 10 termes de recherche ayant généré le plus de vues à partir des résultats de recherche YouTube pour une ou plusieurs vidéos spécifiques. Les résultats sont triés par nombre de vues dans l'ordre décroissant. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

Par exemple, vous pouvez exécuter la requête pour une seule vidéo ou remplacer VIDEO_ID pour identifier les termes de recherche qui génèrent le plus de trafic pour cette vidéo. Vous pouvez également répertorier toutes les vidéos d'une playlist spécifique afin d'identifier les termes de recherche qui génèrent le plus de trafic pour chacune des vidéos de cette playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – Sites Web externes qui génèrent le plus de trafic pour une vidéo

Cette requête extrait les 10 sites Web externes ayant généré le plus de vues pour une vidéo ou un groupe de vidéos spécifique. Les résultats sont triés en fonction de la durée de visionnage estimée, dans l'ordre décroissant. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Rapports sur les playlists

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays

Cette demande récupère le nombre de vues (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; le début de la playlist et la durée de visionnage estimée des vues dans un pays donné. La Les métriques sont agrégées par source de trafic. Elles décrivent la manière dont les utilisateurs ont atteint la playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Nombre de vues de playlists quotidiennes et durée de visionnage pour différentes sources de trafic

Cette demande permet de récupérer le nombre de vues quotidiennes de la playlist d'une chaîne (un la métrique dans une playlist), le début de la playlist et la durée de visionnage estimée. Elle récupère également le nombre total de vues (une métrique vidéo agrégée). Les métriques sont agrégées quotidiennement par source de trafic et triées par ordre chronologique.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day
Appareil/OS

Signalements de vidéos

Métriques quotidiennes par type d'appareil pour le système d'exploitation Android

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos d'une chaîne spécifique sur les appareils Android. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les lectures de vidéos ont été effectuées. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Métriques quotidiennes sur les systèmes d'exploitation pour les appareils mobiles

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos d'une chaîne spécifique sur les appareils mobiles. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel les vidéos ont été lues. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Métriques quotidiennes (système d'exploitation et type d'appareil)

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée d'une chaîne. Les statistiques sont regroupées par système d'exploitation et par type d'appareil. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Rapports sur les playlists

Métriques quotidiennes par type d'appareil pour les vues de playlists sur le système d'exploitation Android

Cette requête récupère les vues quotidiennes (un métrique vidéo agrégée), les vues de playlists (métrique dans une playlist) ; et la durée de visionnage estimée des playlists d'une chaîne spécifique sur les appareils Android. Les résultats sont regroupées par jour pour chaque type d'appareil sur lequel les vues de la playlist ont été enregistrées. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Métriques quotidiennes sur les systèmes d'exploitation pour les vues de playlists sur les appareils mobiles

Cette requête récupère les vues quotidiennes (un métrique vidéo agrégée), les vues de playlists (métrique dans une playlist) ; et la durée de visionnage estimée sur les appareils mobiles des playlists d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel des vues de la playlist ont été enregistrées. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day
Données démographiques

Signalements de vidéos

Données démographiques sur les spectateurs en Californie (tranche d'âge et genre)

Ce rapport présente des statistiques sur la tranche d'âge et le sexe des spectateurs californiens qui ont regardé les vidéos de la chaîne. Les résultats sont triés par genre, puis par tranche d'âge. Cette requête peut être modifiée afin d'extraire les mêmes statistiques pour tous les spectateurs du monde entier ou tous ceux d'un pays, d'un continent, d'un sous-continent ou d'un autre État américain en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Rapports sur les playlists

Données démographiques sur les spectateurs de playlists en Californie (tranche d'âge et genre)

Ce rapport inclut des statistiques sur la tranche d'âge et le genre des spectateurs californiens qui regardé les playlists de la chaîne Les résultats sont triés par genre, puis par tranche d'âge. Ce peut être modifiée pour récupérer les mêmes statistiques pour tous les lecteurs du monde entier ou tous les lecteurs d'un pays, d'un continent, d'un sous-continent ou d'un autre État américain en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup
Réseaux sociaux

Métriques de partage, agrégées par service pour lequel des vidéos ont été partagées

Cette demande récupère le nombre de fois où les utilisateurs ont partagé les vidéos d'une chaîne à l'aide du bouton Share. Les résultats sont regroupés par service de partage (Google+, Twitter, etc.) et triés par ordre décroissant du nombre de partages.

dimensions=sharingService
metrics=shares
sort=-shares
Rétention d'audience

Métriques sur la rétention d'audience pour une vidéo

Ce rapport mesure la capacité d'une vidéo à fidéliser son public. Le rapport ne peut être récupéré que pour une vidéo à la fois. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par l'ID vidéo de l'une de vos vidéos mises en ligne. Notez que les rapports sur la rétention d'audience ne permettent pas de spécifier plusieurs valeurs pour le filtre video.

Dans cet exemple, le rapport utilise le filtre audienceType pour limiter la réponse afin qu'elle ne contienne que les données relatives aux vues naturelles, qui résultent d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou le clic sur une suggestion de vidéo. Il n'inclut donc pas de données sur les vues provenant d'annonces TrueView InStream ou TrueView InDisplay. Vous pouvez supprimer le filtre pour récupérer les données sur la rétention d'audience d'une vidéo pour tous les types d'audience.

Notez que les données du filtre audienceType sont disponibles depuis le 25 septembre 2013. L'API ne renverra pas de données pour les requêtes qui utilisent le filtre pour essayer de récupérer des données à des dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date ultérieure au 1er juillet 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Revenus/annonces

Métriques sur les revenus de la chaîne et les performances des annonces

Cette demande permet de récupérer les métriques sur les revenus et les performances des annonces d'une chaîne. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métriques sur les revenus quotidiens et les performances des annonces

Cette demande permet de récupérer les métriques sur les performances des annonces et les revenus quotidiens d'une chaîne.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métriques sur les revenus et les performances des annonces par pays

Cette demande permet de récupérer les métriques sur les performances des annonces et les revenus spécifiques à un pays d'une chaîne. Les résultats sont triés par ordre décroissant du montant des revenus, ce qui signifie que le premier pays répertorié sera celui où le partenaire a généré le revenu net le plus élevé.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 : vidéos générant les revenus les plus élevés

Cette demande permet d'obtenir des métriques sur les revenus et les performances des annonces pour les 10 vidéos de la chaîne générant les revenus les plus élevés. Les résultats sont triés par montant de revenus par ordre décroissant, ce qui signifie que la première vidéo sera celle qui a généré les revenus estimés les plus élevés.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Métriques sur les performances des annonces pour différents types d'annonces

Cette demande permet de récupérer des métriques sur les performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Les résultats sont regroupés par type d'annonce, ce qui vous permet de comparer les revenus et les valeurs de CPM pour différents types d'annonces.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Rapports de propriétaires de contenu

Statistiques de base

Signalements de vidéos

Nombre total de vues, durée de visionnage estimée et plus encore pour tous les contenus revendiqués

Cette requête récupère des métriques agrégées sur les contenus revendiqués par le propriétaire de contenu. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Nombre de vues par pays (et plus) pour toutes les vidéos auto-mises en ligne

Cette requête récupère les métriques d'un pays spécifique pour les vidéos mises en ligne par le propriétaire de contenu. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Nombre total de vues (et plus) pour tous les contenus tiers revendiqués

Cette requête récupère des métriques agrégées pour les vidéos que le propriétaire de contenu a revendiquées, mais n'a pas mises en ligne. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Nombre total de vues (et plus) pour tous les contenus auto-importés

Cette requête récupère des métriques agrégées pour les vidéos mises en ligne par le propriétaire de contenu. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Nombre total de vues (et plus) pour tous les contenus revendiqués auto-importés

Cette requête récupère des métriques agrégées pour les vidéos que le propriétaire de contenu a mises en ligne et revendiquées. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Top 10 : vidéos les plus regardées pour un propriétaire de contenu

Cette requête permet de récupérer les 10 vidéos les plus regardées mises en ligne par le propriétaire du contenu au cours de la période spécifiée. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Top 10 : vidéos les plus regardées pour un propriétaire de contenu

Cette requête permet de récupérer les 10 vidéos les plus regardées mises en ligne par le propriétaire du contenu (estimation du nombre de minutes regardées au cours de la période spécifiée). Les résultats sont triés en fonction de l'estimation du nombre de minutes regardées, dans l'ordre décroissant.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Top 10 : vidéos les plus regardées sur la chaîne d'un propriétaire de contenu

Cette requête permet de récupérer les 10 vidéos les plus regardées pour une chaîne ou un groupe de chaînes spécifiques gérés par le propriétaire de contenu. Les résultats sont triés par nombre de vues dans l'ordre décroissant. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Top 10 – Taux de clics sur les annotations pour les vidéos les plus regardées d'une chaîne

Cette requête permet d'obtenir le nombre de vues, le taux de clics sur les annotations, le taux de fermeture des annotations et le nombre d'impressions d'annotations pour les 10 vidéos les plus regardées sur une chaîne ou un groupe de chaînes spécifique. Les résultats sont triés par nombre de vues et par ordre décroissant, ce qui signifie que la vidéo la plus regardée apparaît en premier. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Rapports sur les playlists

Nombre de vues de la playlist des chaînes d'un propriétaire de contenu

Cette demande récupère le nombre total de lancements de la playlist, l'estimation du nombre de minutes regardées et la playlist. le nombre de vues et le nombre de vues par playlist sont lancés pour les playlists sur les chaînes du propriétaire de contenu. La La métrique playlistViews ne comptabilise que les vues de vidéos enregistrées dans le contexte d'un la playlist. Étant donné que toutes les métriques demandées sont des métriques dans la playlist, vous devez également inclure le filtre playlist ou group.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistiques concernant une playlist spécifique

Cette demande permet de récupérer le nombre total de lancements de la playlist, l'estimation du nombre de minutes regardées et les vues (un métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) ; et le nombre de vues par playlist. Notez que pour exécuter cette requête dans les API, Explorer, vous devez remplacer la chaîne PLAYLIST_ID dans filters par l'ID d'une playlist sur l'une des chaînes du propriétaire de contenu.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Pour récupérer les statistiques globales de plusieurs playlists, vous pouvez également remplacer la chaîne PLAYLIST_ID par une liste de 500 ID de playlists (au maximum) séparés par une virgule pour les playlists des chaînes du propriétaire de contenu.

Basés sur le temps

Signalements de vidéos

Métriques sur la durée de visionnage quotidienne des contenus auto-importés

Cette requête récupère des métriques quotidiennes sur la durée de visionnage, ainsi que le nombre de vues, de lectures monétisées et d'impressions des vidéos mises en ligne par le propriétaire du contenu. Le rapport renvoie une ligne de données pour chaque jour de la plage de dates demandée. Les lignes sont triées dans l'ordre chronologique.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Métriques sur les annotations pour le contenu revendiqué

Cette requête indique le nombre de vues par jour, le taux de clics des annotations, le taux de fermeture des annotations et les impressions d'annotations pour le contenu revendiqué par le propriétaire de contenu. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Rapports sur les playlists

Nombre de vues quotidiennes de playlists pour un propriétaire de contenu

Cette demande permet de récupérer des métriques sur les interactions quotidiennes des utilisateurs avec les vidéos du propriétaire de contenu playlists. Les métriques récupérées dans le rapport sont playlistViews, playlistStarts, playlistEstimatedMinutesWatched et viewsPerPlaylistStart. Toutes ces métriques sont des métriques dans une playlist. Étant donné que toutes les métriques demandées sont des métriques dans la playlist, il n'est pas nécessaire incluez également le filtre playlist ou groupe.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day
Zone géographique

Signalements de vidéos

Métriques sur la durée de visionnage par pays pour les contenus auto-importés

Cette requête récupère le nombre de vues, des métriques sur la durée de visionnage et une estimation des revenus publicitaires pour chaque pays. Les métriques concernent les vidéos mises en ligne par le propriétaire de contenu. Le rapport renvoie une ligne de données pour chaque pays dans lequel les vidéos ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Métriques sur les annotations propres à chaque pays pour les contenus auto-importés

Cette requête permet de connaître le nombre de vues, les taux de clics et de fermeture des annotations et les impressions d'annotations par pays pour les vidéos mises en ligne par le propriétaire de contenu. Les résultats sont triés par taux de clics sur les annotations dans l'ordre décroissant, ce qui signifie que le pays présentant le taux de clics sur les annotations le plus élevé sera répertorié en premier.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Métriques spécifiques à une province pour les États américains et Washington D.C.

Cette demande permet d'obtenir la répartition, par province, du nombre de vues, de l'estimation du nombre de minutes regardées et de la durée moyenne de visionnage des vidéos revendiquées par le propriétaire de contenu. Les données couvrent les États américains et Washington D.C. Les résultats sont triés par ordre alphabétique des provinces Codes ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 des villes des États-Unis par nombre total de vues

Cette requête permet d'obtenir la liste des 10 villes américaines qui ont comptabilisé le plus grand nombre de vues des vidéos revendiquées par le propriétaire de contenu au cours de la période spécifiée. La requête peut être modifiée afin de demander des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer les données d'un sous-continent, tel que l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. D'autres filtres sont également acceptés. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 des villes américaines par nombre total de vues pour chaque type de contenu

Cette requête permet de récupérer la liste des 10 villes américaines qui ont comptabilisé le plus grand nombre de vues du contenu revendiqué par le propriétaire de contenu au cours de la période spécifiée, pour chaque élément creatorContentType accepté. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 des villes américaines par durée de visionnage totale

Cette requête permet de récupérer la liste des 10 premiers jours de la période spécifiée, au cours de laquelle une ville des États-Unis a enregistré la durée totale de visionnage quotidienne la plus élevée pour le contenu revendiqué par le propriétaire de contenu. Les résultats de la requête indiquent la durée totale de visionnage, la date à laquelle la durée de visionnage a eu lieu et la ville où le contenu a été estimé comme ayant été regardé. Les résultats sont triés par ordre décroissant de la durée totale de visionnage.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Vidéos les plus regardées en Europe

Cette requête extrait les 10 vidéos les plus regardées en Europe parmi les vidéos revendiquées par le propriétaire de contenu, selon le nombre de vues enregistrées au cours de la période spécifiée. La requête peut être modifiée afin de demander les données d'un autre continent en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer les données d'un sous-continent, tel que l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Rapports sur les playlists

Statistiques sur la durée de visionnage des playlists d'un propriétaire de contenu par pays

Cette requête récupère le nombre de vues des playlists et des métriques sur leur durée de visionnage pour chaque pays. pour toutes les playlists des chaînes du propriétaire de contenu. Le rapport renvoie une ligne de données pour chaque le pays dans lequel les playlists ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes de visionnage.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 : playlists les plus lancées aux États-Unis

Cette requête permet de récupérer les 10 playlists des chaînes du propriétaire de contenu que les spectateurs de Les utilisateurs situés aux États-Unis ont commencé à regarder le plus souvent des vidéos au cours de la période spécifiée. Les résultats sont triés par nombre de lancements de la playlist dans l'ordre décroissant.

Remarque:Étant donné que ce rapport utilise playlist, vous devez spécifiez une valeur pour le paramètre de requête sort et définissez également th le paramètre maxResults sur une valeur entière inférieure ou égale à 10 ;

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts
Détails de la lecture

Signalements de vidéos

"J'aime" et "Je n'aime pas" par type de contenu

Cette requête permet de récupérer le nombre de "J'aime" et "Je n'aime pas" pour chaque type de contenu d'une chaîne ou d'un groupe de chaînes spécifique. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
Contexte de lecture

Signalements de vidéos

Le nombre de vues et la durée de visionnage pour différents contextes de lecture

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée des vidéos mises en ligne sur une chaîne ou un groupe de chaînes spécifique. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues. Ils sont triés par ordre décroissant du nombre de vues. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Nombre de vues et durée de visionnage par jour pour différents contextes de lecture

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée aux États-Unis pour les vidéos mises en ligne sur une chaîne ou un groupe de chaînes spécifique. Les résultats sont regroupés par jour pour chaque type de page ou d'application sur laquelle les vidéos ont été lues. Les résultats sont triés dans l'ordre chronologique inverse. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Sites tiers qui génèrent le plus de vues pour une vidéo intégrée

Cette requête récupère le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifique. Les résultats sont regroupés en fonction du site tiers sur lequel la vidéo a été intégrée. Les résultats sont triés par ordre décroissant du nombre de vues. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Rapports sur les playlists

Nombre de vues des playlists et durée de visionnage selon les pays de lecture

Cette requête récupère le nombre de vues de la playlist, la durée de visionnage estimée de la playlist et playlist démarre pour toutes les playlists sur les chaînes d'un propriétaire de contenu. Les résultats sont agrégés sur le type de page ou d'application où les vidéos ont été lues, et où les résultats sont triés par ordre décroissant.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Nombre de vues des playlists et durée de visionnage selon les pays de lecture

Cette requête récupère les lancements quotidiens de la playlist, le nombre de vues de la playlist et le nombre de vues estimé de la playlist aux États-Unis pour toutes les playlists des chaînes d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque type de page ou d'application où des vues de playlists ont été enregistrées.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US
Source de trafic

Signalements de vidéos

Nombre de vues et durée de visionnage provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues et la durée de visionnage estimée des vidéos du propriétaire de contenu. Les métriques sont regroupées par source de trafic, c'est-à-dire de la manière dont les utilisateurs ont accédé à la vidéo.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Nombre de vues et durée de visionnage par jour provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée quotidienne des vidéos du propriétaire de contenu. Les métriques sont agrégées quotidiennement par source de trafic, puis triées dans l'ordre chronologique inverse.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Remarque:Les deux exemples de rapports suivants ne sont compatibles qu'avec des sources de trafic spécifiques. Par exemple, la source de trafic NO_LINK_EMBEDDED ne comporte pas d'informations supplémentaires. Ces rapports ne sont donc pas disponibles pour cette source. Pour en savoir plus sur les sources de trafic pour lesquelles ces types de rapports sont disponibles, consultez la définition de insightTrafficSourceType.

Top 10 : termes de recherche YouTube qui génèrent le plus de trafic pour une vidéo

Cette requête extrait les 10 termes de recherche ayant généré le plus de vues à partir des résultats de recherche YouTube pour une vidéo ou un groupe de vidéos spécifique. Les résultats sont triés par nombre de vues dans l'ordre décroissant. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – Sites Web externes qui génèrent le plus de trafic pour une vidéo

Cette requête extrait les 10 sites Web externes ayant généré le plus de vues à partir des résultats de recherche Google pour une vidéo ou un groupe de vidéos spécifique. Les résultats sont triés en fonction de la durée de visionnage estimée, dans l'ordre décroissant. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Rapports sur les playlists

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays

Cette demande permet de récupérer le nombre de vues de la playlist, les lancements de la playlist et la durée de visionnage estimée de la playlist. pour les vues de playlists dans un pays donné. Les métriques sont agrégées par source de trafic, qui décrit la manière dont les utilisateurs ont atteint la playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues et les lancements de la playlist, ainsi que la durée de visionnage estimée de la playlist pour les playlists sur une ou plusieurs chaînes du propriétaire de contenu. Les métriques sont agrégées par source de trafic. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une virgule. contenant jusqu'à 500 ID pour vos chaînes.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID
Appareil/OS

Signalements de vidéos

Métriques quotidiennes par type d'appareil pour les vidéos revendiquées

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée par type d'appareil pour les vidéos revendiquées par un propriétaire de contenu particulier. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les lectures de vidéos ont été effectuées. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Statistiques quotidiennes sur les systèmes d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée par système d'exploitation pour les vues de vidéos revendiquées par un propriétaire de contenu donné, sur des appareils mobiles. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel les lectures de vidéos ont eu lieu. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Métriques quotidiennes (système d'exploitation et type d'appareil)

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos revendiquées par un propriétaire de contenu spécifique. Les statistiques sont regroupées par système d'exploitation et par type d'appareil. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Rapports sur les playlists

Métriques par type d'appareil pour les vues de playlists sur le système d'exploitation Android

Cette requête récupère le nombre de vues des playlists et la durée de visionnage estimée de la playlist sur les appareils Android pour les playlists sur une ou plusieurs chaînes du propriétaire de contenu. Les résultats sont renvoyés pour Chaque type d'appareil sur lequel les playlists ont été vues Notez que pour exécuter cette requête dans les API, Explorer, vous devez remplacer la chaîne CHANNEL_ID dans filters par une liste de 500 ID de chaînes au maximum, séparés par une virgule.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Métriques du système d'exploitation pour les vues de playlists sur les appareils mobiles

Cette requête récupère le nombre de vues des playlists et la durée de visionnage estimée de la playlist sur les appareils mobiles pour les playlists sur n'importe quelle chaîne d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque système d'exploitation sur lequel les vues de la playlist ont eu lieu.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
Données démographiques

Signalements de vidéos

Données démographiques sur les spectateurs en Californie (tranche d'âge et genre)

Ce rapport contient des statistiques sur la tranche d'âge et le genre des spectateurs situés en Californie qui ont regardé le contenu revendiqué par le propriétaire de contenu. Les résultats sont triés par genre, puis par tranche d'âge. Cette requête peut être modifiée afin d'extraire les mêmes statistiques pour tous les spectateurs du monde entier ou tous ceux d'un pays, d'un continent, d'un sous-continent ou d'un autre État américain en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup
Réseaux sociaux

Métriques de partage, agrégées par service sur lequel des vidéos ont été partagées

Cette demande permet de récupérer le nombre de fois où les utilisateurs ont partagé des vidéos mises en ligne par le propriétaire du contenu à l'aide du bouton Share. Les résultats sont regroupés par service de partage (Google+, Twitter, etc.) et triés par ordre décroissant du nombre de partages.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares
Rétention d'audience

Métriques sur la rétention d'audience pour une vidéo

Ce rapport mesure la capacité d'une vidéo à fidéliser son public. Le rapport ne peut être récupéré que pour une vidéo à la fois. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par l'ID vidéo de l'une de vos vidéos mises en ligne. Notez que les rapports sur la rétention d'audience ne permettent pas de spécifier plusieurs valeurs pour le filtre video.

Dans cet exemple, le rapport utilise le filtre audienceType pour limiter la réponse afin qu'elle ne contienne que les données relatives aux vues naturelles, qui résultent d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou le clic sur une suggestion de vidéo. Il n'inclut donc pas de données sur les vues provenant d'annonces TrueView InStream ou TrueView InDisplay. Vous pouvez supprimer le filtre pour récupérer les données sur la rétention d'audience d'une vidéo pour tous les types d'audience.

Notez que les données du filtre audienceType sont disponibles depuis le 25 septembre 2013. L'API ne renverra pas de données pour les requêtes qui utilisent le filtre pour essayer de récupérer des données à des dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date ultérieure au 1er juillet 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Revenus/annonces

Métriques sur les revenus et les performances des annonces pour les contenus revendiqués

Cette demande permet de récupérer des métriques sur les revenus et les performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée au cours de la période spécifiée.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métriques sur les revenus quotidiens et les performances des annonces

Cette demande permet de récupérer des métriques sur les revenus quotidiens et les performances des annonces pour les contenus revendiqués par le propriétaire de contenu.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métriques sur les revenus et les performances des annonces par pays

Cette demande permet de récupérer des métriques sur les performances des annonces et les revenus spécifiques à chaque pays pour les contenus revendiqués du propriétaire de contenu. Les résultats sont triés par montant de revenus par ordre décroissant, ce qui signifie que le premier pays répertorié sera celui où le partenaire a généré les revenus estimés les plus élevés.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 : vidéos générant les revenus les plus élevés

Cette demande permet de récupérer des métriques sur les revenus et les performances des annonces pour les 10 vidéos revendiquées par le propriétaire du contenu et qui ont généré les revenus les plus élevés. Les résultats sont triés par montant de revenus par ordre décroissant, ce qui signifie que la première vidéo sera celle qui a généré les revenus estimés les plus élevés.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Métriques sur les performances des annonces pour différents types d'annonces

Cette demande permet de récupérer des métriques sur les performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Les résultats sont regroupés par type d'annonce, ce qui vous permet de comparer les revenus et les valeurs de CPM pour différents types d'annonces.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType