Cette page liste les rapports que les propriétaires de chaînes peuvent récupérer avec l'API YouTube Analytics. Les rapports sur les chaînes fournissent des métriques sur l'activité des utilisateurs pour une chaîne spécifique. Ils mesurent, par exemple, le nombre de vues des vidéos, les notes et le nombre d'abonnés.
Récupérer un rapport
Pour récupérer un rapport sur un canal, vous devez définir la valeur du paramètre ids dans votre requête API sur l'une des valeurs suivantes :
-
channel==MINE : l'API renvoie les données de la chaîne YouTube de l'utilisateur authentifié.
-
channel==CHANNEL_ID : définissez CHANNEL_ID sur l'ID unique de la chaîne pour laquelle vous récupérez des données. L'utilisateur qui autorise la demande doit être le propriétaire de la chaîne.
L'ID de la chaîne est actuellement une chaîne de caractères qui commence par les lettres UC, mais son format peut changer. (Vous trouverez l'ID de votre chaîne sur la page Paramètres avancés du compte de votre chaîne YouTube. Vous pouvez également récupérer l'ID de votre chaîne de manière programmatique à l'aide de la méthode YouTube Data API's channels.list.)
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 sur les revenus estimés et les performances des annonces ne sont pas disponibles pour le moment dans les rapports sur les chaînes. Par conséquent, le champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly n'accorde actuellement pas l'accès aux données monétaires de ces rapports.
Filtres
Les tableaux qui expliquent les rapports compatibles identifient les filtres qui peuvent être utilisés pour chaque rapport. Dans les tableaux, les filtres entre parenthèses sont facultatifs. Par exemple, pour l'option de filtrage video(,country), le filtre video est obligatoire, tandis que le filtre country est facultatif.
L'API permet également de spécifier plusieurs valeurs pour les filtres video et playlist. 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.
Signalements de vidéos
Statistiques de base
Statistiques de base sur l'activité des utilisateurs
Ce rapport fournit des statistiques sur les actions des utilisateurs sur une chaîne. 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, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtres : |
|
Statistiques de base sur l'activité des utilisateurs 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é des utilisateurs par pays pour des périodes spécifiques
Ce rapport fournit des statistiques sur les actions des utilisateurs sur une chaîne 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 sur l'activité des utilisateurs 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 une chaîne, pays par pays. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo 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 : Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière de 250 ou moins. 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.
Activité des utilisateurs par zone de marché désignée
Ce rapport fournit des statistiques sur l'activité des utilisateurs par zone de marché désignée (DMA, Designated Market Area). Pour ce rapport, vous devez définir la valeur du paramètre filters sur country==US ou filtrer les données sur une province (ou un État américain) spécifique.
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 ?
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. Il est compatible avec la métrique averageViewPercentage.
| 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 les vidéos d'une chaîne.
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 de la chaîne. 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 de la chaîne.
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 de la manière dont les spectateurs ont accédé à vos contenus vidéo. 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
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 différentes valeurs ou combinaisons de valeurs pour les dimensions de détails de lecture (
subscribedStatus,
liveOrOnDemand ou
youtubeProduct).
Par exemple, un rapport qui utilise la dimension
subscribedStatus 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 valeur (ou une combinaison de valeurs) des dimensions de détails de lecture.
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 à retenir son audience et indique également la fréquence à laquelle des parties spécifiques d'une vidéo ont été regardées. La dimension elapsedVideoTimeRatio mesure la durée écoulée de la vidéo pour les valeurs de métriques correspondantes. Les métriques peuvent être divisées en deux catégories :
-
Rétention d'audience
Ces métriques indiquent dans quelle mesure la vidéo fidélise son audience.
audienceWatchRatio est un ratio qui compare le nombre de fois où une partie d'une vidéo a été regardée au nombre total de vues de la vidéo.relativeRetentionPerformance indique la capacité d'une vidéo à retenir les spectateurs lors de la lecture par rapport à d'autres vidéos YouTube de durée similaire.
-
Statistiques de visionnage précises
Ces métriques fournissent des informations sur la fréquence à laquelle des parties spécifiques d'une vidéo ont été regardées.
startedWatching indique la fréquence à laquelle les spectateurs ont commencé à regarder une vidéo pendant un segment spécifique.stoppedWatching indique la fréquence à laquelle les spectateurs ont arrêté de regarder une vidéo pendant une séquence spécifique.totalSegmentImpressions indique la fréquence à laquelle un segment spécifique de la vidéo a été visionné.
Remarque : Ce rapport ne permet 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.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Spectateurs simultanés (pour les diffusions en direct)
Ce rapport indique le nombre de spectateurs simultanés à une position donnée pour une seule vidéo diffusée en direct.
Le filtre spécifie la vidéo. La dimension "Position" représente généralement une seule minute.
| 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.
Principales vidéos avec filtres régionaux facultatifs (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne. Vous pouvez filtrer le rapport pour lister les vidéos les plus regardées par pays, continent ou subContinent.
| 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 : |
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost |
Top des vidéos par État (≤ 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne 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 : |
-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 de la chaîne pour les 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 : |
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Meilleures vidéos par produit YouTube (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne et est compatible avec les filtres de détails de lecture et géographiques. 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 de la chaîne, en filtrant par une ou plusieurs dimensions de détail de la lecture : liveOrOnDemand, subscribedStatus et youtubeProduct. Contrairement au rapport précédent, celui-ci est compatible avec le filtre liveOrOnDemand, mais pas avec la métrique averageViewPercentage.
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 de la chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist spécifique.
| 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 de la chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist 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
Activité des playlists par pays
Ce rapport fournit des statistiques sur les interactions des utilisateurs d'un pays donné avec les vidéos des playlists de la chaîne.
| 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 devez filtrer les résultats afin de n'afficher que les données pour les États-Unis.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur lesquelles les vidéos de votre playlist 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 les vidéos des playlists de la chaîne.
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la façon dont les spectateurs ont accédé au contenu de votre playlist.
Par exemple, elle identifie le nombre de vues générées par une recherche Google.
| 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 ayant généré le plus de vues pour les vidéos des playlists de la chaîne. Les URL de provenance sont classées 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 liste les types d'annonces qui ont généré le plus de vues ou de temps de visionnage pour les playlists de la chaîne.
| 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
Ce rapport regroupe les statistiques de visionnage en fonction de la façon dont les spectateurs ont trouvé les vidéos de vos playlists. 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
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 sur des tablettes Android ou des ordinateurs Windows.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
Données démographiques des spectateurs
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
| Filtres : |
|
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 de la chaîne en fonction des critères de filtrage et de tri spécifiés.
Rapports sur les membres
Résilier des abonnements
Ce rapport fournit des statistiques indiquant pourquoi les utilisateurs ont résilié leur souscription à la chaîne.
| Sommaire |
| Dimensions : |
|
| Métriques : |
|
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 : |
|
