Metrics

Ce document définit les métriques que vous pouvez récupérer à l'aide de l'API YouTube Analytics. Cette API est compatible avec les requêtes en temps réel et génère des rapports YouTube Analytics personnalisés.

Les métriques sont des mesures individuelles de l'activité des utilisateurs, des performances des annonces ou des revenus estimés. Les métriques sur l'activité des utilisateurs incluent, par exemple, le nombre de vues et les notes (J'aime et Je n'aime pas) des vidéos.

Métriques principales

Bien que l'API YouTube Analytics soit soumise au règlement d'obsolescence défini dans les Conditions d'utilisation, les métriques (et dimensions) non principales ne le sont pas. Dans les définitions de cette page, toute métrique de base est explicitement identifiée comme telle.

La liste ci-dessous identifie les métriques principales de l'API.

Pour en savoir plus, consultez la liste des API YouTube soumises au règlement relatif aux abandons.

Afficher les métriques

vues (métrique de base)
Cette métrique représente différents nombres dans différents types de rapports :
  • Dans les rapports sur les vidéos, cette métrique indique le nombre de fois où une vidéo a été visionnée.
  • Dans les rapports sur les playlists qui n'utilisent pas la dimension isCurated, cette métrique spécifie le nombre total de vues des vidéos de la playlist, que ces vues aient eu lieu dans le contexte de la playlist ou non. Notez que la valeur de la métrique n'inclut que les vues des vidéos du propriétaire de la chaîne.

    Dans ces rapports, la métrique playlistViews indique le nombre de fois que les vidéos de cette playlist ont été vues dans le contexte d'une playlist spécifique.
  • Dans les rapports sur les playlists qui utilisent la dimension isCurated, cette métrique indique le nombre de fois où les vidéos ont été regardées dans le contexte d'une playlist spécifique. Notez que la métrique playlistViews n'est pas compatible avec ces rapports.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Cette métrique est définie dans la section Métriques sur les playlists.
redViews
Nombre de fois où une vidéo a été regardée par des membres YouTube Premium (anciennement YouTube Red).
viewerPercentage (métrique principale)
Pourcentage de spectateurs qui étaient connectés lorsqu'ils ont regardé la vidéo ou la playlist. This is a core metric and is subject to the Deprecation Policy.

Métriques sur la durée de visionnage

estimatedMinutesWatched (métrique principale)
Nombre de minutes pendant lesquelles les utilisateurs ont regardé des vidéos pour la chaîne, le propriétaire de contenu, la vidéo ou la playlist spécifiée. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Nombre de minutes pendant lesquelles les membres YouTube Premium (anciennement YouTube Red) ont regardé une vidéo.
averageViewDuration (métrique principale)
Durée moyenne, en secondes, des lectures vidéo. Depuis le 13 décembre 2021, cette métrique exclut le trafic généré par les extraits en boucle. Dans un rapport sur une playlist, cette métrique indique la durée moyenne (en secondes) des visionnages de vidéos qui ont eu lieu dans le cadre d'une playlist. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Pourcentage moyen de vidéo regardée pendant la lecture d'une vidéo. Depuis le 13 décembre 2021, cette métrique exclut le trafic généré par les extraits en boucle.

Métriques sur l'engagement

commentaires (métrique principale)
Nombre de fois où les utilisateurs ont commenté une vidéo. Pour en savoir plus, consultez le Centre d'aide YouTube. This is a core metric and is subject to the Deprecation Policy.
J'aime (métrique principale)
Nombre de fois où les utilisateurs ont indiqué avoir aimé une vidéo en lui attribuant une note positive. This is a core metric and is subject to the Deprecation Policy.
Non-j'aime (métrique principale)
Nombre de fois où les utilisateurs ont indiqué ne pas aimer une vidéo en lui attribuant une note négative. This is a core metric and is subject to the Deprecation Policy.
parts (métrique principale)
Nombre de fois où les utilisateurs ont partagé une vidéo à l'aide du bouton Share. Pour en savoir plus, consultez le Centre d'aide YouTube. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (métrique principale)
Nombre de fois où les utilisateurs se sont abonnés à une chaîne. This is a core metric and is subject to the Deprecation Policy.

