YouTube Analytics API: Channel Reports

Les dimensions 7DayTotals et 30DayTotals deviennent obsolètes. Pour en savoir plus, consultez l'historique des révisions.

Cette page liste les rapports que les propriétaires de chaîne peuvent récupérer avec l'API YouTube Analytics. Les rapports d'une chaîne fournissent des statistiques sur l'activité des utilisateurs pour une chaîne spécifique. Ils permettent aussi de mesurer des éléments tels que le nombre de vues des vidéos, les avis et le nombre d'abonnés.

Récupérer un rapport

Pour récupérer un rapport sur les canaux, 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 des données pour la chaîne YouTube de l'utilisateur authentifié.

  • channel==CHANNEL_ID : définissez CHANNEL_ID sur l'ID de canal unique du canal pour lequel vous récupérez des données. L'utilisateur qui autorise la demande doit être le propriétaire de la chaîne.

    Actuellement, l'ID de la chaîne est une chaîne qui commence par les lettres UC, mais son format est susceptible de changer. Vous pouvez obtenir l'ID de votre chaîne sur la page Paramètres de compte avancés de votre chaîne YouTube. Vous pouvez également récupérer l'ID de votre chaîne par programmation à l'aide de la méthode channels.list YouTube Data API's.

Autorisation

Toutes les demandes de 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 demandes d'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 relatifs à votre contenu YouTube. Elle permet d'accéder aux métriques d'activité des utilisateurs, comme le nombre de vues et d'avis.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Affichez les rapports monétaires YouTube Analytics relatifs à votre contenu YouTube. Elle permet d'accéder aux métriques d'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îne utilisent ce champ d'application pour gérer les groupes et les éléments de groupe 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 d'application pour gérer les groupes et les éléments de groupe YouTube Analytics.

Remarque:Les revenus estimés et les métriques sur les performances des annonces ne sont actuellement pas compatibles avec 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 expliquant les rapports compatibles identifient les filtres pouvant être utilisés pour chaque rapport. Dans les tableaux, les filtres indiqué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 ajouter ce filtre à la liste des dimensions que vous spécifiez pour la demande. Cela est valable même si le filtre n'est pas répertorié en tant que dimension compatible pour un rapport spécifique.

Consultez la définition du paramètre filters pour découvrir 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 explique 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, les métriques et les filtres compatibles avec les rapports basés sur des codes temporels de playlist de chaîne:

Sommaire
Dimensions :
Utilisez exactement 1 caractère day month
Utiliser 0 ou plus subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Le tableau contient deux lignes pour les dimensions, une ligne pour les métriques et quatre lignes pour les filtres. Pour les dimensions et les filtres, les valeurs de chaque ligne peuvent être combinées dans une requête API, à condition que la combinaison respecte les règles d'utilisation du tableau. Par exemple, les valeurs valides pour le paramètre dimensions dans ce rapport sont les suivantes:

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Cependant, la valeur du paramètre day,month n'est pas valide, car elle utilise deux dimensions temporelles, mais la requête doit utiliser exactement la valeur 1. Dans ce cas, la valeur du paramètre subscribedStatus,youtubeProduct renvoie un rapport, mais les métriques ne sont pas agrégées par jour, par semaine, par mois, etc. (ce rapport est documenté séparément dans la documentation).

Terminologie du tableau de rapport

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.
    • Utilisez exactement le chiffre "1":vous devez inclure une valeur du groupe.
    • Utilisez une ou plusieurs valeurs : vous pouvez inclure tout ou partie des valeurs du groupe, mais vous devez en inclure au moins une.
  • Ces termes signifient qu'une valeur est facultative :
    • Facultatif:Vous avez la possibilité d'inclure la valeur.
    • Utilisez 0 ou 1 : vous avez la possibilité d'inclure une valeur provenant du groupe.
    • Utiliser 0 ou plus:vous pouvez inclure tout ou partie des valeurs du groupe.

Signalements de vidéos

Statistiques de base

Statistiques de base sur l'activité des utilisateurs

Ce rapport fournit des statistiques sur les actions des utilisateurs sur une chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifique.

Sommaire
Dimensions :
[Aucun]
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 country, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe

Statistiques de base sur l'activité des utilisateurs dans les États américains

