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 sur les propriétaires de contenu contiennent des métriques sur les chaînes associées à un propriétaire de contenu YouTube donné. 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 pour les vidéos des chaînes d'un propriétaire de contenu.
Les rapports sur les playlists fournissent des statistiques liées au nombre de vues des vidéos d'une playlist. Les rapports sur les playlists utilisent en grande partie les mêmes dimensions et filtres que les rapports sur les vidéos.
Les rapports sur les performances des annonces contiennent des métriques sur les revenus et les performances des annonces. La dimension adType leur permet de regrouper les métriques en fonction des types d'annonces diffusées lors des lectures de vidéos. La section Rapports sur les performances des annonces décrit les deux types de métriques sur les performances des annonces compatibles avec l'API.
Récupérer un rapport
Pour récupérer un rapport sur les propriétaires de contenu, appelez la méthode reports.query de l'API et définissez la valeur du paramètre ids dans la requête API sur contentOwner==OWNER_NAME, où OWNER_NAME spécifie l'ID du propriétaire de contenu. Si vous n'êtes pas sûr de la valeur de cette solution, contactez votre responsable partenaire.
Autorisation
Toutes les requêtes API YouTube Analytics doivent être autorisées. Le guide sur les autorisations explique comment utiliser le protocole OAuth 2.0 pour récupérer des jetons d'autorisation.
Les requêtes API YouTube Analytics utilisent les niveaux d'autorisation suivants:
Affichez les rapports YouTube Analytics sur votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques sur l'activité des utilisateurs, comme le nombre de vues et le nombre de notes.
Consultez les rapports monétaires YouTube Analytics concernant votre contenu YouTube. Ce champ d'application 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 ce champ pour gérer les groupes et les éléments de groupes YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Affichez et gérez les éléments YouTube et le contenu associé sur YouTube. Dans l'API YouTube Analytics, les propriétaires de contenu utilisent ce champ pour gérer les groupes et les éléments de groupes 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 API pour récupérer des rapports de propriétaires de contenu doivent filtrer les données à l'aide des dimensions video, channel, isCurated ou d'une combinaison compatible des dimensions claimedStatus et uploaderType. (Les combinaisons acceptées sont répertoriées dans la définition de la dimension uploaderType.)
Les tableaux décrivant les rapports compatibles identifient les filtres que vous pouvez utiliser pour chacun d'eux. Dans les descriptions, les filtres affichés 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 uniquement celles d'une vidéo spécifique dans un pays donné.
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 demande. Ce principe s'applique même si le filtre n'est pas listé comme dimension acceptée pour un rapport particulier.
Consultez la définition du paramètre filters pour découvrir en détail comment filtrer les résultats de l'API pour une valeur ou un ensemble de valeurs spécifique.
Comprendre les tableaux de rapports
Cette section décrit la mise en forme et la terminologie utilisées dans les tableaux qui définissent les rapports compatibles avec l'API. Le tableau ci-dessous présente les dimensions, métriques et filtres compatibles avec le rapport détaillé sur la lecture des vidéos à l'aide de la dimension temporelle 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, à condition que la combinaison respecte les règles d'utilisation du tableau. Ainsi, les valeurs de paramètre dimensions valides pour ce rapport sont les suivantes:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Cependant, la valeur de paramètre day,month n'est pas valide, car elle utilise deux dimensions temporelles, mais la requête peut utiliser 0 ou 1. Dans ce cas, la valeur de paramètre subscribedStatus,youtubeProduct renvoie en fait un rapport, mais les métriques ne sont pas agrégées par jour, semaine, mois, etc. (Ce rapport est documenté séparément dans la documentation.)
Terminologie des tableaux de rapports
Les tableaux utilisent la terminologie suivante pour indiquer si des dimensions sont obligatoires ou facultatives:
Ces termes signifient qu'une valeur est requise :
Obligatoire:vous devez inclure la valeur.
Utilisation exacte 1:vous devez inclure une valeur du groupe.
Une ou plusieurs:vous pouvez inclure tout ou partie des valeurs du groupe, mais vous devez en inclure au moins une.
Ces termes signifient qu'une valeur est facultative :
Facultatif:vous avez la possibilité d'inclure la valeur.
Utiliser 0 ou 1:vous avez la possibilité d'inclure une valeur du groupe.
Utiliser 0 ou plus:vous avez la possibilité d'inclure tout ou partie des valeurs du groupe.
Important:Toutes les requêtes API pour récupérer les rapports sur les vidéos des propriétaires de contenu doivent filtrer les données à l'aide des dimensions vidéo, channel, group ou d'une combinaison compatible des dimensions claimedStatus et uploaderType. Notez que certains rapports ne sont pas compatibles avec l'ensemble de ces options. Les combinaisons compatibles, 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 concernant 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écifique. Vous pouvez également l'utiliser pour obtenir uniquement des statistiques sur le contenu revendiqué, y compris le contenu revendiqué mis en ligne par le propriétaire de contenu, des tiers ou les deux.
Ce rapport fournit des statistiques pour un État américain ou le District de Columbia en particulier. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport spécifique à un pays décrit ci-dessus.
Ce rapport présente des statistiques concernant les actions des utilisateurs sur toutes les chaînes d'un propriétaire de contenu pendant des périodes spécifiques. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifique.
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 en particulier. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport spécifique à un pays décrit ci-dessus.
Ce rapport présente des statistiques sur l'activité des utilisateurs pays 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:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 250. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport présente des statistiques sur l'activité des utilisateurs par ville.
Les rapports détaillés sur les lectures fournissent des statistiques sur les attributs d'affichage suivants:
S'agissait-il d'une vidéo diffusée en direct ou d'une vidéo à la demande ?
Le spectateur était-il abonné à la chaîne à laquelle appartient la vidéo ?
Sur quel produit YouTube le visionnage a-t-il eu lieu ?
Techniquement, les dimensions des détails de lecture compatibles avec ces rapports sont toutes facultatives. Si vous n'incluez pas de dimensions sur les détails des lectures dans votre requête, le rapport renvoyé sera en fait semblable à l'un des rapports sur les statistiques de base, basés sur le temps ou géographique de l'utilisateur.
Remarque:Vous ne pouvez pas utiliser la dimension et le filtre liveOrOnDemand avec la métrique averageViewPercentage. Chacune des sous-sections suivantes répertorie donc deux rapports. Un rapport accepte la dimension (et le filtre) liveOrOnDemand, tandis que l'autre accepte la métrique averageViewPercentage.
Activité des utilisateurs par état d'abonnement
Ce rapport fournit des métriques sur l'activité des utilisateurs abonnés et non abonnés. Vous pouvez regrouper les statistiques par période (jour ou mois), et filtrer le rapport 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 abonnés et non-abonnés dans les États américains ou dans le District de Columbia. Ce rapport accepte moins de métriques que le rapport précédent.
Informations sur la lecture avec dimension temporelle facultative
La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez quand même utiliser les paramètres de requête startDate et endDate pour spécifier la plage de dates couverte par le rapport. La dimension, si elle est présente, indique que vous souhaitez que les données du rapport soient agrégées par jour, par mois, etc.
Les détails de la lecture, avec dimension temporelle facultative et statistiques liveOrOnDemand
Ce rapport fournit des statistiques sur les détails de lecture pour des intervalles de temps spécifiques. Elle accepte la dimension (et le filtre) liveOrOnDemand.
Détails des lectures par province avec les statistiques liveOrOnDemand
Ce rapport fournit des statistiques sur les détails de lecture pour les États américains et le District de Columbia. Elle accepte la dimension (et le filtre) liveOrOnDemand.
Détails sur le contexte de lecture (<= 25 résultats)
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez 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 durée de visionnage du 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 compile les statistiques de visionnage en fonction de la manière dont les internautes ont accédé à votre contenu vidéo. Par exemple, cette métrique identifie le nombre de vues générées par une recherche Google ou par un lien vers une vidéo similaire.
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport compile les statistiques de visionnage en fonction des URL de provenance ayant généré le plus de vues pour le contenu du propriétaire de contenu. Les URL de provenance sont classées par type de source de trafic, et 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 liste les types d'annonces qui ont généré le plus de vues ou la durée de visionnage du contenu du propriétaire de contenu.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Par exemple, la source de trafic "NO_LINK_EMBEDDED" ne comporte pas d'informations supplémentaires et n'est donc pas compatible avec ce rapport. Consultez la définition de insightTrafficSourceType pour en savoir plus sur les sources de trafic compatibles avec ce rapport.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport regroupe des 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 des statistiques de visionnage en fonction du système d'exploitation des lecteurs. Par exemple, il identifie le nombre de vues enregistrées sur les appareils Android ou les PlayStation.
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation et du type d'appareil des utilisateurs. Par exemple, il identifie le nombre de vues qui ont eu lieu sur les tablettes Android ou sur les ordinateurs Windows.
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées en fonction des différentes valeurs de la dimension de détails de lecture subscribedStatus.
Par exemple, si un rapport utilise la dimension subscribedStatus, les données de viewerPercentage s'additionnent pour des vues avec un nombre d'abonnés etviewerPercentage pour les vues non abonnés. (La valeur totale de tous les champs viewerPercentage dans le 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 indiquant 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 lecture de la vidéo pour les valeurs de métriques correspondantes. Les métriques audienceWatchRatio et relativeRetentionPerformance fournissent deux mesures qui montrent dans quelle mesure la vidéo fidélise 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 de durée similaire.
Remarque:Il n'est pas possible de spécifier une liste de valeurs séparées par une virgule pour le filtre video dans les rapports sur la rétention d'audience. Un seul ID vidéo est spécifié.
Remarque:Ces rapports nécessitent que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 200. Avant le 1er janvier 2013, les données ne sont disponibles que pour les 10 vidéos les plus regardées. Contrairement à la plupart des autres rapports, ces rapports exigent également que vous spécifiiez une valeur pour le paramètre de requête sort.
Top des vidéos dans l'ensemble, 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 définis.
Top des vidéos globalement par État des États-Unis (moins de 200 résultats)
Ce rapport répertorie les vidéos les plus populaires du propriétaire de contenu dans un État américain ou dans le District de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport spécifique à un pays décrit ci-dessus.
Top des vidéos pour les spectateurs abonnés et non abonnés (<= 200 résultats)
Ce rapport répertorie les vidéos les plus populaires auprès des spectateurs abonnés et non abonnés. Vous pouvez filtrer le rapport pour afficher les vidéos les plus populaires par pays, continent ou subContinent. Le rapport précédent vous permet d'identifier les vidéos les plus regardées dans un État américain particulier pour les spectateurs abonnés et non abonnés, mais il accepte moins de métriques que ce rapport.
Top des vidéos par produit YouTube (<= 200 résultats)
Ce rapport répertorie les vidéos les plus populaires, et prend en charge 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 ajoute le filtre youtubeProduct.
Top des vidéos avec des filtres de détails de lecture (<= 200 résultats)
Ce rapport répertorie les vidéos les plus populaires du propriétaire de contenu, en les filtrant selon une ou plusieurs dimensions de détails de lecture: liveOrOnDemand, subscribedStatus et youtubeProduct. Le rapport est également compatible avec le filtrage par région.
Les rapports sur les playlists contiennent des métriques sur l'activité des utilisateurs en lien avec les vidéos figurant dans les playlists du propriétaire de la chaîne. Il existe deux versions de ces rapports et, pour chacun d'eux, les sections suivantes contiennent une description de chacune d'elles:
L'onglet Recommended (Recommandé) de chaque section décrit le format de requête API privilégié 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 agrégées sur les vidéos et des métriques dans des 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 API dans lequel la dimension isCurated est requise. Ces rapports ne sont compatibles qu'avec les métriques dans les playlists. Notez que la dimension isCurated a été abandonnée pour tous les rapports. La remarque d'avertissement ci-dessous explique le calendrier d'abandon.
La remarque d'avertissement suivante explique plus en détail les modifications entre les deux versions de rapport.
Métriques vidéo cumulées
Ces métriques fournissent des métriques sur l'activité et les impressions des utilisateurs, qui sont agrégées pour toutes les vidéos de la playlist qui appartiennent également à la chaîne à laquelle la playlist appartient. 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 ne contenant que des vidéos appartenant à d'autres chaînes, aucune valeur n'est fournie pour ces métriques dans les rapports sur ces playlists.
Ces métriques reflètent l'activité et l'engagement des utilisateurs au niveau de 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 qui en est propriétaire, mais ne prennent en compte que les vues enregistrées au niveau de la playlist.
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. Le rapport ne comporte aucune dimension requise.
Ce rapport présente des statistiques sur les interactions des utilisateurs avec les vidéos des playlists des chaînes d'un propriétaire de contenu sur des intervalles de temps spécifiques. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist ou d'une chaîne spécifiques.
Ce rapport fournit des statistiques sur l'activité des playlists pour les États américains et le District de Columbia. Pour ce rapport, vous incluez country==US dans la valeur du paramètre filters.
Détails sur le contexte de lecture (<= 25 résultats)
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés ayant généré le plus de vues ou la durée de visionnage la plus importante pour les playlists d'un propriétaire de contenu.
Ce rapport compile les statistiques de visionnage en fonction de la manière dont les internautes ont accédé au contenu de votre playlist. Par exemple, cette métrique identifie le nombre de vues générées par une recherche Google ou une page de chaîne.
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport compile les statistiques de visionnage en fonction des URL de provenance ayant généré le plus de vues pour les playlists du propriétaire de contenu. Les URL de provenance sont classées par type de source de trafic, et 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 liste les types d'annonces qui ont généré le plus de vues ou la durée de visionnage pour les playlists du propriétaire de contenu.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Par exemple, la source de trafic "NO_LINK_EMBEDDED" ne comporte pas d'informations supplémentaires et n'est donc pas compatible avec ce rapport. Consultez la définition de insightTrafficSourceType pour en savoir plus sur les sources de trafic compatibles avec ce rapport.
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 internautes pour regarder les contenus de vos playlists. Par exemple, il identifie le nombre de vues sur des appareils mobiles ou des consoles de jeu.
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation des lecteurs. Par exemple, cette métrique indique le nombre de vues de playlists effectuées sur les appareils Android ou les PlayStation.
Système d'exploitation et type d'appareil pour les playlists
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation et du type d'appareil des utilisateurs. Par exemple, il identifie le nombre de vues de playlists qui ont eu lieu 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 de détails de lecture (subscribedStatus et youtubeProduct).
Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie des données de viewerPercentage, soit 100 % pour les vues avec un nombre d'abonnés et Pourcentage de vues pour un nombre de spectateurs désabonné de 0 %.viewerPercentage (La valeur totale de tous les champs viewerPercentage dans le 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 (ou une combinaison de valeurs) pour les dimensions des détails de lecture.
Top des playlists
Remarque:Ces rapports nécessitent que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 200. Avant le 1er janvier 2013, les données ne sont disponibles que pour les 10 premières playlists. Contrairement à la plupart des autres rapports, ces rapports exigent également que vous spécifiiez 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 définis.
Remarque:Les rapports sur les performances des annonces nécessitent un jeton d'autorisation qui accorde l'accès au champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Les rapports sur les performances des annonces fournissent des statistiques basées sur les impressions pour les annonces diffusées pendant la lecture de vidéos. Ces métriques tiennent compte de chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
Les métriques de performances des annonces basées sur les impressions sont les suivantes:
En outre, certains rapports sur les vidéos sont compatibles avec les métriques de performances des annonces basées sur les lectures 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/04/08 (UTC).
[null,null,["Dernière mise à jour le 2024/04/08 (UTC)."],[],[]]
