Cette page répertorie 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 permettent d'évaluer des éléments tels que le nombre de vues des vidéos, les notes et le nombre d'abonnements.
Les rapports sur les vidéos fournissent des statistiques sur toutes les activités des utilisateurs en lien avec les vidéos d'une chaîne.
Les rapports sur les playlists fournissent des statistiques liées au nombre de vues des vidéos d'une playlist.
Les rapports sur les performances des annonces contiennent des métriques sur les revenus et les performances des annonces. La dimension adType leur permet de regrouper les métriques en fonction des types d'annonces diffusées lors des lectures de vidéos. La section Rapports sur les performances des annonces décrit les deux types de métriques sur les performances des annonces compatibles avec l'API.
Récupérer un rapport
Pour récupérer un rapport sur les canaux, vous devez définir la valeur du paramètre ids de 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 souhaitez récupérer des données. L'utilisateur autorisé à envoyer 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 du compte de votre chaîne YouTube. Vous pouvez également récupérer l'ID de votre chaîne de manière programmatique en utilisant la méthode YouTube Data API'schannels.list.
Autorisation
Toutes les requêtes API YouTube Analytics doivent être autorisées. Le guide sur les autorisations explique comment utiliser le protocole OAuth 2.0 pour récupérer des jetons d'autorisation.
Les requêtes API YouTube Analytics utilisent les niveaux d'autorisation suivants:
Affichez les rapports YouTube Analytics sur votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques sur l'activité des utilisateurs, comme le nombre de vues et le nombre de notes.
Consultez les rapports monétaires YouTube Analytics concernant votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques sur l'activité des utilisateurs, ainsi qu'aux métriques sur les revenus estimés et les performances des annonces.
https://www.googleapis.com/auth/youtube
Gérez votre compte YouTube. Dans l'API YouTube Analytics, les propriétaires de chaînes utilisent ce champ pour gérer les groupes et les éléments de groupes YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner
Affichez et gérez les éléments YouTube et le contenu associé sur YouTube. Dans l'API YouTube Analytics, les propriétaires de contenu utilisent ce champ pour gérer les groupes et les éléments de groupes YouTube Analytics.
Remarque:Pour le moment, les métriques sur les revenus estimés et les performances des annonces ne sont pas disponibles dans 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 l'accès aux données monétaires dans ces rapports.
Filtres
Les tableaux décrivant les rapports compatibles identifient les filtres que vous pouvez utiliser pour chacun d'eux. Dans les tableaux, les filtres affichés entre parenthèses sont facultatifs. Par exemple, pour l'option de filtrage video(,country), le filtre vidéo est obligatoire et 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 demande. Ce principe s'applique même si le filtre n'est pas listé comme dimension acceptée pour un rapport particulier.
Consultez la définition du paramètre filters pour découvrir en détail comment filtrer les résultats de l'API pour une valeur ou un ensemble de valeurs spécifique.
Comprendre les tableaux de rapports
Cette section décrit la mise en forme et la terminologie utilisées dans les tableaux qui définissent les rapports compatibles avec l'API. Le tableau ci-dessous présente les dimensions, métriques et filtres compatibles avec le rapport détaillé sur la lecture des vidéos à l'aide de la dimension temporelle et de la métrique averageViewPercentage.
Le tableau contient deux lignes pour les dimensions, une ligne pour les métriques et trois lignes pour les filtres. Pour les dimensions et les filtres, les valeurs de chaque ligne peuvent être combinées dans une requête API, à condition que la combinaison respecte les règles d'utilisation du tableau. Ainsi, les valeurs de paramètre dimensions valides pour ce rapport sont les suivantes:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Cependant, la valeur de paramètre day,month n'est pas valide, car elle utilise deux dimensions temporelles, mais la requête peut utiliser 0 ou 1. Dans ce cas, la valeur de paramètre subscribedStatus,youtubeProduct renvoie en fait un rapport, mais les métriques ne sont pas agrégées par jour, semaine, mois, etc. (Ce rapport est documenté séparément dans la documentation.)
Terminologie des tableaux de rapports
Les tableaux utilisent la terminologie suivante pour indiquer si des dimensions sont obligatoires ou facultatives:
Ces termes signifient qu'une valeur est requise :
Obligatoire:vous devez inclure la valeur.
Utilisation exacte 1:vous devez inclure une valeur du groupe.
Une ou plusieurs:vous pouvez inclure tout ou partie des valeurs du groupe, mais vous devez en inclure au moins une.
Ces termes signifient qu'une valeur est facultative :
Facultatif:vous avez la possibilité d'inclure la valeur.
Utiliser 0 ou 1:vous avez la possibilité d'inclure une valeur du groupe.
Utiliser 0 ou plus:vous avez la possibilité d'inclure tout ou partie des valeurs du groupe.
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.
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 en particulier. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport spécifique à un pays décrit ci-dessus.
Activité des utilisateurs par pays pour des périodes spécifiques
Ce rapport fournit des statistiques concernant les actions des utilisateurs sur une chaîne pendant des périodes spécifiques. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifique.
Activité des utilisateurs dans les États américains pour des périodes spécifiques
Ce rapport fournit des statistiques sur l'activité des utilisateurs dans un État américain ou dans le District de Columbia en particulier. Notez que ce rapport n'est compatible qu'avec un sous-ensemble des métriques disponibles dans le rapport spécifique à un pays décrit ci-dessus.
Ce rapport présente des statistiques sur l'activité des utilisateurs pays par pays pour 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:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 250. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport présente des statistiques sur l'activité des utilisateurs par ville.
Les rapports détaillés sur les lectures fournissent des statistiques sur les attributs d'affichage suivants:
S'agissait-il d'une vidéo diffusée en direct ou d'une vidéo à la demande ?
Le spectateur était-il abonné à la chaîne à laquelle appartient la vidéo ?
Sur quel produit YouTube le visionnage a-t-il eu lieu ?
Remarque:Vous ne pouvez pas utiliser la dimension et le filtre liveOrOnDemand avec la métrique averageViewPercentage. Chacune des sous-sections suivantes répertorie donc deux rapports. Un rapport accepte la dimension (et le filtre) liveOrOnDemand, tandis que l'autre accepte la métrique averageViewPercentage.
Activité des utilisateurs par état d'abonnement
Ce rapport fournit des métriques sur l'activité des utilisateurs abonnés et non abonnés. Vous pouvez regrouper les statistiques par période (jour ou mois), et filtrer le rapport par pays, continent ou subContinent.
Activité des utilisateurs par état d'abonnement pour les provinces
Ce rapport fournit des métriques sur l'activité des utilisateurs abonnés et non-abonnés dans les États américains ou dans le District de Columbia. Ce rapport accepte moins de métriques que le rapport précédent.
Informations sur la lecture avec dimension temporelle facultative
La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez quand même utiliser les paramètres de requête startDate et endDate pour spécifier la plage de dates couverte par le rapport. La dimension, si elle est présente, indique que vous souhaitez que les données du rapport soient agrégées par jour, par mois, etc.
Les détails de la lecture, avec dimension temporelle facultative et statistiques liveOrOnDemand
Ce rapport fournit des statistiques sur les détails de lecture pour des intervalles de temps spécifiques. Elle accepte la dimension (et le filtre) liveOrOnDemand.
Détails de la lecture avec dimension temporelle facultative et métrique averageViewPercentage
Ce rapport fournit des statistiques sur les détails de lecture pour des intervalles de temps spécifiques. Elle est compatible avec la métrique averageViewPercentage.
Détails des lectures par province avec les statistiques liveOrOnDemand
Ce rapport fournit des statistiques sur les détails de lecture pour les États américains et le District de Columbia. Elle accepte la dimension (et le filtre) liveOrOnDemand.
Détails sur le contexte de lecture (<= 25 résultats)
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés qui ont généré le plus de vues ou la durée de visionnage des vidéos d'une chaîne.
Ce rapport compile les statistiques de visionnage en fonction de la manière dont les internautes ont accédé à votre contenu vidéo. Par exemple, cette métrique identifie le nombre de vues générées par une recherche Google ou par un lien vers une vidéo similaire.
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des URL de provenance ayant généré le plus de vues pour les contenus de la chaîne. Les URL de provenance sont classées par type de source de trafic, et la définition de la dimension insightTrafficSourceDetail identifie les sources de trafic pour lesquelles le rapport est disponible. Par exemple, si vous définissez le filtre insightTrafficSourceType sur ADVERTISING, le rapport liste les types d'annonces qui ont généré le plus de vues ou la durée de visionnage du contenu de la chaîne.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Par exemple, la source de trafic "NO_LINK_EMBEDDED" ne comporte pas d'informations supplémentaires et n'est donc pas compatible avec ce rapport. Consultez la définition de insightTrafficSourceType pour en savoir plus sur les sources de trafic compatibles avec ce rapport.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport compile les statistiques de visionnage en fonction de la manière dont les internautes ont accédé à votre contenu vidéo. Par exemple, il identifie le nombre de vues sur des appareils mobiles ou des consoles de jeu.
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation des lecteurs. Par exemple, il identifie le nombre de vues enregistrées sur les appareils Android ou les PlayStation.
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation et du type d'appareil des utilisateurs. Par exemple, il identifie le nombre de vues qui ont eu lieu sur les tablettes Android ou sur les ordinateurs Windows.
Par exemple, un rapport utilisant la dimension subscribedStatus renvoie viewerPercentage à 100 % d'abonnés pour un total de {00 % du nombre de vues pour un nombre d'abonnés jusqu'à 100 %.viewerPercentage (La valeur totale de tous les champs viewerPercentage dans le rapport est de 200 %.)
Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que des données viewerPercentage pour une seule valeur (ou une combinaison de valeurs) pour les dimensions des détails de lecture.
Engagement et partage de contenu
Ce rapport fournit des statistiques indiquant la fréquence à laquelle les vidéos de la chaîne ont été partagées sur différentes plates-formes de réseaux sociaux.
Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. La dimension elapsedVideoTimeRatio mesure la durée de lecture de la vidéo pour les valeurs de métriques correspondantes. Les métriques audienceWatchRatio et relativeRetentionPerformance fournissent deux mesures qui montrent dans quelle mesure la vidéo fidélise son audience. La première est une valeur absolue, tandis que la seconde indique les performances de la vidéo par rapport à d'autres vidéos YouTube de durée similaire.
Remarque:Il n'est pas possible de spécifier une liste de valeurs séparées par une virgule pour le filtre video dans les rapports sur la rétention d'audience. Un seul ID vidéo est spécifié.
Remarque:Ces rapports nécessitent que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 200. Avant le 1er janvier 2013, les données ne sont disponibles que pour les 10 vidéos les plus regardées. Contrairement à la plupart des autres rapports, ces rapports exigent également que vous spécifiiez une valeur pour le paramètre de requête sort.
Top des vidéos 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 afficher les vidéos les plus populaires par pays, continent ou subContinent.
Ce rapport répertorie 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.
Top des vidéos pour les spectateurs abonnés et non abonnés (<= 200 résultats)
Ce rapport répertorie les vidéos les plus populaires de la chaîne pour les spectateurs abonnés et non abonnés. Vous pouvez filtrer le rapport pour afficher les vidéos les plus populaires par pays, continent ou subContinent. Le rapport précédent vous permet d'identifier les vidéos les plus regardées dans un État américain particulier pour les spectateurs abonnés et non abonnés, mais il accepte moins de métriques que ce rapport.
Top des vidéos par produit YouTube (<= 200 résultats)
Ce rapport liste les vidéos les plus regardées de la chaîne, et inclut des informations sur la lecture et des filtres géographiques. Ce rapport est semblable au précédent, mais il accepte moins de métriques et ajoute le filtre youtubeProduct.
Les rapports sur les playlists contiennent des métriques sur l'activité des utilisateurs en lien avec les vidéos figurant dans les playlists du propriétaire de la chaîne. Il existe deux versions de ces rapports et, pour chacun d'eux, les sections suivantes contiennent une description de chacune d'elles:
L'onglet Recommended (Recommandé) de chaque section décrit le format de requête API privilégié pour récupérer le rapport correspondant. Les rapports recommandés sont compatibles avec un ensemble étendu de métriques, y compris des métriques agrégées sur les vidéos et des métriques dans des playlists. Ce format de requête n'utilise pas la dimension isCurated.
L'onglet Utiliser isCurated de chaque section décrit un ancien format de requête API dans lequel la dimension isCurated est requise. Ces rapports ne sont compatibles qu'avec les métriques dans les playlists. Notez que la dimension isCurated a été abandonnée pour tous les rapports. La remarque d'avertissement ci-dessous explique le calendrier d'abandon.
La remarque d'avertissement suivante explique plus en détail les modifications entre les deux versions de rapport.
Métriques vidéo cumulées
Ces métriques fournissent des métriques sur l'activité et les impressions des utilisateurs, qui sont agrégées pour toutes les vidéos de la playlist qui appartiennent également à la chaîne à laquelle la playlist appartient. Les métriques des vidéos appartenant à d'autres chaînes ne sont pas calculées dans l'agrégation. Par conséquent, si une chaîne crée une playlist ne contenant que des vidéos appartenant à d'autres chaînes, aucune valeur n'est fournie pour ces métriques dans les rapports sur ces playlists.
Ces métriques reflètent l'activité et l'engagement des utilisateurs au niveau de la page de la playlist. Ces métriques incluent les vues de toutes les vidéos de la playlist, quelle que soit la chaîne qui en est propriétaire, mais ne prennent en compte que les vues enregistrées au niveau de la playlist.
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les vidéos incluses dans les 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 incluses dans les 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 pour n'afficher que les données concernant les États-Unis.
Détails sur le contexte de lecture (<= 25 résultats)
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport identifie les lecteurs vidéo intégrés ayant généré le plus de vues ou la durée de visionnage maximale pour les vidéos incluses dans les playlists de la chaîne.
Ce rapport compile des statistiques de visionnage selon la façon dont les spectateurs ont accédé au contenu de vos playlists.
Par exemple, il identifie le nombre de vues générées par une recherche Google.
Remarque:Ce rapport nécessite que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport regroupe les statistiques de visionnage en fonction des URL de provenance ayant généré le plus de vues pour les vidéos incluses dans les playlists de la chaîne. Les URL de provenance sont classées par type de source de trafic, et la définition de la dimension insightTrafficSourceDetail identifie les sources de trafic pour lesquelles le rapport est disponible.
Par exemple, si vous définissez le filtre insightTrafficSourceType sur ADVERTISING, le rapport indiquera les types d'annonces ayant généré le plus de vues ou la durée de visionnage pour les playlists de la chaîne.
Remarque:Ce rapport n'est compatible qu'avec des sources de trafic spécifiques. Par exemple, la source de trafic "NO_LINK_EMBEDDED" ne comporte pas d'informations supplémentaires et n'est donc pas compatible avec ce rapport. Consultez la définition de insightTrafficSourceType pour en savoir plus sur les sources de trafic compatibles avec ce rapport.
le type d'appareil et le système d'exploitation ;
Type d'appareil
Ce rapport regroupe 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 des statistiques de visionnage en fonction du système d'exploitation des lecteurs. Par exemple, il identifie le nombre de vues sur les appareils Android ou les PlayStation.
Ce rapport regroupe des statistiques de visionnage en fonction du système d'exploitation et du type d'appareil des utilisateurs.
Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows.
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées en fonction des différentes valeurs de la dimension de détails de lecture subscribedStatus.
Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie des données viewerPercentage correspondant à 100 % pour les vues avec des abonnés etviewerPercentage à 100 % pour les vues non abonnées. (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:Ces rapports nécessitent que vous définissiez le paramètre maxResults sur une valeur entière inférieure ou égale à 200. Avant le 1er janvier 2013, les données ne sont disponibles que pour les 10 premières playlists. Contrairement à la plupart des autres rapports, ces rapports exigent également que vous spécifiiez une valeur pour le paramètre de requête sort.
Ce rapport liste les meilleures playlists de la chaîne en fonction des critères de filtrage et de tri définis.
Remarque:Les rapports sur les performances des annonces nécessitent un jeton d'autorisation qui accorde l'accès au champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Les rapports sur les performances des annonces fournissent des statistiques basées sur les impressions pour les annonces diffusées pendant la lecture de vidéos. Ces métriques tiennent compte de chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
Les métriques de performances des annonces basées sur les impressions sont les suivantes:
En outre, certains rapports sur les vidéos sont compatibles avec les métriques de performances des annonces basées sur les lectures suivantes : Toutefois, ces métriques ne sont pas incluses dans les rapports sur les performances des annonces.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