Ce rapport fournit des statistiques pour un État des États-Unis ou un district de Columbia. Notez que ce rapport n'accepte qu'un sous-ensemble des statistiques disponibles dans le rapport spécifique au pays décrit ci-dessus.

Sommaire
Dimensions :
[Aucun]
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Obligatoire province
Utiliser 0 ou 1 vidéo, groupe

Basée sur l'heure

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 sur des périodes données. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo ou d'un pays spécifique.

Sommaire
Dimensions :
Utilisez exactement 1 caractère day month
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 country, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe

Activité des utilisateurs aux États-Unis sur des périodes spécifiques

Ce rapport fournit des statistiques sur l'activité des utilisateurs dans un État des États-Unis ou dans le District de Columbia. Notez que ce rapport n'accepte qu'un sous-ensemble des statistiques disponibles dans le rapport spécifique au pays décrit ci-dessus.

Sommaire
Dimensions :
Utilisez exactement 1 caractère day month
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Obligatoire province
Utiliser 0 ou 1 vidéo, groupe

Zone géographique de l'utilisateur

Activité des utilisateurs par pays

Ce rapport présente des statistiques sur l'activité des utilisateurs pour chaque chaîne, pays par pays. Vous pouvez filtrer le rapport pour n'afficher que les données d'une vidéo spécifique.

Sommaire
Dimensions :
Obligatoire country
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 continent, subContinent
Utiliser 0 ou 1 vidéo, groupe

Activité des utilisateurs par province

Ce rapport fournit des statistiques sur l'activité des utilisateurs dans les États des États-Unis et dans le District de Columbia. Pour ce rapport, vous devez définir la valeur du paramètre filters sur country==US.

Sommaire
Dimensions :
Obligatoire province
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Obligatoire country==FR
Utiliser 0 ou 1 vidéo, groupe

Activité des utilisateurs par ville (<= 250 résultats)

Remarque : Dans ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 250. Contrairement à la plupart des autres rapports, ce rapport nécessite que vous spécifiiez 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.
Utiliser 0 ou 1 day month
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Options de tri: -vues
-estimationMinutesWatched

Détails de la lecture

Les rapports détaillés sur les lectures fournissent des statistiques sur les attributs de visionnage suivants:

  • La vidéo en direct ou à la demande était-elle visionnée ?
  • L'internaute était-il abonné à la chaîne propriétaire de la vidéo ?
  • Sur quel produit YouTube la vidéo a-t-elle été regardée ?

Remarque:La dimension et le filtre liveOrOnDemand ne peuvent pas être utilisés conjointement avec la métrique averageViewPercentage. Ainsi, chacune des sous-sections suivantes répertorie 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. Les statistiques peuvent être regroupées par période (jour ou mois). Le rapport peut également être filtré par pays, continent ou sous-continent.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus
Utiliser 0 ou 1 day month
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 country, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Facultative subscribedStatus

Activité des utilisateurs par abonnement dans les provinces

Ce rapport fournit des métriques sur l'activité des utilisateurs abonnés et non abonnés situé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
Utiliser 0 ou 1 day month
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou plus province, subscribedStatus

Détails de la lecture avec dimension temporelle facultative

La dimension temporelle (jour ou mois) est facultative pour ces rapports, car vous devez malgré tout utiliser les paramètres de demande startDate et endDate pour spécifier la plage de dates du 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.

Détails de la lecture avec dimension temporelle facultative et statistiques liveOrOnDemand

Ce rapport fournit des statistiques de lecture détaillées sur 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
Utiliser 0 ou 1 day month
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus, youtubeProduct
Détails de la lecture avec dimension temporelle facultative et métrique averageViewPercentage

Ce rapport fournit des statistiques de lecture détaillées sur des intervalles de temps spécifiques. Il est compatible avec la métrique averageViewPercentage.

Sommaire
Dimensions :
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Utiliser 0 ou 1 day month
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 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 les lectures 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 :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Utiliser 0 ou 1 continent, subContinent
Utiliser 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. Elle accepte la métrique averageViewPercentage, mais pas liveOrOnDemand en tant que dimension ou filtre.