Les chaînes peuvent gagner ou perdre des abonnés à plusieurs endroits, y compris sur la page de lecture de la vidéo, la page de la chaîne et le guide qui s'affiche sur la page d'accueil de YouTube. Dans les rapports sur les chaînes, cette métrique inclut les abonnés gagnés sur l'un de ces sites. Toutefois, dans les rapports qui utilisent la dimension video ou le paramètre filter pour limiter la réponse aux données d'une vidéo spécifique, la métrique subscribersGained n'inclut que les statistiques de la page de lecture de la vidéo spécifiée.
subscribersLost (métrique principale)
Nombre de fois où des utilisateurs se sont désabonnés d'une chaîne. This is a core metric and is subject to the Deprecation Policy.

Les données de cette métrique sont enregistrées de la même manière que la métrique subscribersGained. Dans les rapports sur les chaînes, cette métrique inclut les abonnés perdus via n'importe quel mécanisme permettant aux utilisateurs de se désabonner d'une chaîne. Toutefois, dans les rapports qui utilisent la dimension video ou le paramètre filter pour limiter la réponse aux données d'une vidéo spécifique, cette métrique n'inclut que les utilisateurs qui se sont désabonnés de la page de lecture de la vidéo spécifiée.
videosAddedToPlaylists
Nombre de fois où des vidéos ont été ajoutées à des playlists YouTube. Les vidéos peuvent avoir été ajoutées à la playlist du propriétaire de la vidéo ou à celle d'autres chaînes.

La valeur de la métrique inclut le nombre de fois où les vidéos ont été ajoutées à des playlists par défaut, comme la playlist "À regarder plus tard". Toutefois, elle ne comptabilise pas les playlists auxquelles une vidéo est automatiquement ajoutée, comme la playlist de vidéos mises en ligne d'une chaîne ou l'historique des vidéos regardées d'un utilisateur.

Cette métrique renvoie un nombre absolu. Autrement dit, si un utilisateur ajoute une vidéo à une playlist, la supprime, puis l'ajoute à nouveau, la valeur de la métrique reflète le fait que la vidéo a été ajoutée à une playlist deux fois. Les données de cette métrique ne sont pas disponibles avant le 1er octobre 2014.
videosRemovedFromPlaylists
Nombre de fois où des vidéos ont été supprimées de playlists YouTube. Les vidéos peuvent avoir été supprimées de la playlist du propriétaire de la vidéo ou de celle d'autres chaînes.

La valeur de la métrique inclut le nombre de fois où les vidéos ont été supprimées de playlists par défaut, comme la playlist "À regarder plus tard ".

Cette métrique renvoie un nombre absolu. Autrement dit, si un utilisateur ajoute une vidéo à une playlist, la supprime, l'ajoute à nouveau, puis la supprime à nouveau, la valeur de la métrique reflète la suppression de la vidéo de la playlist deux fois. Les données de cette métrique ne sont pas disponibles avant le 1er octobre 2014.

Données relatives aux playlists

Les rapports sur les playlists contiennent deux types de métriques qui expliquent comment les spectateurs interagissent avec les vidéos d'une playlist:

  • Les métriques vidéo agrégées 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 connaître la définition des métriques vidéo agrégées compatibles, consultez les sections Métriques de visionnage et Métriques de durée de visionnage de ce document.

  • Les métriques dans la playlist reflètent l'activité et l'engagement des utilisateurs dans le contexte 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 à laquelle elles appartiennent, mais ne comptabilisent que les vues qui ont eu lieu dans le contexte de la playlist.

La plupart des métriques listées ci-dessous sont des métriques de playlist. Les autres métriques de la liste, comme la métrique playlistSaves, concernent les interactions des utilisateurs avec la playlist elle-même et non avec les vidéos de la playlist. Par conséquent, ces métriques ne peuvent pas être qualifiées de métriques vidéo agrégées ni de métriques dans la playlist.

