YouTube Analytics API: Channel Reports

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.

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.list YouTube 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:

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 d'évaluations.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly 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.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

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.

Sommaire
Dimensions :
[None]
Métriques :
Utiliser 1 ou plus vues, vues sur YouTube Red, commentaires, j'aime, je n'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGainedadImpressions
Filtres :
Utilisez 0 ou 1. country, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe

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.

Sommaire
Dimensions :
[None]
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Obligatoire province
Utilisez 0 ou 1. vidéo, groupe

Basés sur le 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écifiques.

Sommaire
Dimensions :
Utiliser exactement 1 jour, mois
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, commentaires, j'aime, je n'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGainedadImpressions
Filtres :
Utilisez 0 ou 1. country, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe

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.

Sommaire
Dimensions :
Utiliser exactement 1 jour, mois
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Obligatoire province
Utilisez 0 ou 1. vidéo, groupe

Zone géographique de l'utilisateur

Activité des utilisateurs par pays

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.

Sommaire
Dimensions :
Obligatoire country
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, vues sur YouTube Red, commentaires, j'aime, je n'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGainedadImpressions
Filtres :
Utilisez 0 ou 1. continent, subContinent
Utilisez 0 ou 1. vidéo, groupe

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 :
Obligatoire province
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Obligatoire country==US
Utilisez 0 ou 1. vidéo, groupe

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.

Sommaire
Dimensions :
Obligatoire city
Utiliser 0 ou plus creatorContentType, country, province, subscribedStatus

Remarque:Si vous incluez la dimension province, vous devez également utiliser le filtre country==US.
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Options de tri: -vues
-estimatedMinutesWatched

Activité des utilisateurs par DMA

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.

Sommaire
Dimensions :
Obligatoire dma
Utilisez 0 ou 1. day
month
creatorContentType
subscribedStatus
Métriques :
Utiliser 1 ou plus vues
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
Filtres :
Utilisez 0 ou 1. country==US
province
Utilisez 0 ou 1. groupe
vidéo
Options de tri: -vues
-estimatedMinutesWatched

Détails de la lecture

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.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, redViews, j'aime, ne j'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Utilisez 0 ou 1. country, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Facultatif subscribedStatus

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.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus province, subscribedStatus

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.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct
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.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Utilisez 0 ou 1. jour, mois
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

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 :
Obligatoire country
Utiliser 0 ou plus creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Utilisez 0 ou 1. continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct
Détails de la lecture par pays 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.

Sommaire
Dimensions :
Obligatoire country
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utilisez 0 ou 1. continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

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 :
Obligatoire province
Utiliser 0 ou plus creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Obligatoire country==US
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct
Détails de la lecture par province 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.

Sommaire
Dimensions :
Obligatoire province
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Obligatoire country==US
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

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 laquelle les vidéos ont été lues.

Sommaire
Dimensions :
Obligatoire insightPlaybackLocationType
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus

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 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.

Sommaire
Dimensions :
Obligatoire insightPlaybackLocationDetail
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Obligatoire insightPlaybackLocationType==EMBEDDED
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus
Options de tri: -vues
-estimatedMinutesWatched

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 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.

Sommaire
Dimensions :
Obligatoire insightTrafficSourceType
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus

Détails sur la source de trafic (<= 25 résultats)

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.

Sommaire
Dimensions :
Obligatoire insightTrafficSourceDetail
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Obligatoire insightTrafficSourceType (voir la note sous le tableau)
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus
Options de tri: -vues
-estimatedMinutesWatched

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.

Sommaire
Dimensions :
Obligatoire deviceType
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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 sur les appareils Android ou sur les PlayStation.

Sommaire
Dimensions :
Obligatoire operatingSystem
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

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 les tablettes Android ou les ordinateurs de bureau Windows.

Sommaire
Dimensions :
Obligatoire deviceType, operatingSystem
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct

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 :
Utiliser 1 ou plus ageGroup, gender
Utiliser 0 ou plus creatorContentType, liveOrOnDemand, subscribedStatus
Métriques :
Utiliser 1 ou plus viewerPercentage
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus
Remarque:Les valeurs viewerPercentage de ce rapport ne sont pas normalisées pour différentes valeurs ou combinaisons de valeurs pour les dimensions "Détails de la lecture" (subscribedStatus, liveOrOnDemand ou youtubeProduct).

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.

Sommaire
Dimensions :
Obligatoire sharingService
Utiliser 0 ou plus creatorContentType, subscribedStatus
Métriques :
Utiliser 1 ou plus actions
Filtres :
Utilisez 0 ou 1. country, continent, subContinent
Utilisez 0 ou 1. vidéo, groupe
Facultatif subscribedStatus

