Remarque:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
Cette page liste les rapports que les propriétaires de contenu peuvent récupérer avec l'API YouTube Analytics. Les rapports de propriétaires de contenu contiennent des métriques pour les chaînes associées à un propriétaire de contenu YouTube spécifié. Les métriques sont des mesures individuelles de l'activité des utilisateurs, des performances des annonces ou des revenus estimés.
Les rapports sur les vidéos contiennent des métriques sur l'activité des utilisateurs, les performances des annonces et les revenus estimés des vidéos sur les chaînes d'un propriétaire de contenu.
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos dans le contexte d'une playlist. Les rapports sur les playlists utilisent de nombreuses dimensions et filtres identiques à ceux des rapports sur les vidéos.
Les rapports sur les performances des annonces contiennent des métriques liées aux revenus et aux performances des annonces. Elles utilisent la dimension adType pour regrouper les métriques en fonction des types d'annonces diffusées pendant la lecture des vidéos. La section Rapports sur les performances des annonces explique les deux types de métriques de performances des annonces compatibles avec l'API.
Récupérer un rapport
Pour récupérer un rapport sur le propriétaire de contenu, appelez la méthode reports.query de l'API et définissez la valeur du paramètre ids dans la requête de l'API sur contentOwner==OWNER_NAME, où OWNER_NAME spécifie l'ID du propriétaire du contenu. En cas de doute, demandez à votre Partner Manager.
Autorisation
Toutes les requêtes envoyées à l'API YouTube Analytics doivent être autorisées. Le guide d'autorisation explique comment utiliser le protocole OAuth 2.0 pour récupérer des jetons d'autorisation.
Les requêtes de l'API YouTube Analytics utilisent les champs d'application d'autorisation suivants:
Affichez les rapports YouTube Analytics sur votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques d'activité des utilisateurs, comme le nombre de vues et le nombre d'évaluations.
Afficher les rapports YouTube Analytics sur les revenus concernant votre contenu YouTube Cette portée permet d'accéder aux métriques sur l'activité des utilisateurs, ainsi qu'aux métriques sur les revenus estimés et les performances des annonces.
https://www.googleapis.com/auth/youtube
Gérez votre compte YouTube. Dans l'API YouTube Analytics, les propriétaires de chaînes utilisent cette portée pour gérer les groupes et les éléments de groupe YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Consultez et gérez les éléments YouTube et le contenu associé sur YouTube. Dans l'API YouTube Analytics, les propriétaires de contenu utilisent cette portée pour gérer les groupes et les éléments de groupe YouTube Analytics.
Remarque:Les métriques marquées d'un astérisque (*) nécessitent un jeton d'autorisation qui accorde l'accès au champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly.*
Filtres
Toutes les requêtes d'API visant à récupérer des rapports sur les propriétaires de contenu doivent filtrer les données à l'aide de la dimension video, de la dimension channel, de la dimension isCurated ou d'une combinaison compatible des dimensions claimedStatus et uploaderType. (Les combinaisons compatibles sont listées dans la définition de la dimension uploaderType.)
Les tableaux qui expliquent les rapports compatibles identifient les filtres pouvant être utilisés pour un rapport donné. Dans les descriptions, les filtres entre parenthèses sont facultatifs. Par exemple, si un rapport indique video(,country) comme option de filtrage, vous pouvez le filtrer pour n'inclure que les données d'une vidéo spécifique ou d'une vidéo spécifique dans un pays spécifique.
L'API permet également de spécifier plusieurs valeurs pour les filtres video, playlist et channel. Si vous spécifiez plusieurs valeurs pour l'un de ces filtres, vous pouvez également l'ajouter à la liste des dimensions que vous spécifiez pour la requête. Cela est vrai même si le filtre n'est pas répertorié comme dimension compatible pour un rapport particulier.
Consultez la définition du paramètre filters pour découvrir comment filtrer les résultats de l'API en fonction d'une valeur ou d'un ensemble de valeurs spécifiques.
Comprendre les tableaux de rapports
Cette section explique la mise en forme et la terminologie utilisées dans les tableaux qui définissent les rapports compatibles avec l'API. Le tableau suivant liste les dimensions, métriques et filtres acceptés pour le rapport "Détails de la lecture" sur les vidéos à l'aide de la dimension "Temps" et de la métrique averageViewPercentage.
Le tableau contient deux lignes pour les dimensions, une ligne pour les métriques et trois lignes pour les filtres. Pour les dimensions et les filtres, les valeurs de chaque ligne peuvent être combinées dans une requête API tant que la combinaison respecte les règles d'utilisation du tableau. Par exemple, les valeurs de paramètre dimensions valides pour ce rapport sont les suivantes:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Toutefois, la valeur du paramètre day,month n'est pas valide, car elle utilise deux dimensions basées sur le temps, et la requête doit utiliser 0 ou 1.
Terminologie du tableau des rapports
Les tableaux utilisent la terminologie suivante pour indiquer si les dimensions sont obligatoires ou facultatives:
Ces termes signifient qu'une valeur est obligatoire :
Obligatoire:vous devez inclure la valeur.
Utiliser exactement 1:vous devez inclure une valeur du groupe.
Utilisez-en au moins une:vous pouvez inclure une ou toutes les valeurs du groupe, mais vous devez en inclure au moins une.
Les termes suivants indiquent qu'une valeur est facultative :
Facultatif:vous pouvez inclure la valeur.
Utilisez 0 ou 1:vous pouvez inclure une valeur du groupe.
Utiliser 0 ou plus:vous pouvez inclure une ou toutes les valeurs du groupe.
Important:Toutes les requêtes d'API permettant de récupérer des rapports sur les vidéos des propriétaires de contenu doivent filtrer les données à l'aide de la dimension video, de la dimension channel, de la dimension group ou d'une combinaison compatible des dimensions claimedStatus et uploaderType. (Certains rapports ne sont pas compatibles avec toutes ces options.) Les combinaisons acceptées, qui sont également listées dans la définition de la dimension uploaderType, sont les suivantes :
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
Signalements de vidéos
Statistiques de base
Statistiques de base (y compris le nombre d'abonnés)
Ce rapport fournit des statistiques sur les actions des utilisateurs sur toutes les chaînes d'un propriétaire de contenu. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifiques. Vous pouvez également l'utiliser pour ne récupérer que les statistiques sur les contenus revendiqués, y compris ceux mis en ligne par le propriétaire du contenu, des tiers ou les deux.
Ce rapport fournit des statistiques pour un État américain ou le district de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
Ce rapport fournit des statistiques sur les actions des utilisateurs sur toutes les chaînes d'un propriétaire de contenu pour des intervalles de temps spécifiques. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifiques.
Activité des utilisateurs dans les États américains pour des périodes spécifiques
Ce rapport fournit des statistiques pour un État américain ou le district de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par pays pour toutes les chaînes d'un propriétaire de contenu. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'une chaîne spécifique.
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour les États américains et le District de Columbia. Pour ce rapport, vous devez définir la valeur du paramètre filters sur country==US.
Activité des utilisateurs par ville (<= 250 résultats)
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 250 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par ville.
Les rapports détaillés sur la lecture fournissent des statistiques sur les attributs de visionnage suivants:
La vidéo regardée était-elle diffusée en direct ou à la demande ?
Le spectateur était-il abonné à la chaîne propriétaire de la vidéo ?
Sur quel produit YouTube la vue a-t-elle eu lieu ?
Techniquement, les dimensions de détails de lecture compatibles avec ces rapports sont toutes facultatives. Si vous n'incluez pas de dimensions de détails de lecture dans votre requête, le rapport renvoyé sera semblable à l'un des rapports statistiques de base, basés sur le temps ou géographie des utilisateurs.
Remarque:La dimension et le filtre liveOrOnDemand ne peuvent pas être utilisés avec la métrique averageViewPercentage. Par conséquent, chacune des sous-sections suivantes liste deux rapports. L'un des rapports est compatible avec la dimension (et le filtre) liveOrOnDemand, tandis que l'autre l'est avec la métrique averageViewPercentage.
Activité des utilisateurs par état d'abonnement
Ce rapport fournit des métriques sur l'activité des utilisateurs pour les spectateurs abonnés et non abonnés. Les statistiques peuvent être regroupées par période (jour ou mois). Le rapport peut également être filtré par pays, continent ou subContinent.
Activité des utilisateurs par état d'abonnement pour les provinces
Ce rapport fournit des métriques sur l'activité des utilisateurs pour les spectateurs abonnés et non abonnés dans les États américains ou le district de Columbia. Ce rapport accepte moins de métriques que le précédent.
Détails de la lecture avec une dimension temporelle facultative
La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez utiliser les paramètres de requête startDate et endDate pour spécifier la plage de dates couverte par le rapport. Si elle est présente, elle indique que vous souhaitez que les données du rapport soient agrégées par jour, par mois, etc.
Détails de la lecture avec une dimension temporelle facultative et des statistiques liveOrOnDemand
Ce rapport fournit des statistiques détaillées sur la lecture pour des intervalles de temps spécifiques. Il est compatible avec la dimension (et le filtre) liveOrOnDemand.
Le rapport suivant est semblable au précédent. Il est compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
Détails de la lecture par province avec les statistiques liveOrOnDemand
Ce rapport fournit des statistiques détaillées sur la lecture pour les États américains et le district de Columbia. Il est compatible avec la dimension (et le filtre) liveOrOnDemand.
Le rapport suivant est semblable au précédent. Il est compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés qui ont généré le plus de vues ou la plus longue durée de visionnage pour le contenu d'un propriétaire de contenu. Lorsque vous récupérez ce rapport, vous devez définir le filtre insightPlaybackLocationType sur EMBEDDED.
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé à vos contenus vidéo. Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée.
Remarque:Ce rapport renvoie une erreur si le produit de nombre de vidéos interrogées X nombre de jours de la période dépasse 50 000. Par exemple, une requête qui récupère des données pour 500 ID vidéo peut demander des données pendant 100 jours maximum. Pour réduire le nombre de lignes renvoyées par une requête, divisez votre requête en plusieurs requêtes qui spécifient moins de vidéos ou définissent des périodes plus courtes.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des sites référents ayant généré le plus de vues pour le contenu du propriétaire. Les sites référents sont classés par type de source de trafic. La définition de la dimension insightTrafficSourceDetail identifie les sources de trafic pour lesquelles le rapport est disponible. Par exemple, si vous définissez le filtre insightTrafficSourceType sur ADVERTISING, le rapport indiquera les types d'annonces qui ont généré le plus de vues ou de durées de visionnage pour le contenu du propriétaire.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED ne sont pas compatibles.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport regroupe les statistiques de visionnage en fonction du type d'appareil utilisé par les spectateurs pour regarder vos contenus. Par exemple, il identifie le nombre de vues sur les tablettes ou les consoles de jeu.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues sur les appareils Android ou sur les PlayStation.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows.
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées pour les différentes valeurs de la dimension de détails de lecture subscribedStatus.
Par exemple, si un rapport utilise la dimension subscribedStatus, il renvoie des données viewerPercentage qui totalisent 100 % pour les vues avec abonnement et des données viewerPercentage qui totalisent 100 % pour les vues sans abonnement. (La valeur totale de tous les champs viewerPercentage du rapport est de 200 %).
Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que des données viewerPercentage pour une seule valeur de la dimension subscribedStatus.
Engagement et partage de contenu
Ce rapport fournit des statistiques sur la fréquence à laquelle les vidéos de la chaîne ont été partagées sur différentes plates-formes de réseaux sociaux.
Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. La dimension elapsedVideoTimeRatio mesure la durée de la vidéo écoulée pour les valeurs de métrique correspondantes. Les métriques audienceWatchRatio et relativeRetentionPerformance fournissent deux mesures qui indiquent la capacité de la vidéo à fidéliser son audience. La première est une valeur absolue, tandis que la seconde indique les performances de la vidéo par rapport à d'autres vidéos YouTube d'une durée similaire.
Remarque:Les rapports sur la fidélisation de l'audience ne permettent pas de spécifier une liste de valeurs séparées par une virgule pour le filtre video. La valeur doit spécifier un seul ID vidéo.
Remarque:Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière de 200 ou moins. Les données antérieures au 1er janvier 2013 ne sont disponibles que pour les 10 premières vidéos. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Vidéos les plus regardées globalement, par pays, par continent ou par sous-continent (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires du propriétaire de contenu en fonction des critères de filtrage et de tri spécifiés.
Top des vidéos globales par État des États-Unis (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires du propriétaire de contenu dans un État américain ou le district de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
Principales vidéos pour les spectateurs abonnés ou non(<= 200 résultats)
Ce rapport liste les vidéos les plus populaires pour les spectateurs abonnés ou non. Vous pouvez filtrer le rapport pour afficher les vidéos les plus regardées par pays, continent ou subContinent. Le rapport précédent vous permet de récupérer les vidéos les plus populaires dans un État des États-Unis donné pour les spectateurs abonnés ou non, mais il accepte moins de métriques que celui-ci.
Vidéos populaires par produit YouTube (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires, et est compatible avec les détails de lecture et les filtres géographiques. Ce rapport est semblable au précédent, mais il accepte moins de métriques et est compatible avec le filtre youtubeProduct.
Top des vidéos avec filtres de détails de lecture (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires du propriétaire de contenu, filtrées par une ou plusieurs dimensions de détails de lecture: liveOrOnDemand, subscribedStatus et youtubeProduct. Le rapport permet également de filtrer les données par région.
Les rapports sur les playlists contiennent des métriques sur l'activité des utilisateurs concernant les vidéos des playlists du propriétaire de la chaîne. Deux versions de ces rapports sont disponibles. Pour chaque rapport disponible, les sections suivantes contiennent une description de chaque version:
L'onglet Recommandé de chaque section décrit le format de requête d'API recommandé pour récupérer le rapport correspondant. Les rapports recommandés sont compatibles avec un ensemble étendu de métriques, y compris des métriques vidéo agrégées et des métriques dans les playlists. Ce format de requête n'utilise pas la dimension isCurated.
L'onglet Utiliser isCurated de chaque section décrit un ancien format de requête d'API dans lequel la dimension isCurated est requise. Ces rapports ne sont compatibles qu'avec les métriques dans la playlist. Notez que la dimension isCurated est obsolète pour tous les rapports. L'avertissement ci-dessous explique le calendrier d'abandon.
L'avertissement suivant explique plus en détail les différences entre les deux versions du rapport.
Métriques vidéo agrégées
Ces métriques fournissent des métriques sur l'activité des utilisateurs et les impressions agrégées pour toutes les vidéos de la playlist qui appartiennent également à la chaîne propriétaire de la playlist. Les métriques des vidéos appartenant à d'autres chaînes ne sont pas calculées dans l'agrégation. Par conséquent, si une chaîne crée une playlist qui ne contient que des vidéos appartenant à d'autres chaînes, les rapports sur ces playlists ne fourniront pas de valeurs pour ces métriques.
Pour obtenir la liste des métriques vidéo agrégées acceptées par YouTube, consultez la section Métriques de playlist acceptées.
Métriques dans les playlists
Ces métriques reflètent l'activité et l'engagement des utilisateurs en lien avec la page de la playlist. Ces métriques incluent les vues de toutes les vidéos de la playlist, quelle que soit la chaîne à laquelle elles appartiennent, mais ne comptabilisent que les vues qui ont eu lieu dans le contexte de la playlist.
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les vidéos des playlists sur les chaînes d'un propriétaire de contenu. Le rapport ne contient aucune dimension requise.
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les vidéos des playlists des chaînes d'un propriétaire de contenu sur des périodes spécifiques. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist ou d'une chaîne spécifique.
Ce rapport fournit des statistiques sur l'activité des playlists pour les États américains et le District de Columbia. Pour ce rapport, vous devez inclure country==US dans la valeur du paramètre filters.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés qui ont généré le plus de vues ou de durée de visionnage pour les playlists d'un propriétaire de contenu.
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé au contenu de votre playlist. Par exemple, il identifie le nombre de vues provenant d'une recherche Google ou d'une page de chaîne.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des sites référents ayant généré le plus de vues pour les playlists du propriétaire du contenu. Les sites référents sont classés par type de source de trafic. La définition de la dimension insightTrafficSourceDetail identifie les sources de trafic pour lesquelles le rapport est disponible. Par exemple, si vous définissez le filtre insightTrafficSourceType sur ADVERTISING, le rapport indiquera les types d'annonces qui ont généré le plus de vues ou de durées de visionnage pour les playlists du propriétaire du contenu.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED ne sont pas compatibles.
le type d'appareil et le système d'exploitation ;
Type d'appareil pour les playlists
Ce rapport regroupe les statistiques de visionnage en fonction du type d'appareil utilisé par les spectateurs pour regarder le contenu de votre playlist. Par exemple, il identifie le nombre de vues sur les appareils mobiles ou les consoles de jeu.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues de playlists sur des appareils Android ou des PlayStation.
Système d'exploitation et type d'appareil pour les playlists
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues de playlists sur des tablettes Android ou des ordinateurs de bureau Windows.
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées pour différentes valeurs ou combinaisons de valeurs pour les dimensions "Détails de la lecture" (subscribedStatus et youtubeProduct).
Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie des données viewerPercentage qui totalisent 100 % pour les vues avec abonnement et des données viewerPercentage qui totalisent 100 % pour les vues sans abonnement. (La valeur totale de tous les champs viewerPercentage du rapport est de 200 %).
Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que des données viewerPercentage pour une valeur (ou une combinaison de valeurs) pour les dimensions "Détails de la lecture".
Top des playlists
Remarque:Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière de 200 ou moins. Les données antérieures au 1er janvier 2013 ne sont disponibles que pour les 10 premières playlists. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport liste les playlists les plus populaires du propriétaire de contenu en fonction des critères de filtrage et de tri spécifiés.
Remarque:Les rapports sur les performances des annonces nécessitent un jeton d'autorisation qui accorde l'accès à la portée https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant la lecture de vidéos. Ces métriques comptabilisent chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
Voici les métriques de performances des annonces basées sur les impressions:
De plus, certains rapports vidéo sont compatibles avec les métriques de performances des annonces basées sur la lecture suivantes. Toutefois, ces métriques ne sont pas incluses dans les rapports sur les performances des annonces.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/11/15 (UTC).
[null,null,["Dernière mise à jour le 2024/11/15 (UTC)."],[],[]]