averageTimeInPlaylist
Durée moyenne estimée, en minutes, pendant laquelle un spectateur a regardé des vidéos dans une playlist après le lancement de la playlist. Notez que cette métrique n'inclut que les vues de playlist sur le Web.
playlistAverageViewDuration
Durée moyenne estimée, en secondes, regardée par visionnage de playlist. Notez que cette métrique représente la durée moyenne de visionnage des vidéos individuelles d'une playlist. À l'inverse, la métrique averageTimeInPlaylist représente la durée moyenne que chaque spectateur passe à regarder la playlist dans son ensemble. Cette métrique inclut les données des vidéos de playlist appartenant à d'autres chaînes.
playlistEstimatedMinutesWatched
Nombre de minutes pendant lesquelles les utilisateurs ont regardé le contenu de la playlist dans la playlist. La durée de visionnage dans d'autres contextes (par exemple, la durée de visionnage des vues enregistrées lorsque les spectateurs regardaient la même vidéo dans d'autres playlists) n'est pas comptabilisée. Cette métrique inclut les données des vidéos de playlist appartenant à d'autres chaînes.
playlistSaves
Nombre net de fois où les utilisateurs ont enregistré une playlist. Pour en savoir plus sur les playlists enregistrées, consultez le Centre d'aide YouTube. Cette métrique renvoie un nombre de modifications nettes. Autrement dit, si un utilisateur enregistre une playlist, la supprime de la liste des playlists enregistrées, puis l'enregistre à nouveau, la valeur de la métrique reflète l'ajout d'une playlist enregistrée.
playlistStarts
Nombre de fois où des spectateurs ont lancé la lecture d'une playlist. Notez que cette métrique n'inclut que les vues de playlist sur le Web.
playlistViews
Nombre de fois où les vidéos de la playlist ont été visionnées dans le contexte de cette playlist. Cette métrique inclut les données des vidéos de la playlist appartenant à d'autres chaînes.
viewsPerPlaylistStart
Nombre moyen de vues de vidéos enregistrées chaque fois qu'une playlist a été lancée. Notez que cette métrique n'inclut que les vues de playlist sur le Web.

Métriques sur les annotations

Remarque:Les rapports de l'API YouTube Analytics ne renvoient des données que pour les métriques annotationClickThroughRate et annotationCloseRate à partir du 10 juin 2012. De plus, les rapports de l'API YouTube Analytics ne renvoient que les données des métriques d'annotation restantes depuis le 16 juillet 2013.

annotationImpressions
Nombre total d'impressions d'annotations.
annotationClickableImpressions
Nombre d'annotations qui s'affichent et sur lesquelles vous pouvez cliquer.
annotationClicks
Nombre d'annotations sur lesquelles les utilisateurs ont cliqué.
annotationClickThroughRate (métrique principale)
Rapport entre le nombre d'annotations sur lesquelles les spectateurs ont cliqué et le nombre total d'impressions d'annotations cliquables. This is a core metric and is subject to the Deprecation Policy. Pour en savoir plus sur la création d'annotations et l'utilisation d'annotations avec lien, consultez le centre d'aide YouTube.
annotationClosableImpressions
Nombre d'annotations qui sont apparues et qui peuvent être fermées.
annotationCloses
Nombre d'annotations fermées.
annotationCloseRate (métrique principale)
Rapport entre le nombre d'annotations fermées par les spectateurs et le nombre total d'impressions d'annotations. This is a core metric and is subject to the Deprecation Policy.

Métriques des fiches

Le Centre d'aide YouTube contient des instructions plus détaillées sur l'ajout de fiches à vos vidéos et sur le rapport sur les fiches YouTube Analytics.

cardImpressions
Nombre d'affichages des fiches. Lorsque le panneau des fiches est ouvert, une impression est enregistrée pour chacune des fiches de la vidéo.
cardClicks
Nombre de clics sur les fiches.
cardClickRate
Taux de clics des fiches, qui correspond au nombre de clics sur une fiche par rapport au nombre d'impressions enregistrées par cette fiche.
cardTeaserImpressions
Nombre d'affichages des accroches de fiches. Une vue de vidéo peut générer plusieurs impressions de teasers.
cardTeaserClicks
Nombre de clics sur les accroches de fiches. Les clics sur l'icône de la fiche sont attribués à la dernière accroche affichée à l'utilisateur.
cardTeaserClickRate
Taux de clics des accroches de fiches, calculé en divisant le nombre de clics sur les accroches de fiches par le nombre total d'impressions de ces accroches.

Métriques sur les diffusions en direct (spectateurs simultanés)

