Cette page liste les rapports que les propriétaires de chaîne 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, entre autres, le nombre de vues, d'évaluations et d'abonnés.
Les rapports sur les vidéos fournissent des statistiques sur l'activité des utilisateurs concernant les vidéos d'une chaîne.
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos dans le contexte d'une playlist.
Les rapports sur les performances des annonces contiennent des métriques liées aux revenus et aux performances des annonces. Elles utilisent la dimension adType pour regrouper les métriques en fonction des types d'annonces diffusées pendant la lecture des vidéos. La section Rapports sur les performances des annonces explique les deux types de métriques de performances des annonces compatibles avec l'API.
Récupérer un rapport
Pour récupérer un rapport sur 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 de chaîne 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 qui commence par les lettres UC, mais son format est susceptible d'être modifié. (Vous trouverez l'ID de votre chaîne sur la page Paramètres avancés de votre compte pour votre chaîne YouTube, ou vous pouvez le récupérer de manière programmatique à l'aide de la méthode channels.listYouTube Data API's.)
Autorisation
Toutes les requêtes envoyées à l'API YouTube Analytics doivent être autorisées. Le guide d'autorisation explique comment utiliser le protocole OAuth 2.0 pour récupérer des jetons d'autorisation.
Les requêtes de l'API YouTube Analytics utilisent les champs d'application d'autorisation suivants:
Affichez les rapports YouTube Analytics sur votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques d'activité des utilisateurs, comme le nombre de vues et le nombre d'évaluations.
Afficher les rapports YouTube Analytics sur les revenus concernant votre contenu YouTube Cette portée permet d'accéder aux métriques sur l'activité des utilisateurs, ainsi qu'aux métriques sur les revenus estimés et les performances des annonces.
https://www.googleapis.com/auth/youtube
Gérez votre compte YouTube. Dans l'API YouTube Analytics, les propriétaires de chaînes utilisent cette portée pour gérer les groupes et les éléments de groupe YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Consultez et gérez les éléments YouTube et le contenu associé sur YouTube. Dans l'API YouTube Analytics, les propriétaires de contenu utilisent cette portée pour gérer les groupes et les éléments de groupe YouTube Analytics.
Remarque:Les métriques sur les revenus estimés et les performances des annonces ne sont pas disponibles pour les rapports sur les canaux. Par conséquent, le champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly n'accorde actuellement pas d'accès aux données financières dans ces rapports.
Filtres
Les tableaux qui expliquent les rapports compatibles indiquent les filtres pouvant ê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 vidéo est obligatoire, tandis que le filtre pays 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 particulier.
Consultez la définition du paramètre filters pour découvrir comment filtrer les résultats de l'API en fonction d'une valeur ou d'un ensemble de valeurs spécifiques.
Comprendre les tableaux de rapports
Cette section explique la mise en forme et la terminologie utilisées dans les tableaux qui définissent les rapports compatibles avec l'API. Le tableau suivant liste les dimensions, métriques et filtres acceptés pour le rapport "Détails de la lecture" sur les vidéos à l'aide de la dimension "Temps" et de la métrique averageViewPercentage.
Le tableau contient deux lignes pour les dimensions, une ligne pour les métriques et trois lignes pour les filtres. Pour les dimensions et les filtres, les valeurs de chaque ligne peuvent être combinées dans une requête API tant que la combinaison respecte les règles d'utilisation du tableau. Par exemple, les valeurs de paramètre dimensions valides pour ce rapport sont les suivantes:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Toutefois, la valeur du paramètre day,month n'est pas valide, car elle utilise deux dimensions basées sur le temps, et la requête doit utiliser 0 ou 1.
Terminologie du tableau des rapports
Les tableaux utilisent la terminologie suivante pour indiquer si les dimensions sont obligatoires ou facultatives:
Ces termes signifient qu'une valeur est obligatoire :
Obligatoire:vous devez inclure la valeur.
Utiliser exactement 1:vous devez inclure une valeur du groupe.
Utilisez-en au moins une:vous pouvez inclure une ou toutes les valeurs du groupe, mais vous devez en inclure au moins une.
Les termes suivants indiquent qu'une valeur est facultative :
Facultatif:vous pouvez inclure la valeur.
Utilisez 0 ou 1:vous pouvez inclure une valeur du groupe.
Utiliser 0 ou plus:vous pouvez inclure une ou toutes les valeurs du groupe.
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écifiques.
Statistiques de base sur l'activité des utilisateurs par État américain
Ce rapport fournit des statistiques pour un État américain ou le district de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
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écifiques.
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 spécifiques. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par pays pour une chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo spécifique.
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour les États américains et le district de Columbia.
Pour ce rapport, vous devez définir la valeur du paramètre filters sur country==US.
Activité des utilisateurs par ville (<= 250 résultats)
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 250 ou moins. Contrairement à la plupart des autres rapports, celui-ci vous oblige également à spécifier une valeur pour le paramètre de requête sort.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par ville.
Ce rapport fournit des statistiques sur l'activité des utilisateurs par zone de marché désignée (DMA). Pour ce rapport, vous devez définir la valeur du paramètre filters sur country==US ou filtrer sur une province (État des États-Unis) spécifique.
Les rapports détaillés sur la lecture fournissent des statistiques sur les attributs de visionnage suivants:
La vidéo regardée était-elle diffusée en direct ou à la demande ?
Le spectateur était-il abonné à la chaîne propriétaire de la vidéo ?
Sur quel produit YouTube la vue a-t-elle eu lieu ?
Remarque:La dimension et le filtre liveOrOnDemand ne peuvent pas être utilisés avec la métrique averageViewPercentage. Par conséquent, chacune des sous-sections suivantes liste deux rapports. L'un des rapports est compatible avec la dimension (et le filtre) liveOrOnDemand, tandis que l'autre l'est avec la métrique averageViewPercentage.
Activité des utilisateurs par état d'abonnement
Ce rapport fournit des métriques sur l'activité des utilisateurs pour les spectateurs abonnés et non abonnés. Les statistiques peuvent être regroupées par période (jour ou mois). Le rapport peut également être filtré par pays, continent ou subContinent.
Activité des utilisateurs par état d'abonnement pour les provinces
Ce rapport fournit des métriques sur l'activité des utilisateurs pour les spectateurs abonnés et non abonnés dans les États américains ou le district de Columbia. Ce rapport accepte moins de métriques que le précédent.
Détails de la lecture avec une dimension temporelle facultative
La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez utiliser les paramètres de requête startDate et endDate pour spécifier la plage de dates couverte par le rapport. Si elle est présente, elle indique que vous souhaitez que les données du rapport soient agrégées par jour, par mois, etc.
Détails de la lecture avec une dimension temporelle facultative et des statistiques liveOrOnDemand
Ce rapport fournit des statistiques détaillées sur la lecture pour des intervalles de temps spécifiques. Il est compatible avec la dimension (et le filtre) liveOrOnDemand.
Détails de la lecture avec une dimension temporelle facultative et la 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.
Le rapport suivant est semblable au précédent. Il est compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
Détails de la lecture par province avec les statistiques liveOrOnDemand
Ce rapport fournit des statistiques détaillées sur la lecture pour les États américains et le district de Columbia. Il est compatible avec la dimension (et le filtre) liveOrOnDemand.
Le rapport suivant est semblable au précédent. Il est compatible avec la métrique averageViewPercentage, mais pas avec liveOrOnDemand en tant que dimension ou filtre.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés qui ont généré le plus de vues ou de durée de visionnage pour les vidéos d'une chaîne.
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé à vos contenus vidéo. Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée.
Remarque:Ce rapport renvoie une erreur si le produit de nombre de vidéos interrogées X nombre de jours de la période dépasse 50 000. Par exemple, une requête qui récupère des données pour 500 ID vidéo peut demander des données pendant 100 jours maximum. Pour réduire le nombre de lignes renvoyées par une requête, divisez votre requête en plusieurs requêtes qui spécifient moins de vidéos ou définissent des périodes plus courtes.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des sites référents ayant généré le plus de vues pour le contenu 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 indiquera les types d'annonces qui ont généré le plus de vues ou de durées de visionnage pour le contenu de la chaîne.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED ne sont pas compatibles.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé à votre contenu vidéo. Par exemple, il identifie le nombre de vues sur les appareils mobiles ou les consoles de jeu.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues sur les appareils Android ou sur les PlayStation.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows.
Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie des données viewerPercentage qui totalisent 100 % pour les vues avec abonnement et des données viewerPercentage qui totalisent 100 % pour les vues sans abonnement. (La valeur totale de tous les champs viewerPercentage du rapport est de 200 %).
Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que des données viewerPercentage pour une valeur (ou une combinaison de valeurs) pour les dimensions "Détails de la lecture".
Engagement et partage de contenu
Ce rapport fournit des statistiques sur la fréquence à laquelle les vidéos de la chaîne ont été partagées sur différentes plates-formes de réseaux sociaux.
Ce rapport mesure la capacité d'une vidéo à retenir son audience et indique également la fréquence de visionnage de certaines parties de la vidéo. La dimension elapsedVideoTimeRatio mesure la durée de la vidéo écoulée pour les valeurs de métrique 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 dans quelle mesure une vidéo parvient à retenir les spectateurs lors de la lecture par rapport aux autres vidéos YouTube d'une durée similaire.
Statistiques précises sur les visionnages
Ces métriques fournissent des informations sur la fréquence de visionnage de parties spécifiques d'une vidéo.
startedWatching indique le nombre de fois où les spectateurs ont commencé à regarder une vidéo au cours d'un segment particulier.
stoppedWatching indique le nombre de fois où les spectateurs ont arrêté de regarder une vidéo au cours d'un segment spécifique.
totalSegmentImpressions indique le nombre de fois où un segment particulier de la vidéo a été regardé.
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.
Spectateurs simultanés (pour les diffusions en direct)
Ce rapport indique le nombre de spectateurs simultanés à un moment donné pour une vidéo diffusée en direct.
Le filtre spécifie la vidéo. La dimension "Position" représente généralement une minute.
Remarque:Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière de 200 ou moins. Les données antérieures au 1er janvier 2013 ne sont disponibles que pour les 10 premières vidéos. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Principales vidéos avec des 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 afficher les vidéos les plus regardées par pays, continent ou subContinent.
Ce rapport liste les vidéos les plus populaires de votre chaîne dans un État américain ou le district de Columbia. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport par pays décrit ci-dessus.
Principales vidéos pour les spectateurs abonnés ou non(<= 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne pour les spectateurs abonnés ou non. Vous pouvez filtrer le rapport pour afficher les vidéos les plus regardées par pays, continent ou subContinent. Le rapport précédent vous permet de récupérer les vidéos les plus populaires dans un État des États-Unis donné pour les spectateurs abonnés ou non, mais il accepte moins de métriques que celui-ci.
Vidéos populaires par produit YouTube (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne. Il est compatible avec les détails de lecture et les filtres géographiques. Ce rapport est semblable au précédent, mais il accepte moins de métriques et est compatible avec le filtre youtubeProduct.
Top des vidéos avec filtres de détails de lecture (<= 200 résultats)
Ce rapport liste les vidéos les plus populaires de la chaîne, filtrées par une ou toutes les dimensions de détails de 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.
Les rapports sur les playlists contiennent des métriques sur l'activité des utilisateurs concernant les vidéos des playlists du propriétaire de la chaîne. Deux versions de ces rapports sont disponibles. Pour chaque rapport disponible, les sections suivantes contiennent une description de chaque version:
L'onglet Recommandé de chaque section décrit le format de requête d'API recommandé pour récupérer le rapport correspondant. Les rapports recommandés sont compatibles avec un ensemble étendu de métriques, y compris des métriques vidéo agrégées et des métriques dans les playlists. Ce format de requête n'utilise pas la dimension isCurated.
L'onglet Utiliser isCurated de chaque section décrit un ancien format de requête d'API dans lequel la dimension isCurated est requise. Ces rapports ne sont compatibles qu'avec les métriques dans la playlist. Notez que la dimension isCurated est obsolète pour tous les rapports. L'avertissement ci-dessous explique le calendrier d'abandon.
L'avertissement suivant explique plus en détail les différences entre les deux versions du rapport.
Métriques vidéo agrégées
Ces métriques fournissent des métriques sur l'activité des utilisateurs et les impressions agrégées pour toutes les vidéos de la playlist qui appartiennent également à la chaîne propriétaire de la playlist. Les métriques des vidéos appartenant à d'autres chaînes ne sont pas calculées dans l'agrégation. Par conséquent, si une chaîne crée une playlist qui ne contient que des vidéos appartenant à d'autres chaînes, les rapports sur ces playlists ne fourniront pas de valeurs pour ces métriques.
Pour obtenir la liste des métriques vidéo agrégées acceptées par YouTube, consultez la section Métriques de playlist acceptées.
Métriques dans les playlists
Ces métriques reflètent l'activité et l'engagement des utilisateurs en lien avec la page de la playlist. Ces métriques incluent les vues de toutes les vidéos de la playlist, quelle que soit la chaîne à laquelle elles appartiennent, mais ne comptabilisent que les vues qui ont eu lieu dans le contexte de la playlist.
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les vidéos des playlists de la chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist spécifique.
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.
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.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés qui ont généré le plus de vues ou de durée de visionnage pour les vidéos des playlists de la chaîne.
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, il identifie le nombre de vues générées par une recherche Google.
Remarque:Pour ce rapport, vous devez définir le paramètre maxResults sur une valeur entière de 25 ou moins. Contrairement à la plupart des autres rapports, celui-ci vous oblige également à spécifier une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des sites référents ayant généré le plus de vues pour les vidéos des playlists 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 indiquera les types d'annonces ayant généré le plus de vues ou de durées de visionnage pour les playlists de la chaîne.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED ne sont pas compatibles.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport regroupe les statistiques de visionnage en fonction de la façon dont les spectateurs ont accédé aux vidéos de vos playlists. Par exemple, il identifie le nombre de vues sur les appareils mobiles ou les consoles de jeu.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues sur les appareils Android ou sur les PlayStation.
Ce rapport regroupe les statistiques de visionnage en fonction des systèmes d'exploitation et des types d'appareils des spectateurs.
Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows.
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées pour les différentes valeurs de la dimension subscribedStatus (État de l'abonnement) des détails de lecture.
Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie des données viewerPercentage qui totalisent 100 % pour les vues avec abonnement et des données viewerPercentage qui totalisent 100 % pour les vues sans abonnement. (La valeur totale de tous les champs viewerPercentage du rapport est de 200 %).
Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que des données viewerPercentage pour une seule valeur des dimensions subscribedStatus.
Top des playlists
Remarque:Pour ces rapports, vous devez définir le paramètre maxResults sur une valeur entière de 200 ou moins. Les données antérieures au 1er janvier 2013 ne sont disponibles que pour les 10 premières playlists. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.
Ce rapport liste les playlists les plus populaires de la chaîne en fonction des critères de filtrage et de tri spécifiés.
Remarque:Les rapports sur les performances des annonces nécessitent un jeton d'autorisation qui accorde l'accès à la portée https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant la lecture de vidéos. Ces métriques comptabilisent chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
Voici les métriques de performances des annonces basées sur les impressions:
De plus, certains rapports vidéo sont compatibles avec les métriques de performances des annonces basées sur la lecture suivantes. Toutefois, ces métriques ne sont pas incluses dans les rapports sur les performances des annonces.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/11/15 (UTC).
[null,null,["Dernière mise à jour le 2024/11/15 (UTC)."],[],[]]
