Metrics

Ce document définit les métriques que vous pouvez récupérer à l'aide de l'API YouTube Analytics. Cette API prend en charge les requêtes en temps réel pour générer 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, entre autres, le nombre de vues des vidéos et les notes (mentions "J'aime" et "Je n'aime pas").

Métriques clés

Bien que l'API YouTube Analytics soit soumise au règlement relatif aux abandons défini dans les Conditions d'utilisation, les métriques et dimensions secondaires ne le sont pas. Dans les définitions figurant sur cette page, toute métrique constituant une métrique essentielle est explicitement identifiée comme telle.

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

Remarque:Les métriques principales suivantes sont désormais complètement obsolètes :
  • La métrique principale earnings a été abandonnée le 4 août 2016 et a été renommée estimatedRevenue. Conformément au règlement relatif aux abandons défini dans les Conditions d'utilisation, les métriques earnings et estimatedRevenue étaient simultanément compatibles jusqu'au 10 août 2017.
  • Les métriques principales favoritesAdded et favoritesRemoved ont été abandonnées le 31 mars 2015. Seule l'API YouTube Analytics permet de récupérer ces métriques.

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

Afficher les métriques

vues (métrique principale)
Cette métrique représente différents chiffres selon les types de rapports :
  • Dans les rapports sur les vidéos, cette métrique indique le nombre de fois où une vidéo a été regardée.
  • Dans les rapports sur les playlists qui n'utilisent pas la dimension isCurated, cette métrique indique le nombre total de vues des vidéos de la playlist, qu'elles aient eu lieu ou non dans le contexte de la playlist. Notez que 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 où les vidéos d'une playlist spécifique ont été regardées.
  • Dans les rapports sur les playlists qui utilisent la dimension isCurated, cette métrique indique le nombre de fois où des 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 des playlists.
redViews
Nombre de vues d'une vidéo par les abonnés YouTube Premium (anciennement YouTube Red).
uniques (obsolète depuis le 27 septembre 2016)
Nombre de spectateurs uniques ayant regardé une vidéo. Ce calcul est basé sur le nombre de cookies uniques et, par conséquent, sur-comptera le nombre d'utilisateurs qui utilisent plusieurs appareils ou navigateurs.
La métrique uniques a été abandonnée le 27 septembre 2016. Il ne s'agit pas d'une métrique essentielle. Elle sera prise en charge jusqu'au 31 octobre 2016.
viewerPercentage (métrique principale)
Pourcentage d'utilisateurs 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é les vidéos de la chaîne, du propriétaire de contenu, de la vidéo ou de la playlist spécifiés. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
Nombre de minutes pendant lesquelles les abonnés YouTube Premium (anciennement YouTube Red) ont regardé une vidéo.
averageViewDuration (métrique principale)
Durée moyenne des lectures de vidéos, en secondes. Depuis le 13 décembre 2021, cette métrique exclut le trafic des extraits vidéo en boucle. Dans un rapport sur les playlists, cette métrique indique la durée moyenne (en secondes) des lectures de vidéos dans le cadre d'une playlist. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Pourcentage moyen d'une vidéo visionnée pendant la lecture. Depuis le 13 décembre 2021, cette métrique exclut le trafic des extraits vidéo en boucle.

Métriques d'engagement

commentaires (métrique principale)
Nombre de fois où les utilisateurs ont laissé un commentaire sur 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.
Je n'aime pas (métrique principale)
Nombre de fois où les utilisateurs ont indiqué qu'ils n'ont pas aimé une vidéo en lui attribuant une note négative. This is a core metric and is subject to the Deprecation Policy.
shares (métrique principale)
Nombre de fois où des 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ù des utilisateurs se sont abonnés à une chaîne. This is a core metric and is subject to the Deprecation Policy.

Une chaîne peut gagner ou perdre des abonnés à plusieurs endroits, par exemple sur la page de lecture de la vidéo, sur la page de la chaîne et dans le guide qui s'affiche sur la page d'accueil YouTube. Dans les rapports sur les chaînes, cette métrique inclut les abonnés gagnés via ces canaux. 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 présenté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 tout 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 ou à celles d'autres chaînes.

La valeur de la métrique inclut le nombre de fois où les vidéos ont été ajoutées aux playlists par défaut, comme la playlist "À regarder plus tard". Toutefois, elle ne comptabilise pas les playlists auxquelles une vidéo est ajoutée automatiquement, 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, ce qui signifie que si un utilisateur ajoute une vidéo à une playlist, la supprime, puis l'ajoute de nouveau, la valeur de la métrique indique que la vidéo est ajoutée deux fois à la playlist. Les données relatives à cette statistique ne sont pas disponibles pour les dates antérieures au 1er octobre 2014.
videosRemovedFromPlaylists
Nombre de fois où des vidéos ont été supprimées de n'importe quelle playlist YouTube. Les vidéos auraient pu être supprimées de la playlist du propriétaire de la vidéo ou des playlists d'autres chaînes.

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