averageConcurrentViewers
Nombre moyen de spectateurs simultanés pour une vidéo donnée. Si la dimension livestreamPosition est spécifiée pour le rapport, la valeur averageConcurrentViewers spécifie le nombre moyen de spectateurs simultanés au cours d'un segment particulier.
peakConcurrentViewers
Nombre maximal de spectateurs simultanés pour une vidéo spécifique. Si la dimension livestreamPosition est spécifiée pour le rapport, la valeur peakConcurrentViewers spécifie le nombre maximal de spectateurs simultanés pendant un segment particulier de la vidéo.

Métriques sur la rétention d'audience

audienceWatchRatio
Ratio absolu des spectateurs qui regardent la vidéo à un moment donné. Ce ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été visionnée au nombre total de vues de la vidéo. La dimension elapsedVideoTimeRatio identifie la partie de la vidéo à laquelle la métrique correspond.

Notez qu'une partie d'une vidéo peut être regardée plusieurs fois (ou pas du tout) lors d'une même session de visionnage. Par exemple, si les utilisateurs reviennent en arrière et regardent la même partie d'une vidéo plusieurs fois, le ratio absolu de cette partie de la vidéo peut être supérieur à 1.

Les exemples suivants illustrent le calcul de la valeur :
  • Une vidéo d'une minute est regardée 100 fois. La moitié des spectateurs arrêtent de regarder la vidéo au bout de 15 secondes, et le reste la regarde en entier. Aucun spectateur ne regarde une partie de la vidéo plus d'une fois. Dans ce cas, la valeur de cette métrique sera 1 pour les intervalles de temps du premier quart de la vidéo et 0.50 pour le reste de la vidéo.
  • Une vidéo d'une minute est regardée 100 fois. Tous les spectateurs regardent la vidéo en entier, mais 20 d'entre eux regardent jusqu'à la 45e seconde, puis reviennent à la 30e seconde et regardent le reste de la vidéo. Dans ce cas, la valeur de la métrique sera 1 pour les buckets temporels de la première moitié ou du dernier quart de la vidéo. Toutefois, la valeur sera 1.2 pour les intervalles de temps du troisième quart de la vidéo, car 100 % des spectateurs ont regardé ce segment de la vidéo, mais 20 % d'entre eux l'ont regardé deux fois.
relativeRetentionPerformance
Mesure qui indique dans quelle mesure une vidéo parvient à fidéliser les spectateurs lors de la lecture par rapport à toutes les vidéos YouTube d'une durée similaire. La métrique a une valeur comprise entre 0 et 1, qui identifie les performances de rétention relatives de la vidéo à un moment donné. Le point dans la vidéo est fourni par la dimension elapsedVideoTimeRatio.

Une valeur de 0 indique que la vidéo retient moins les spectateurs que toute autre vidéo d'une durée similaire, tandis qu'une valeur de 1 indique qu'elle retient mieux les spectateurs que toute autre vidéo d'une durée similaire. Une valeur médiane de 0.5 indique que la moitié des vidéos d'une durée similaire fidélisent mieux les spectateurs, tandis que l'autre moitié les fidélise moins.

L'exemple hypothétique suivant montre comment les valeurs peuvent apparaître dans un rapport. En moyenne, 90 % des spectateurs qui regardent des vidéos de 10 minutes continuent de le faire au bout de trois minutes et 70 % au bout de huit minutes. Cependant, pour une vidéo spécifique de 10 minutes, seuls 80 % des spectateurs continuent de la regarder au bout de trois minutes, mais tous continuent de la regarder au bout de huit minutes.
  • À la valeur elapsedVideoTimeRatio correspondant au point de trois minutes dans la vidéo, la métrique relativeRetentionPerformance aurait une valeur inférieure à 0.5, car à ce moment-là, la vidéo a des performances inférieures à la moyenne.
  • À la valeur elapsedVideoTimeRatio correspondant à huit minutes de la vidéo, la métrique relativeRetentionPerformance a une valeur supérieure à 0.5, car à ce moment-là, la vidéo enregistre de meilleures performances que d'autres vidéos de durée similaire.
startedWatching
Nombre de fois où un segment particulier de la vidéo a été le premier segment vu lors d'une lecture vidéo.

Par exemple, supposons que la vidéo X dure cinq minutes. Pour les besoins de ce rapport, YouTube divise la vidéo en 100 segments de trois secondes, qui sont identifiés par la dimension elapsedVideoTimeRatio. Un spectateur accède à YouTube et regarde la première minute et dix secondes de la vidéo, ce qui inclut la totalité ou une partie des 24 premiers segments de la vidéo. Lors d'une visite ultérieure sur YouTube, l'utilisateur regarde le reste de la vidéo, en reprenant la lecture au segment 24 et en continuant jusqu'au segment 100.

