Metrics

Ce document définit les métriques récupérées par l'API YouTube Reporting. Cette API permet de récupérer des rapports de données groupées qui contiennent les données YouTube Analytics d'une chaîne ou d'un propriétaire de contenu.

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 Reporting soit soumise au règlement relatif aux abandons défini dans les Conditions d'utilisation, les métriques et dimensions secondaires ne sont pas concernées. 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. Toutes ces métriques également utilisées dans l'API YouTube Analytics sont également des métriques clés dans cette 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 principale)
Nombre de fois où une vidéo a été regardée. Dans un rapport sur les playlists, cette métrique indique le nombre de fois où une vidéo a été regardée dans le cadre d'une playlist. Le Centre d'aide YouTube fournit des informations supplémentaires sur la façon dont les vues sont comptabilisées. This is a core metric and is subject to the Deprecation Policy.
red_views
Nombre de vues d'une vidéo par les abonnés YouTube Premium (anciennement YouTube Red).
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
Nombre de minutes pendant lesquelles les abonnés YouTube Premium (anciennement YouTube Red) ont regardé une vidéo.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
subscribers_gained (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. Pour identifier le nombre de nouveaux abonnés à une chaîne qui ne se sont pas abonnés via une page de lecture de vidéo, un rapport de base sur l'activité des utilisateurs contient une ligne qui ne spécifie pas de valeur de dimension video_id. Cette ligne spécifie également une valeur pour la métrique subscribersLost, mais pas de valeurs pour les autres métriques.
subscribers_lost (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 subscribers_gained. Pour identifier le nombre d'utilisateurs qui se sont désabonnés, mais ne se sont pas désabonnés sur une page de lecture de vidéo, un rapport de base sur l'activité des utilisateurs contient une ligne qui ne spécifie pas de valeur de dimension video_id. Cette ligne spécifie également une valeur pour la métrique subscribers_gained, mais pas de valeurs pour les autres métriques.
videos_added_to_playlists
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.
videos_removed_from_playlists
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.

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.

playlist_starts
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.
playlist_saves_added (uniquement compatible avec l'API YouTube Reporting)
Nombre 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 absolu, ce qui 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 indique que deux playlists de playlists sont ajoutées.
playlist_saves_removed (uniquement disponible dans l'API YouTube Reporting)
Nombre de fois où les utilisateurs ont supprimé la playlist de leurs listes de playlists enregistrées. Cette métrique renvoie un nombre absolu. Cela signifie que si un utilisateur enregistre une playlist, la supprime de la liste des playlists enregistrées, l'enregistre à nouveau, puis la supprime à nouveau, la valeur de la métrique indique que deux enregistrements de playlists sont supprimés.

Métriques sur les annotations

annotation_impressions
Nombre total d'impressions d'annotations.
annotation_clickable_impressions
Le nombre d'annotations qui sont apparues et sur lesquelles l'utilisateur peut cliquer.
annotation_clicks
Nombre d'annotations sur lesquelles l'utilisateur a cliqué.
annotation_click_through_rate (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.
annotation_closable_impressions
Le nombre d'annotations qui sont apparues et ont pu être fermées.
annotation_closes
Nombre d'annotations fermées.
annotation_close_rate (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.

card_impressions
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.
card_clicks
Nombre de clics sur les fiches.
card_click_rate
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.
card_teaser_impressions
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.
card_teaser_clicks
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.
card_teaser_click_rate
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 des écrans de fin

Les écrans de fin sont des éléments qui s'affichent pendant les 5 à 20 dernières secondes d'une vidéo pour promouvoir votre contenu, votre chaîne et vos sites Web. Le centre d'aide YouTube contient des instructions plus détaillées sur l'ajout d'écrans de fin à vos vidéos et le rapport YouTube Analytics sur les écrans de fin.

Remarque:Les données sur les métriques des écrans de fin sont disponibles depuis le 1er mai 2016.

end_screen_element_impressions
Nombre d'éléments d'écran de fin affichés. Une impression est enregistrée pour chaque élément d'écran de fin affiché.
end_screen_element_clicks
Nombre de fois où les utilisateurs ont cliqué sur des éléments d'écran de fin.
end_screen_element_click_rate
Taux de clics des éléments d'écran de fin, calculé en divisant le nombre de clics sur des éléments d'écran de fin par le nombre d'impressions de ces éléments.

Métriques sur la rétention d'audience

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

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.

L'API YouTube Reporting indique tous les revenus estimés et les revenus en USD.
estimated_partner_revenue (métrique principale)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (uniquement disponible dans l'API YouTube Reporting)
Total des revenus estimés (revenus nets) des publicités vendues aux enchères via AdSense pour la période et la région sélectionnées. Cette métrique s'appelait auparavant estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (uniquement disponible dans l'API YouTube Reporting)
Total des revenus estimés (revenus nets) des publicités AdSense vendues aux enchères pour la période et la région sélectionnées.
estimated_partner_ad_reserved_revenue (uniquement disponible dans l'API YouTube Reporting)
Total des revenus estimés (revenus nets) des publicités vendues par réservation via DoubleClick (DCLK) et d'autres sources publicitaires vendues par YouTube. Cette métrique s'appelait auparavant estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (uniquement disponible dans l'API YouTube Reporting)
Total des revenus estimés (revenus nets) des publicités vendues par réservation via DoubleClick (DCLK) et d'autres sources vendues par YouTube.
estimated_partner_red_revenue (uniquement disponible dans l'API YouTube Reporting)
Total des revenus estimés (revenus nets) des abonnements YouTube Premium (anciennement YouTube Red).
estimated_partner_transaction_revenue (uniquement compatible avec l'API YouTube Reporting)
Total des revenus estimés issus des transactions, comme les contenus payants et le financement par les fans, moins les remboursements effectués par les partenaires.

Métriques sur les performances des annonces

estimated_youtube_ad_revenue
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.
estimated_cpm
Revenu brut estimé pour mille impressions d'annonces.
ad_impressions
Nombre d'impressions d'annonces validées diffusées.
estimated_monetized_playbacks
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%.
estimated_playback_based_cpm
Revenu brut estimé pour mille lectures.