Sommaire
Dimensions :
Obligatoire country
Utiliser 0 ou plus creatorContentType, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtres :
Utiliser 0 ou 1 continent, subContinent
Utiliser 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 présente des statistiques de lecture détaillées pour les États des États-Unis 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 :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtres :
Obligatoire pays==US
Utiliser 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. Elle accepte la métrique averageViewPercentage, mais pas liveOrOnDemand en tant que dimension ou filtre.

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

Contextes de lecture

Rapport sur le contexte de lecture des vidéos

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

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

Détails du contexte de lecture (<= 25 résultats)

Remarque:Dans ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite 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 plus longue durée de visionnage pour les vidéos d'une chaîne.

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

Sources de trafic

Source de trafic

Ce rapport présente des statistiques de visionnage basées sur la façon dont les internautes ont accédé à votre contenu vidéo. Il permet par exemple d'identifier le nombre de vues résultant d'une recherche Google ou d'un lien vers une vidéo similaire.

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

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

Remarque : Dans ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite que vous spécifiiez une valeur pour le paramètre de requête sort.

Ce rapport présente des statistiques de visionnage basées sur les URL de provenance qui ont généré le plus de vues pour le contenu 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 qui ont généré le plus de vues ou la plus longue durée de visionnage pour le contenu de la chaîne.

Sommaire
Dimensions :
Obligatoire insightTrafficSourceDetail
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs vues, estimatedMinutesWatched
Filtres :
Obligatoire insightTrafficSourceType (voir la remarque ci-dessous)
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus
Options de tri: -vues
-estimationMinutesWatched

Remarque : Ce rapport n'est disponible que pour 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.

Type d'appareil et système d'exploitation

Type d'appareil

Ce rapport présente des statistiques de visionnage basées sur la façon dont les internautes ont accédé à votre contenu vidéo. Par exemple, il identifie le nombre de vues enregistrées sur des appareils mobiles ou des consoles de jeu.