Cet exemple génère les valeurs de métriques de visionnage suivantes :
  • La valeur de la métrique startedWatching serait 1 pour les segments 1 et 24, et la valeur de la métrique serait 0 pour tous les autres segments.
  • La valeur de la métrique stoppedWatching serait 1 pour les segments 24 et 100, et la valeur de la métrique serait 0 pour tous les autres segments.
  • La valeur de la métrique totalSegmentImpressions serait 2 pour le segment 24, et la valeur de la métrique serait 1 pour tous les autres segments.
stoppedWatching
Nombre de fois où un segment particulier de la vidéo était le dernier segment vu lors d'une lecture vidéo. Reportez-vous à la définition de la métrique startedWatching pour voir comment cette valeur est calculée.
totalSegmentImpressions
Nombre de fois où un segment spécifique d'une vidéo a été regardé. Reportez-vous à la définition de la métrique startedWatching pour voir comment cette valeur est calculée. Notez qu'un spectateur peut regarder le même segment d'une vidéo plusieurs fois lors d'un même visionnage.

Métriques sur la résiliation des abonnements

membershipsCancellationSurveyResponses
Nombre d'enquêtes remplies par les utilisateurs de YouTube qui ont résilié leur souscription à la chaîne spécifiée au cours de la période de référence.

Métriques sur les revenus estimés

Remarque:Les métriques sur les revenus estimés sont sujettes à des ajustements en fin de mois et n'incluent pas les publicités vendues et diffusées par les partenaires. Pour en savoir plus et obtenir des informations sur les revenus estimés, consultez le Centre d'aide YouTube.

Par défaut, tous les chiffres de revenus estimés sont indiqués en USD. Toutefois, l'API YouTube Analytics est compatible avec le paramètre currency pour certaines métriques de revenus estimés et de performances des annonces, ce qui vous permet de récupérer des données de revenus estimés dans d'autres devises.
estimatedRevenue (métrique principale) (anciennement earnings)
Total des revenus nets estimés de toutes les sources publicitaires vendues par Google, ainsi que des sources non publicitaires pour la période et la région sélectionnées. This is a core metric and is subject to the Deprecation Policy.

Les métriques sur les revenus estimés font l'objet d'un ajustement en fin de mois et ne prennent pas en compte les revenus issus de la publicité vendue ou diffusée par les partenaires.
estimatedAdRevenue (anciennement adEarnings)
Total des revenus nets estimés de toutes les sources publicitaires vendues par Google pour la période et la région sélectionnées.

Les métriques sur les revenus estimés sont sujettes à un ajustement en fin de mois et n'incluent pas les publicités vendues ou diffusées par des partenaires.
estimatedRedPartnerRevenue (anciennement redPartnerRevenue)
Total des revenus estimés générés par les abonnements YouTube Premium (anciennement YouTube Red) pour les dimensions de rapport sélectionnées. La valeur de cette métrique reflète les revenus générés par les contenus musicaux et non musicaux, et est sujette à un ajustement à la fin du mois.

Métriques de performance des annonces

grossRevenue
Revenus bruts estimés, en dollars, de l'ensemble des annonces vendues par Google ou par un partenaire DoubleClick pour la période et la région sélectionnées. Les revenus bruts font l'objet d'un ajustement en fin de mois et ne prennent pas en compte la publicité diffusée par les partenaires. Les revenus bruts ne doivent pas être confondus avec les revenus estimés ou les revenus nets, qui prennent en compte votre part de propriété et les accords de partage des revenus.
cpm (anciennement impressionBasedCpm)
Revenus bruts estimés pour mille impressions d'annonces.
adImpressions (anciennement impressions)
Nombre d'impressions d'annonces validées diffusées.
monetizedPlaybacks
Nombre de fois où un spectateur a regardé votre vidéo et a vu au moins une impression d'annonce. Une lecture monétisée est comptabilisée si un spectateur voit une annonce pré-roll, mais qu'il arrête de la regarder avant même que votre vidéo ne commence. L'erreur estimée pour ce chiffre est de ±2,0%.
playbackBasedCpm
Revenu brut estimé pour mille lectures.