Cette métrique renvoie un nombre absolu, ce qui signifie que si un utilisateur ajoute une vidéo à une playlist, la supprime, l'ajoute de nouveau, puis la supprime deux fois. Les données relatives à cette statistique ne sont pas disponibles pour les dates antérieures au 1er octobre 2014.

Métriques d'engagement obsolètes

Les métriques suivantes étaient toutes deux des métriques principales, qui ont été abandonnées le 31 mars 2015.

favoritesAdded (métrique principale) (obsolète depuis le 31 mars 2015)
Nombre de fois où les utilisateurs ont marqué une vidéo comme favorite. Pour en savoir plus, consultez le Centre d'aide YouTube. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (métrique principale) (obsolète depuis le 31 mars 2015)
Nombre de fois où les utilisateurs ont supprimé une vidéo de leurs listes de vidéos préférées. Pour en savoir plus, consultez le Centre d'aide YouTube. This is a core metric and is subject to the Deprecation Policy.

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 cumulées sur les vidéos fournissent des métriques sur l'activité et les impressions des utilisateurs, regroupé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 ne contenant que des vidéos appartenant à d'autres chaînes, aucune valeur n'est fournie pour ces métriques dans les rapports sur ces playlists.

    Consultez les sections Métriques sur les vues et Métriques sur la durée de visionnage de ce document pour connaître les définitions des métriques agrégées acceptées concernant les vidéos.

  • Les métriques dans les playlists reflètent l'activité et l'engagement des utilisateurs sur la page de la playlist. Ces métriques incluent les vues de toutes les vidéos de la playlist, quelle que soit la chaîne qui les détient, mais ne prennent en compte que les vues enregistrées au niveau de la playlist.

La plupart des métriques listées ci-dessous sont des métriques dans la playlist. Les métriques restantes, comme la métrique playlistSaves, concernent les interactions de l'utilisateur avec la playlist elle-même, et non avec les vidéos de la playlist. Par conséquent, ces métriques ne sont pas considérées comme des métriques agrégées sur les vidéos ni comme des métriques dans les playlists.

averageTimeInPlaylist
Estimation du temps moyen, en minutes, pendant lequel un spectateur a visionné des vidéos d'une playlist après le lancement de celle-ci. Notez que cette métrique n'inclut que les vues de playlists qui ont eu lieu sur le Web.
playlistAverageViewDuration
Durée moyenne estimée (en secondes) regardée par chaque vue de la playlist. Notez que cette métrique représente la durée moyenne de visionnage de vidéos individuelles dans une playlist. En revanche, la métrique averageTimeInPlaylist représente le temps moyen que chaque spectateur passe à regarder la playlist dans son ensemble. Cette métrique inclut les données concernant les vidéos de playlists qui appartiennent à d'autres chaînes.
playlistEstimatedMinutesWatched
Nombre de minutes pendant lesquelles les utilisateurs ont regardé le contenu de la playlist. La durée de visionnage enregistrée dans d'autres contextes (par exemple, la durée de visionnage des vues enregistrées lorsque des spectateurs regardaient la même vidéo dans d'autres playlists) n'est pas comptabilisée. Cette métrique inclut les données concernant les vidéos de playlists 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 une variation nette. Cela signifie que 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 de playlists.
playlistStarts
Nombre de fois où des internautes ont lancé la lecture d'une playlist. Notez que cette métrique n'inclut que les vues de playlists qui ont eu lieu sur le Web.
playlistViews
Nombre de fois où les vidéos d'une playlist ont été regardées dans le cadre de cette playlist. Cette métrique inclut les données concernant les vidéos de la playlist qui appartiennent à d'autres chaînes.
viewsPerPlaylistStart
Nombre moyen de vues de vidéos à chaque lancement d'une playlist. Notez que cette métrique n'inclut que les vues de playlists qui ont eu lieu sur le Web.

Métriques sur les annotations

Remarque:Les rapports de l'API YouTube Analytics renvoient uniquement les données des métriques annotationClickThroughRate et annotationCloseRate à compter du 10 juin 2012. De plus, les rapports de l'API YouTube Analytics affichent uniquement les données des autres statistiques d'annotation en date du 16 juillet 2013.

annotationImpressions
Nombre total d'impressions d'annotations.
annotationClickableImpressions
Le nombre d'annotations qui sont apparues et sur lesquelles l'utilisateur peut cliquer.
annotationClicks
Nombre d'annotations sur lesquelles l'utilisateur a cliqué.
annotationClickThroughRate (métrique principale)
Ratio d'annotations sur lesquelles les spectateurs ont cliqué par rapport au nombre total d'impressions d'annotations cliquables. This is a core metric and is subject to the Deprecation Policy. Consultez le centre d'aide YouTube pour découvrir comment créer des annotations et utiliser des annotations de liens.
annotationClosableImpressions
Le nombre d'annotations qui sont apparues et ont pu être fermées.
annotationCloses
Nombre d'annotations fermées.
annotationCloseRate (métrique principale)
Ratio d'annotations que les spectateurs ont fermées par rapport au 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 le rapport sur les fiches YouTube Analytics.