Rétention d'audience

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.

Sommaire
Dimensions :
Obligatoire elapsedVideoTimeRatio
Métriques :
Utiliser 1 ou plus audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
Filtres :
Obligatoire vidéo
Utiliser 0 ou plus audienceType
subscribedStatus
youtubeProduct

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.

Sommaire
Dimensions :
Utilisez 0 ou 1. livestreamPosition
Métriques :
Utiliser 1 ou plus averageConcurrentViewers
peakConcurrentViewers
Filtres :
Obligatoire vidéo

Vidéos les plus regardées

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.

Sommaire
Dimensions :
Obligatoire vidéo
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, vues sur YouTube Red, commentaires, j'aime, je n'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGainedadImpressions
Filtres :
Utilisez 0 ou 1. country, continent, subContinent
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 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.

Sommaire
Dimensions :
Obligatoire vidéo
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Obligatoire province
Facultatif subscribedStatus
Options de tri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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.

Sommaire
Dimensions :
Obligatoire vidéo
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, j'aime, ne j'aime pas, videosAddedToPlaylists, videosRemovedFromPlaylists, partages, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtres :
Facultatif subscribedStatus
Utilisez 0 ou 1. country, continent, subContinent
Options de tri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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.

Sommaire
Dimensions :
Obligatoire vidéo
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utiliser 0 ou plus subscribedStatus, youtubeProduct
Options de tri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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.

Sommaire
Dimensions :
Obligatoire vidéo
Facultatif creatorContentType
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Utilisez 0 ou 1. country, province, continent, subContinent
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct
Options de tri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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:

  • 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.

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.

À l'aide de isCurated
Sommaire
Dimensions :
[None]
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1
Utilisez 0 ou 1. playlist, groupe
Utilisez 0 ou 1. country, province, continent, subContinent
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Basés sur le 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.

Zone géographique de l'utilisateur

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.

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.

Contextes de lecture

Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les vidéos de votre playlist ont été lues.

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 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.

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, il identifie le nombre de vues générées par une recherche Google.

Détails sur la source de trafic (<= 25 résultats)

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.

Recommandé
Sommaire
Dimensions :
Obligatoire insightTrafficSourceDetail
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtres :
Obligatoire insightTrafficSourceType==ADVERTISING (ou une autre valeur acceptée)
Utiliser exactement 1 playlist, groupe
Options de tri: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
À l'aide de isCurated
Sommaire
Dimensions :
Obligatoire insightTrafficSourceDetail
Métriques :
Utiliser 1 ou plus vues, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1;insightTrafficSourceType==ADVERTISING (ou une autre valeur acceptée)
Utilisez 0 ou 1. playlist, groupe
Utilisez 0 ou 1. country, province, continent, subContinent
Facultatif subscribedStatus
Options de tri: -views
-estimatedMinutesWatched
-playlistStarts

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.

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 sur les appareils Android ou sur les PlayStation.

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 les tablettes Android ou les ordinateurs de bureau Windows.

Données démographiques des spectateurs

À l'aide de isCurated
Sommaire
Dimensions :
Utiliser 1 ou plus ageGroup, gender
Utiliser 0 ou plus subscribedStatus
Métriques :
Obligatoire viewerPercentage
Filtres :
Obligatoire isCurated==1
Utilisez 0 ou 1. playlist, groupe
Utilisez 0 ou 1. country, province, continent, subContinent
Facultatif subscribedStatus
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.

À l'aide de isCurated
Sommaire
Dimensions :
Obligatoire playlist
Métriques :
Utiliser 1 ou plus vues, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1
Utilisez 0 ou 1. country, province, continent, subContinent
Utiliser 0 ou plus playlist, subscribedStatus, youtubeProduct
Options de tri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Rapports sur les abonnements

Résiliations d'abonnements

Ce rapport fournit des statistiques sur les raisons pour lesquelles les utilisateurs ont résilié leur souscription à une chaîne.

Sommaire
Dimensions :
Utilisez 0 ou 1. membershipsCancellationSurveyReason
Métriques :
Obligatoire membershipsCancellationSurveyResponses

Rapport sur les performances des annonces

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.

Performances des annonces par type d'annonce

Sommaire
Dimensions :
Obligatoire adType
Facultatif jour
Métriques :
Utiliser 1 ou plus grossRevenue, adImpressions, cpm
Filtres :
Utilisez 0 ou 1. vidéo, groupe
Utilisez 0 ou 1. country, continent, subContinent