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écifique. 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 spécifiques aux vues de vidéos qui se produisent dans le contexte d'une playlist. Les rapports sur les playlists utilisent de nombreuses dimensions et de nombreux 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. Ils utilisent la dimension adType pour 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 explique 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 un 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 API sur contentOwner==OWNER_NAME, où OWNER_NAME spécifie l'ID du propriétaire de 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 :
| Niveaux d'accès |
| https://www.googleapis.com/auth/yt-analytics.readonly |
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 de notes. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Affichez 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 estimées sur les revenus 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 d'application pour gérer les groupes et les éléments de groupe YouTube Analytics. |
| https://www.googleapis.com/auth/youtubepartner |
Consultez et gérez vos éléments et le contenu associé sur YouTube. Dans l'API YouTube Analytics, les propriétaires de contenu utilisent ce champ d'application 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 API permettant de 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 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 qui peuvent être utilisés pour un rapport donné. Dans les descriptions, les filtres entre parenthèses sont facultatifs. Par exemple, si un rapport liste video(,country) comme option de filtrage, il peut être filtré pour n'inclure que les données d'une vidéo spécifique ou celles 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 spécifique.
Pour obtenir une explication complète sur la façon de filtrer les résultats de l'API pour une valeur ou un ensemble de valeurs spécifiques, consultez la définition du paramètre filters.
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, les métriques et les filtres acceptés pour le rapport vidéo "Détails de la lecture" à l'aide de la dimension temporelle et de la métrique averageViewPercentage.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
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. Par exemple, les valeurs de paramètre dimensions valides pour ce rapport incluent :
dimensions=daydimensions=day,subscribedStatusdimensions=month,subscribedStatus,youtubeProductdimensions=month,youtubeProduct
Toutefois, la valeur du paramètre day,month n'est pas valide, car elle utilise deux dimensions temporelles. La requête doit utiliser 0 ou 1.
Terminologie des tableaux de rapports
Les tableaux utilisent la terminologie suivante pour indiquer si les dimensions sont obligatoires ou facultatives :
- Les termes suivants indiquent qu'une valeur est requise :
- Obligatoire : vous devez inclure la valeur.
- Utiliser exactement 1 : vous devez inclure une valeur du groupe.
- Utilisez une ou plusieurs valeurs : vous pouvez inclure tout ou partie des 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 zéro ou plusieurs valeurs : vous pouvez inclure tout ou partie des valeurs du groupe.
Important : Toutes les requêtes d'API permettant de récupérer des rapports sur les vidéos d'un propriétaire de contenu doivent filtrer les données à l'aide de la dimension
video,
channel ou
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==selfclaimedStatus==claimedclaimedStatus==claimed;uploaderType==selfclaimedStatus==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écifique. Il peut également être utilisé pour récupérer uniquement les statistiques des contenus revendiqués, y compris ceux mis en ligne par le propriétaire du contenu, des tiers ou les deux.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtres : |
|
Statistiques de base pour les États américains
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 spécifique à un pays décrit ci-dessus.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
En fonction du temps
Activité pour les périodes
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écifique.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtres : |
|
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 spécifique à un pays décrit ci-dessus.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
Zone géographique des utilisateurs
Activité des utilisateurs par pays
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour tous les canaux d'un propriétaire de contenu, pays par pays. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'une chaîne spécifique.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtres : |
|
Activité des utilisateurs par province
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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
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 inférieure ou égale à 250. Contrairement à la plupart des autres rapports, celui-ci vous demande également de spécifier une valeur pour le paramètre de requête sort.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par ville.
Détails de la lecture
Les rapports détaillés sur la lecture fournissent des statistiques liées aux attributs de visionnage suivants :
- La vue concernait-elle une vidéo en direct ou une vidéo à 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étail de la lecture compatibles avec ces rapports sont toutes facultatives. Si vous n'incluez pas de dimensions de détails de lecture dans votre demande, le rapport renvoyé sera en fait semblable à l'un des rapports Statistiques de base, Basé 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. Un rapport est compatible avec la dimension (et le filtre) liveOrOnDemand, tandis que l'autre est compatible 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
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 précédent.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
Détails de la lecture avec une dimension temporelle facultative
La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez de toute façon utiliser les paramètres de requête startDate et endDate pour spécifier la plage de dates que le rapport couvrira. Si elle est présente, la dimension 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 dimension temporelle facultative et 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails de lecture avec dimension temporelle facultative et métrique averageViewPercentage
Ce rapport fournit des statistiques détaillées sur la lecture pour des intervalles de temps spécifiques.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails de la lecture par pays
Détails de la lecture par pays avec les statistiques liveOrOnDemand
Ce rapport fournit des statistiques détaillées sur la lecture, pays par pays. Il est compatible avec la dimension (et le filtre) liveOrOnDemand.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails de la lecture par pays avec la métrique averageViewPercentage
Le rapport suivant est semblable au précédent. Il est désormais compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails de la lecture par province
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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails de la lecture par province avec la métrique averageViewPercentage
Le rapport suivant est semblable au précédent. Il est désormais compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Contextes de lecture
Rapport sur les contextes de lecture vidéo
Ce rapport fournit des statistiques sur le type de page ou d'application sur lesquelles les vidéos ont été lues.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails du contexte de lecture (≤ 25 résultats)
Remarque : Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, celui-ci vous demande également de 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 temps 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.
Sources de trafic
Source de trafic
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 vues 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 dans la plage de dates 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 pour 100 jours maximum. Pour réduire le nombre de lignes renvoyées par une requête, divisez-la en plusieurs requêtes qui spécifient moins de vidéos ou définissent des périodes plus courtes.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détail de la source de trafic (≤ 25 résultats)
Remarque : Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, celui-ci vous demande également de 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 qui ont généré le plus de vues pour les contenus 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 listera les types d'annonces qui ont généré le plus de vues ou de temps de visionnage pour le contenu du propriétaire.
Remarque : Ce rapport n'est compatible qu'avec certaines sources de trafic. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED font partie de celles qui ne sont pas acceptées.
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 des tablettes ou des consoles de jeu.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Système d'exploitation
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues qui ont eu lieu sur des appareils Android ou sur des PlayStation.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Système d'exploitation et type d'appareil
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 qui ont eu lieu sur des tablettes Android ou sur des appareils Windows.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Données démographiques des spectateurs
Ce rapport regroupe les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Remarque : Les valeurs
viewerPercentage de ce rapport ne sont pas normalisées pour les différentes valeurs de la dimension de détail de la lecture
subscribedStatus.
Par exemple, si un rapport utilise la dimension
subscribedStatus, il renvoie des données
viewerPercentage dont la somme est égale à 100 % pour les vues des abonnés
et des données
viewerPercentage dont la somme est égale à 100 % pour les vues des non-abonnés. (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 indiquant la fréquence à laquelle les vidéos de la chaîne ont été partagées sur différentes plates-formes sociales.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Rétention d'audience
Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. La dimension elapsedVideoTimeRatio mesure la durée écoulée de la vidéo pour les valeurs de métriques correspondantes. Les métriques audienceWatchRatio et relativeRetentionPerformance fournissent deux mesures qui indiquent 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 : 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 de vidéo.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Vidéos les plus regardées
Remarque : Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 200. 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, ceux-ci vous obligent également à spécifier une valeur pour le paramètre de requête sort.
Les vidéos les plus populaires au total, par pays, par continent ou par sous-continent (≤ 200 résultats)
Ce rapport liste les vidéos les plus populaires du propriétaire du contenu en fonction des critères de filtrage et de tri spécifiés.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtres : |
|
| Options de tri : |
-engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost |
Meilleures vidéos globales par État américain (≤ 200 résultats)
Ce rapport liste les vidéos les plus populaires d'un 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
| Options de tri : |
-engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Meilleures vidéos pour les spectateurs abonnés ou non abonnés(≤ 200 résultats)
Ce rapport liste les vidéos les plus populaires auprès des spectateurs abonnés ou non abonnés. Vous pouvez filtrer le rapport pour lister 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 américain donné pour les spectateurs abonnés ou non abonnés, mais il est compatible avec moins de métriques que ce rapport.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtres : |
|
| Options de tri : |
-engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Meilleures vidéos par produit YouTube (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires et est compatible avec les filtres géographiques et de détails de lecture. Ce rapport est similaire au précédent, mais il est compatible avec moins de métriques et ajoute la compatibilité avec le filtre youtubeProduct.
Top des vidéos avec filtres de détails de lecture (≤ 200 résultats)
Ce rapport liste les meilleures vidéos du propriétaire du contenu, en filtrant 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.
Rapports sur les playlists
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 :
Métriques vidéo agrégées
Ces métriques fournissent des données 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 pour 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 sur la page de la playlist. Ces métriques incluent les vues de toutes les vidéos de la playlist, quel que soit le propriétaire de la chaîne, mais ne comptabilisent que les vues qui ont eu lieu dans le contexte de la playlist.
Métriques de playlist acceptées
Statistiques de base
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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtres : |
|
En fonction du temps
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 au cours de 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtres : |
|
Zone géographique des utilisateurs
Ce rapport fournit des statistiques sur les interactions des utilisateurs d'un pays donné avec les vidéos des playlists de la chaîne.
Ce rapport fournit des statistiques sur les playlists par pays.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Activité des playlists par province
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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application où les lectures de playlists ont eu lieu.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Détails du contexte de lecture (≤ 25 résultats)
Remarque : Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, celui-ci vous demande également de 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 temps de visionnage pour les playlists d'un propriétaire de contenu.
Sources de trafic
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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtres : |
|
Détail de la source de trafic (≤ 25 résultats)
Remarque : Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, celui-ci vous demande également de 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 qui ont 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 listera les types d'annonces qui ont généré le plus de vues ou de temps de visionnage pour les playlists du propriétaire du contenu.
| Sommaire |
| Dimensions : |
|
| Métriques : |
| Utilisez un ou plusieurs |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtres : |
|
| Options de tri : |
-playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts |
Remarque : Ce rapport n'est compatible qu'avec certaines sources de trafic. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED font partie de celles qui ne sont pas acceptées.
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 les contenus de votre playlist. Par exemple, il identifie le nombre de vues qui ont eu lieu sur des appareils mobiles ou des consoles de jeu.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Système d'exploitation pour les playlists
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, elle identifie le nombre de vues de playlists qui ont eu lieu sur des appareils Android ou sur des PlayStation.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
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 qui ont eu lieu sur des tablettes Android ou sur des ordinateurs de bureau Windows.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Données démographiques des spectateurs
Ce rapport regroupe les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
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
viewerPercentage qui totalisent 100 % pour les vues des abonnés
et des données
viewerPercentage qui totalisent 100 % pour les vues des non-abonnés. (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) des dimensions de détails de lecture.
Top des playlists
Remarque : Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 200. 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, ceux-ci vous obligent également à spécifier une valeur pour le paramètre de requête sort.
Ce rapport liste les playlists les plus populaires du propriétaire du 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 au champ d'application 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 des vidéos. Ces métriques tiennent compte de chaque impression d'annonce. 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
