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.
- Trier les demandes selon plusieurs dimensions/métriques
- Rapports sur les canaux
- 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
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
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
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
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
Signalements de vidéos
"J'aime" et "Je n'aime pas" par type de contenu
Cette requête récupère le nombre de "J'aime" et "Je n'aime pas" pour chaque type de contenu d'une chaîne.
dimensions=creatorContentType metrics=likes,dislikes
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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
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
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