Metrics

Ce document définit les métriques que vous pouvez récupérer à l'aide de l'API YouTube Analytics. Cette API accepte 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 d'activité des utilisateurs incluent le nombre de vues des vidéos et les avis ("J'aime" et "Je n'aime pas").

Métriques principales

L'API YouTube Analytics est soumise au règlement relatif aux abandons défini dans les Conditions d'utilisation, mais pas les métriques et autres dimensions principales. 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.

Remarque:Les métriques de base suivantes sont 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 compatibles jusqu'au 10 août 2017.
  • Les métriques principales favoritesAdded et favoritesRemoved ont été abandonnées le 31 mars 2015. Ces métriques ne peuvent être extraites que via l'API YouTube Analytics.

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

Afficher les métriques

vues (statistique principale)
Nombre de vues d'une vidéo. Dans un rapport sur les playlists, la métrique indique le nombre de fois où une vidéo a été visionnée dans le cadre d'une playlist. Le Centre d'aide YouTube fournit des informations supplémentaires sur la manière dont les vues sont comptabilisées. This is a core metric and is subject to the Deprecation Policy.
redViews
Nombre de vues d'une vidéo par les membres YouTube Premium (anciennement YouTube Red).
uniques (obsolète le 27 septembre 2016)
Nombre de spectateurs uniques ayant regardé une vidéo. Ce calcul est basé sur le nombre de cookies uniques. Par conséquent, le nombre d'utilisateurs utilisant plusieurs appareils ou navigateurs sera dépassé.
La métrique uniques a été abandonnée le 27 septembre 2016. Il ne s'agit pas d'une métrique essentielle et elle sera acceptée jusqu'au 31 octobre 2016.
viewerPercentage (valeur principale)
Pourcentage d'utilisateurs connectés qui 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 (statistique 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é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 (statistique principale)
Durée moyenne (en secondes) de la lecture d'une vidéo. Depuis le 13 décembre 2021, cette métrique exclut le trafic de boucles en boucle. Dans un rapport sur les playlists, la métrique indique la durée moyenne (en secondes) de lecture de la vidéo dans le cadre d'une playlist. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Pourcentage moyen de lecture d'une vidéo pendant sa lecture. Depuis le 13 décembre 2021, cette métrique exclut le trafic de boucles en boucle.

Métriques sur l'engagement