cardImpressions
Nombre de fois où les fiches ont été affichées. 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 les fiches par rapport au nombre d'impressions enregistrées par ces fiches.
cardTeaserImpressions
Nombre de fois où les accroches de fiches ont été affichées. Une vue de vidéo peut générer plusieurs impressions d'accroche.
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 présenté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 la rétention d'audience

audienceWatchRatio
Nombre absolu de spectateurs qui regardent la vidéo à un moment donné de la vidéo. Ce ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été visionnée et le 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 (voire pas du tout) au cours d'une même vue. Par exemple, si un utilisateur revient en arrière et regarde plusieurs fois la même partie d'une vidéo, le rapport absolu pour cette partie de la vidéo peut être supérieur à 1.

Les exemples suivants illustrent le mode de 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 les autres regardent la vidéo dans son intégralité. Un internaute ne regarde aucune partie de la vidéo plus d'une fois. Dans ce cas, la valeur de cette métrique serait 1 pour les segments temporels du premier quart de la vidéo, et sa valeur serait 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 dans son intégralité, mais 20 d'entre eux la regardent jusqu'à la marque des 45 secondes de la vidéo, puis reviennent à la marque de 30 secondes de la vidéo et la suite. Dans ce cas, la valeur de la métrique est 1 pour les segments temporels de la première moitié ou du dernier quart de la vidéo. En revanche, la valeur est de 1.2 pour les segments temporels 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 permettant de comparer les performances d'une vidéo à fidéliser les spectateurs lors de la lecture par rapport à toutes les vidéos YouTube d'une durée similaire. La valeur de cette métrique est comprise entre 0 et 1. Elle indique les performances de rétention relatives de la vidéo à un moment donné. Le point de la vidéo est fourni par la dimension elapsedVideoTimeRatio.

La valeur 0 indique que la vidéo retient moins bien les spectateurs que toute autre vidéo de durée similaire, tandis que la valeur 1 indique que la vidéo retient mieux les spectateurs que toute autre vidéo de durée similaire. Une valeur médiane de 0.5 indique que la moitié des vidéos de durée similaire retiennent mieux les spectateurs, tandis que la 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 le regardent encore après trois minutes, et 70 % le regardent encore après huit minutes. Cependant, pour une vidéo spécifique de 10 minutes, seuls 80 % des spectateurs la regardent encore après trois minutes, mais tous la regardent encore après huit minutes.
  • Pour la valeur elapsedVideoTimeRatio correspondant au moment du début de la vidéo à trois minutes, la métrique relativeRetentionPerformance aurait une valeur inférieure à 0.5, car à ce moment-là, la vidéo est moins performante que la vidéo moyenne.
  • Pour la valeur elapsedVideoTimeRatio correspondant au moment du début de la vidéo à huit minutes, la métrique relativeRetentionPerformance aurait une valeur supérieure à 0.5, car à ce moment-là, la vidéo est plus performante que les autres vidéos de durée similaire.

Métriques sur les revenus estimés

Remarque:Les métriques sur les revenus estimés sont soumises à des ajustements en fin de mois. Elles n'incluent pas les publicités vendues ou diffusées par des partenaires. Veuillez consulter le Centre d'aide YouTube pour obtenir plus d'informations et des remarques sur les revenus estimés.

Par défaut, tous les revenus estimés sont indiqués en USD. Cependant, l'API YouTube Analytics accepte le paramètre currency pour certaines métriques sur les revenus estimés et les performances des annonces. Vous pouvez ainsi récupérer les données sur les revenus estimés dans d'autres devises.
estimatedRevenue (métrique principale) (anciennement earnings)
Total des revenus nets estimés de toutes les sources d'annonces vendues par Google et de 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 sont soumises à un ajustement en fin de mois et n'incluent pas les publicités vendues ou diffusées par des partenaires.
estimatedAdRevenue (anciennement adEarnings)
Total des revenus nets estimés de toutes les sources d'annonces vendues par Google pour la période et la région sélectionnées.

Les métriques sur les revenus estimés font l'objet d'un ajustement en fin de mois. Elles 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. Cette valeur reflète les revenus générés par les contenus musicaux et non musicaux. Elle est susceptible d'être ajustée en fin de mois.

Métriques sur les performances des annonces

grossRevenue
Revenus bruts estimés, en USD, de toutes les publicités vendues par Google ou par les partenaires 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 ni les revenus nets, ceux-ci prenant en compte votre part de propriété et les accords de partage des revenus.
cpm (anciennement impressionBasedCpm)
Revenu brut estimé pour mille impressions d'annonces.
adImpressions (anciennement impressions)
Nombre d'impressions d'annonces validées diffusées.
monetizedPlaybacks
Nombre de fois où un utilisateur a lu votre vidéo et vu au moins une impression d'annonce. Une lecture monétisée est comptabilisée si un utilisateur voit une annonce pré-roll, mais arrête de la regarder avant que la vidéo ne commence. L'erreur estimée pour ce chiffre est d'environ 2%.
playbackBasedCpm
Revenu brut estimé pour mille lectures.