Sommaire
Dimensions :
Obligatoire deviceType (Type d'appareil)
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs vues, estimatedMinutesWatched
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou plus OperatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Système d'exploitation

Ce rapport présente des statistiques de visionnage basées sur les systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues enregistrées sur les appareils Android ou les PlayStation.

Sommaire
Dimensions :
Obligatoire OperatingSystem (Système d'exploitation)
Utiliser 0 ou plus creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs vues, estimatedMinutesWatched
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 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'appareil des spectateurs. Par exemple, il identifie le nombre de vues enregistrées sur les tablettes Android ou sur les ordinateurs de bureau Windows.

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

Données démographiques des spectateurs

Ce rapport présente le nombre de vues cumulées en fonction de la tranche d'âge et du sexe des spectateurs.

Sommaire
Dimensions :
Utilisez 1 ou plusieurs ageGroup, gender
Utiliser 0 ou plus creatorContentType, liveOrOnDemand, subscribedStatus
Métriques :
Utilisez 1 ou plusieurs viewerPercentage
Filtres :
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou plus liveOrOnDemand, subscribedStatus
Remarque : Les valeurs viewerPercentage dans ce rapport ne sont pas normalisées pour différentes valeurs ou combinaisons de valeurs pour les dimensions de détails de la lecture (subscribedStatus, liveOrOnDemand ou youtubeProduct).

Par exemple, un rapport qui utilise la dimension subscribedStatus renvoie viewerPercentage additionnant jusqu'à 100 % de vues pour 100 %. La valeur totale de tous les champs viewerPercentage est de 200 %.

Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que les données viewerPercentage pour une seule valeur (ou combinaison de valeurs) dans les détails de lecture.

Engagement et partage de contenus

Ce rapport présente des statistiques sur la fréquence de partage des vidéos de la chaîne sur différentes plates-formes de réseaux sociaux.

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

Rétention d'audience

Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. La dimension elapsedVideoTimeRatio mesure la durée de la vidéo écoulée pour les métriques correspondantes. Les métriques audienceWatchRatio et relativeRetentionPerformance fournissent deux mesures qui montrent dans quelle mesure la vidéo retient 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. Cette valeur doit correspondre à un seul ID vidéo.

Sommaire
Dimensions :
Obligatoire elapsedVideoTimeRatio
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs audienceWatchRatio, relativeConservationPerformance
Filtres :
Obligatoire vidéo
Utiliser 0 ou plus audienceType, subscribedStatus, youtubeProduct

Vidéos les plus regardées

Remarque:Dans ces rapports, vous devez définir 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, vous devez également spécifier une valeur pour le paramètre de requête sort.

Vidéos les plus regardées avec des filtres régionaux facultatifs (<= 200 résultats)

Ce rapport répertorie 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, par continent ou par sous-continent.

Sommaire
Dimensions :
Obligatoire vidéo
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Utiliser 0 ou 1 country, continent, subContinent
Options de tri: -vues
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Vidéos les plus regardées par état (<= 200 résultats)

Ce rapport répertorie les vidéos les plus regardées de la chaîne dans un État des États-Unis ou un district de Columbia. Notez que ce rapport n'accepte qu'un sous-ensemble des statistiques disponibles dans le rapport spécifique au pays décrit ci-dessus.

Sommaire
Dimensions :
Obligatoire vidéo
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Obligatoire province
Facultative subscribedStatus
Options de tri: -vues
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Vidéos les plus regardées par les spectateurs abonnés ou non(<= 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, par continent ou par sous-continent. Le rapport précédent vous permet de récupérer les vidéos les plus regardées dans un État des États-Unis donné aux spectateurs abonnés ou non, mais il prend en charge moins de métriques que ce rapport.

Sommaire
Dimensions :
Obligatoire vidéo
Facultative creatorContentType.
Métriques :
Utilisez 1 ou plusieurs :
Filtres :
Facultative subscribedStatus
Utiliser 0 ou 1 country, continent, subContinent
Options de tri: -vues
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Vidéos les plus regardées par produit YouTube (<= 200 résultats)

Ce rapport répertorie les vidéos les plus regardées de la chaîne, ainsi que les détails de lecture et les filtres géographiques. Ce rapport est semblable au précédent, mais il contient moins de métriques et est compatible avec le filtre youtubeProduct.

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

Vidéos les plus regardées avec les filtres "Détails de la lecture" (<= 200 résultats)

Ce rapport répertorie les vidéos les plus regardées de la chaîne, en filtrant selon certaines ou toutes les dimensions des détails de lecture : liveOrOnDemand, subscribedStatus et youtubeProduct. Contrairement au rapport précédent, celui-ci accepte le filtre liveOrOnDemand et n'accepte pas la métrique averageViewPercentage.

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

Rapports sur les playlists

Statistiques de base

Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists d'une chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist ou d'un pays spécifiques.

Sommaire
Dimensions :
[Aucun]
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Basée sur l'heure

Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists d'une chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist ou d'un pays spécifiques.

Sommaire
Dimensions :
Utilisez exactement 1 caractère day month
Utiliser 0 ou plus subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Zone géographique de l'utilisateur

Activité de la playlist par pays

Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists d'une chaîne. Vous pouvez filtrer le rapport pour n'afficher que les données d'une playlist, d'un groupe de playlists ou d'un pays spécifique.

Sommaire
Dimensions :
Obligatoire country
Utiliser 0 ou plus subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Activité de la playlist par province

Ce rapport présente des statistiques sur les playlists des États américains et du District de Columbia. Pour ce rapport, incluez country==US dans la valeur du paramètre filters.

Sommaire
Dimensions :
Obligatoire province
Utiliser 0 ou plus subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1;pays==US
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Contextes de lecture

Ce rapport fournit des statistiques sur le type de page ou d'application où les playlists ont été lues.

Sommaire
Dimensions :
Obligatoire insightPlaybackLocationType
Utiliser 0 ou plus day, subscribedStatus
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Facultative subscribedStatus

Détails du contexte de lecture (<= 25 résultats)

Remarque:Dans ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite 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 plus longue durée de visionnage pour les playlists d'une chaîne.

Sommaire
Dimensions :
Obligatoire insightPlaybackLocationDetail
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1;insightPlaybackLocationType==EMBEDDED
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Facultative subscribedStatus
Options de tri: -vues
-estimatedMinutesWatched
-playlistStarts

Sources de trafic

Ce rapport regroupe les statistiques de visionnage selon la façon dont les internautes ont accédé au contenu de votre playlist. Par exemple, il identifie le nombre de vues résultant d'une recherche Google.

Sommaire
Dimensions :
Obligatoire insightTrafficSourceType
Utiliser 0 ou plus day, subscribedStatus
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Facultative subscribedStatus

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

Remarque:Dans ce rapport, vous devez définir le paramètre maxResults sur une valeur entière inférieure ou égale à 25. Contrairement à la plupart des autres rapports, ce rapport nécessite que vous spécifiiez une valeur pour le paramètre de requête sort.

Ce rapport présente des statistiques de visionnage basées sur les URL de provenance qui ont généré le plus de vues pour 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 listera les types d'annonces qui ont généré le plus de vues ou la plus longue durée de visionnage pour les playlists de la chaîne.

Sommaire
Dimensions :
Obligatoire insightTrafficSourceDetail
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated==1;insightTrafficSourceType
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Facultative subscribedStatus
Options de tri: -vues
-estimatedMinutesWatched
-playlistStarts

Remarque:Ce rapport n'est disponible que pour 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.

Type d'appareil et système d'exploitation

Type d'appareil

Ce rapport regroupe les statistiques de visionnage selon la façon dont les internautes ont accédé au contenu de votre playlist. Par exemple, il identifie le nombre de vues enregistrées sur des appareils mobiles ou des consoles de jeu.

Sommaire
Dimensions :
Obligatoire deviceType (Type d'appareil)
Utiliser 0 ou plus day, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus OperatingSystem, subscribedStatus, youtubeProduct

Système d'exploitation

Ce rapport présente des statistiques de visionnage basées sur les systèmes d'exploitation des spectateurs. Par exemple, il identifie le nombre de vues de playlists sur les appareils Android ou les PlayStation.

Sommaire
Dimensions :
Obligatoire OperatingSystem (Système d'exploitation)
Utiliser 0 ou plus day, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus deviceType, 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'appareil des spectateurs. Par exemple, il identifie le nombre de vues de playlists sur les tablettes Android ou les ordinateurs de bureau Windows.

Sommaire
Dimensions :
Obligatoire deviceType, OperatingSystem
Utiliser 0 ou plus day, subscribedStatus, youtubeProduct
Métriques :
Utilisez 1 ou plusieurs views, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Utiliser 0 ou plus subscribedStatus, youtubeProduct

Données démographiques des spectateurs

Sommaire
Dimensions :
Utilisez 1 ou plusieurs ageGroup, gender
Utiliser 0 ou plus subscribedStatus
Métriques :
Obligatoire viewerPercentage
Filtres :
Obligatoire isCurated = 1
Utiliser 0 ou 1 country, province, continent, subContinent
Utiliser 0 ou 1 playlist, groupe
Facultative subscribedStatus
Remarque:Les valeurs viewerPercentage dans ce rapport ne sont pas normalisées pour différentes valeurs ou combinaisons de valeurs pour les dimensions "Détails de la lecture" (subscribedStatus et youtubeProduct).

Par exemple, un rapport utilisant la dimension subscribedStatus renvoie les données viewerPercentage. La somme de 100 % des vues auxquelles vous êtes abonné a été ajoutée et . La valeur totale de tous les champs viewerPercentage est de 200 %.

Vous pouvez utiliser des filtres pour vous assurer que le rapport ne contient que les données viewerPercentage pour une seule valeur (ou combinaison de valeurs) dans les détails de lecture.

Top des playlists

Remarque:Dans ces rapports, vous devez définir 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 principales playlists. Contrairement à la plupart des autres rapports, vous devez également spécifier une valeur pour le paramètre de requête sort.

Ce rapport répertorie les playlists les plus populaires de la chaîne en fonction des critères de filtrage et de tri spécifiés.

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

Rapport sur les performances des annonces

Remarque:Les rapports sur les performances des annonces requièrent un jeton d'autorisation qui donne accès au champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Les rapports sur les performances des annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant les lectures 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 suivantes basées sur la lecture. 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
Facultative jour
Métriques :
Utilisez 1 ou plusieurs grossRevenue, adImpressions, cpm
Filtres :
Utiliser 0 ou 1 vidéo, groupe
Utiliser 0 ou 1 country, continent, subContinent