commentaires (statistique 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 (statistique principale)
Nombre de fois où les utilisateurs ont indiqué qu'ils appréciaient 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 (statistique 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.
parts (statistique principale)
Nombre de fois où les utilisateurs ont partagé une vidéo via le 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 (statistique 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 à différents endroits : sur la page de lecture des vidéos, sur la page de la chaîne et dans le guide disponible sur la page d'accueil YouTube. Dans les rapports sur les chaînes, cette métrique inclut les abonnés gagnés à partir de n'importe lequel de ces emplacements. Toutefois, dans les rapports qui utilisent la dimension video ou le paramètre filter pour n'inclure que les 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 (statistique principale)
Nombre de fois où les 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 par le biais de 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 n'inclure que les 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 d'ajouts de vidéos à une playlist YouTube. Les vidéos ont pu être ajoutées à la playlist du propriétaire de la vidéo ou à celles d'autres chaînes.

La valeur de la métrique indique le nombre de fois où des vidéos ont été ajoutées à des playlists par défaut comme la playlist "À regarder plus tard". Toutefois, les playlists auxquelles une vidéo a été ajoutée (par exemple, la playlist mise en ligne sur une chaîne ou l'historique des vidéos regardées par un utilisateur) ne sont pas prises en compte.

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 deux fois la vidéo ajoutée à une playlist. Les données de cette métrique 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 d'une playlist YouTube. Les vidéos ont pu être supprimées de la playlist du propriétaire de la vidéo ou de celles d'autres chaînes.

La métrique indique 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. 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 deux fois la vidéo supprimée d'une playlist. Les données de cette métrique ne sont pas disponibles pour les dates antérieures au 1er octobre 2014.

Métriques d'engagement obsolètes

Les statistiques principales suivantes ont été abandonnées le 31 mars 2015.

favoritesadded (statistique principale) (31 mars 2015)
Nombre de fois que des utilisateurs ont ajouté une vidéo à leurs favoris. Pour en savoir plus, consultez le Centre d'aide YouTube. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (statistique principale) (obsolète au 31 mars 2015)
Nombre de fois où les utilisateurs ont supprimé une vidéo de leur liste de favoris. 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

playlistStarts
Nombre de lancements d'une playlist par des spectateurs. Sachez que cette métrique ne comprend que les vues de playlists enregistrées sur le Web.
viewsPerPlaylistStart
Nombre moyen de vues des vidéos à chaque lancement d'une playlist. Sachez que cette métrique ne comprend que les vues de playlists enregistrées sur le Web.
moyenneDuréeInPlaylist
Estimation du temps moyen, en minutes, passé par un spectateur à regarder des vidéos d'une playlist après le lancement de la playlist. Sachez que cette métrique ne comprend que les vues de playlists enregistrées sur le Web.

Métriques sur les annotations

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

annotationImpressions
Nombre total d'impressions d'annotations
annotationClickableImpressions
Nombre d'annotations qui ont été affichées et qui ont enregistré un clic
annotationsClicks
Nombre d'annotations sur lesquelles les internautes ont cliqué.
annotationClickThroughRate (statistique principale)
Proportion 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 savoir comment créer des annotations et utiliser des annotations de liens.
annotationClosableImpressions
Nombre d'annotations qui ont pu s'afficher et qui ont pu être fermées.
AnnotationCloses
Nombre d'annotations fermées.
annotationCloseRate (statistique principale)
Taux d'annotations que les spectateurs ont clôturé par rapport au nombre total d'impressions d'annotations. This is a core metric and is subject to the Deprecation Policy.

Métriques de la fiche

Le centre d'aide YouTube contient des instructions plus détaillées pour ajouter des fiches à vos vidéos et le rapport sur les fiches YouTube Analytics.

cardImpressions
Nombre d'affichages des fiches. Lorsque le panneau de fiches est ouvert, une impression de fiche est enregistrée pour chacune des fiches de la vidéo.
cardClicks
Nombre de clics sur les fiches.
cardClickRate
Taux de clics des fiches. Chiffre calculé en divisant le nombre de clics sur la 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 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 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 rapport au nombre total d'impressions de ces accroches.

Métriques sur la rétention d'audience

audienceWatchRatio
Ratio absolu des spectateurs qui regardent la vidéo à un moment précis de la vidéo. Le ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été regardé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 visionnée plusieurs fois (ou pas du tout) dans une même vue. Par exemple, si les utilisateurs retournent en arrière et regardent la même partie de la vidéo plusieurs fois, le ratio absolu de 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 la lecture après 15 secondes, tandis que les autres regardent la vidéo en entier. Aucun spectateur ne regarde une partie de la vidéo plusieurs fois. Dans ce cas, la valeur de cette métrique sera de 1 pour les tranches horaires du premier quart de la vidéo, et de 0.50 pour le reste de la vidéo.
  • Une vidéo d'une minute est regardée 100 fois. Tous les spectateurs regardent l'intégralité de la vidéo, mais 20 d'entre eux la regardent jusqu'à la marque de 45 secondes, puis la regardent à 30 secondes et regardent la suite. Dans ce cas, la valeur de la métrique sera 1 pour les segments de durée situés dans la première moitié ou le dernier quart de la vidéo. Cependant, la valeur est de 1.2 pour les tranches horaires du troisième quart de la vidéo, car 100 % des spectateurs ont regardé ce segment, mais 20 % d'entre eux l'ont regardée deux fois.
relativeConservation des performances
Il s'agit d'une mesure du taux de fidélisation des spectateurs pendant la lecture, par rapport à toutes les vidéos YouTube de durée similaire. La valeur de la métrique est comprise entre 0 et 1. Elle identifie les performances de rétention relatives de la vidéo à un moment donné de la vidéo. Le point de la vidéo est fourni par la dimension elapsedVideoTimeRatio.

La valeur 0 indique que la vidéo a fidélisé les internautes par rapport à toutes les vidéos de durée similaire. La valeur 1 indique que la vidéo retient mieux l'attention des spectateurs que les autres vidéos de durée similaire. Une valeur médiane de 0.5 indique que la moitié des vidéos de durée similaire fidélisent mieux les spectateurs, tandis que la moitié fidélise les spectateurs.

L'exemple hypothétique suivant illustre la façon dont les valeurs peuvent apparaître dans un rapport. En moyenne, 90 % des spectateurs qui regardent des vidéos de 10 minutes le sont encore après trois minutes, et 70 % d'entre eux le sont encore après huit minutes. Cependant, pour une vidéo spécifique de 10 minutes, seulement 80 % des spectateurs continuent de la regarder après trois minutes, mais tous les spectateurs le sont encore après huit minutes.
  • À la valeur elapsedVideoTimeRatio correspondant au point qui se trouve à trois minutes d'une vidéo, la métrique relativeRetentionPerformance présente une valeur inférieure à 0.5, car la vidéo est alors moins performante que la vidéo moyenne.
  • Avec une valeur elapsedVideoTimeRatio correspondant à l'instant de huit minutes dans la vidéo, la métrique relativeRetentionPerformance présente une valeur supérieure à 0.5, car la vidéo enregistre alors de meilleures performances 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 et n'incluent pas les publicités vendues ou diffusées par les partenaires. Pour en savoir plus et obtenir des notes sur les revenus estimés, consultez le Centre d'aide YouTube.

Par défaut, tous les revenus estimés sont indiqués en USD. Toutefois, l'API YouTube Analytics est compatible avec le paramètre currency pour certaines métriques sur les revenus estimés et les performances des annonces, ce qui vous permet de récupérer les données sur les revenus estimés dans d'autres devises.
estimatedRevenue(statistique principale)(anciennement earnings)
Total des revenus nets estimés de toutes les sources publicitaires vendues par Google et des autres sources 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 n'incluent pas les publicités vendues ou diffusées 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 soumises à un ajustement en fin de mois et n'incluent pas les publicités vendues ou diffusées par les partenaires.
estimatedRedPartnerRevenue (anciennement redPartnerRevenue)
Total des revenus estimés générés par les abonnements YouTube Premium (anciennement YouTube Red) pour les variables sélectionnées. La valeur de la métrique reflète les revenus issus à la fois des contenus musicaux et non musicaux. Elle est soumise à un ajustement en fin de mois.

Métriques de performances des annonces

revenus bruts
Estimation du revenu brut, en USD, de toutes les publicités vendues par Google ou par des 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 ou les revenus nets, ceux-ci prenant en compte votre part de propriété et les accords de partage des revenus.
cpm (anciennement impressionBasedCpm)
Estimation du revenu brut pour mille impressions d'annonces.
adImpressions (anciennement impressions)
Nombre d'impressions d'annonces validées diffusées.
monetizationedPlaybacks
Nombre de fois où un internaute a regardé votre vidéo et a vu au moins une impression d'annonce. Une lecture monétisée est comptabilisée si une annonce vidéo pré-roll est diffusée auprès d'un utilisateur, mais qu'il arrête le visionnage avant le début de la vidéo. L'estimation de l'erreur attendue pour ce chiffre est de ±2%.
playbackBasedCpm
Estimation du revenu brut pour mille lectures.