Metrics

Ce document définit les métriques que l'API YouTube Reporting récupère. Cette API permet de récupérer des rapports de données groupés contenant des données YouTube Analytics pour une chaîne ou 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, par exemple, le nombre de vues et les notes (J'aime et Je n'aime pas) des vidéos.

Principales métriques

Bien que l'API YouTube Reporting 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. Toutes les métriques qui sont également utilisées dans l'API YouTube Analytics sont également des métriques principales de cette API.

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

Afficher les métriques

engaged_views (métrique principale)
Nombre de fois où la vidéo a été regardée pendant au moins quatre secondes.
vues (métrique de base)
Nombre de fois où une vidéo a été regardée. Dans un rapport sur une playlist, la métrique indique le nombre de fois qu'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 façon dont les vues sont comptabilisées. This is a core metric and is subject to the Deprecation Policy.
red_views
Nombre de fois où une vidéo a été regardée par des membres YouTube Premium (anciennement YouTube Red).
views_percentage (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

watch_time_minutes (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és. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
Nombre de minutes pendant lesquelles les membres YouTube Premium (anciennement YouTube Red) ont regardé une vidéo.
average_view_duration_seconds (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 lectures vidéo qui ont eu lieu dans le cadre d'une playlist. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
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.
subscribers_gained (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. Pour identifier le nombre de nouveaux abonnés à la chaîne qui ne se sont pas abonnés via une page de lecture de vidéo, un rapport d'activité utilisateur de base 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 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 enregistré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 pas sur une page de visionnage de vidéos, un rapport d'activité utilisateur de base 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 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 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 des 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.
videos_removed_from_playlists
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 suivantes 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.

playlist_starts
Nombre de lancements d'une playlist par des internautes. Notez que cette métrique n'inclut que les vues de playlist 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. Par conséquent, 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 deux ajouts d'enregistrements de playlist.
playlist_saves_removed (uniquement compatible avec 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. Par conséquent, 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 reflète deux suppressions d'enregistrements de playlist.

Métriques sur les annotations

annotation_impressions
Nombre total d'impressions d'annotations.
annotation_clickable_impressions
Nombre d'annotations qui s'affichent et sur lesquelles vous pouvez cliquer.
annotation_clicks
Nombre d'annotations sur lesquelles les utilisateurs ont cliqué.
annotation_click_through_rate (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.
annotation_closable_impressions
Nombre d'annotations qui sont apparues et qui peuvent être fermées.
annotation_closes
Nombre d'annotations fermées.
annotation_close_rate (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.

card_impressions
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.
card_clicks
Nombre de clics sur les fiches.
card_click_rate
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.
card_teaser_impressions
Nombre d'affichages des accroches de fiches. Une vue de vidéo peut générer plusieurs impressions de teasers.
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 affiché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.

Statistiques sur les écrans de fin

Les écrans de fin sont des éléments qui s'affichent pendant les cinq à 20 dernières secondes d'une vidéo pour promouvoir vos contenus, 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 sur le rapport sur les écrans de fin de YouTube Analytics.

Remarque:Les données des métriques de l'écran 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 de l'écran de fin qui s'affiche.
end_screen_element_clicks
Nombre de fois où les éléments de l'écran de fin ont enregistré un clic.
end_screen_element_click_rate
Taux de clics sur les éléments de l'écran de fin, calculé en divisant le nombre de clics sur les éléments de l'écran de fin par le nombre d'impressions des éléments de l'écran de fin.

Métriques sur la rétention d'audience

audience_retention_percentage
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 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 (ou pas du tout) lors d'une même session de visionnage. Par exemple, si les utilisateurs reculent 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 dans son intégralité, mais 20 d'entre eux la 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.

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 ou diffusées par les partenaires. Pour en savoir plus et obtenir des informations sur les chiffres de revenus estimés, consultez le Centre d'aide YouTube.

L'API YouTube Reporting indique tous les revenus et revenus estimés en USD.
estimated_partner_revenue (métrique principale)
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.
estimated_partner_ad_revenue
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 à la fin du mois et n'incluent pas la publicité vendue ou diffusée par des partenaires.
estimated_partner_ad_auction_revenue (uniquement compatible avec l'API YouTube Reporting)
Total des revenus estimés (revenus nets) générés par la publicité vendue 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 compatible avec l'API YouTube Reporting)
Total des revenus estimés (revenus nets) générés par la publicité AdSense vendue aux enchères pour la période et la région sélectionnées.

estimated_partner_ad_reserved_revenue (uniquement compatible avec l'API YouTube Reporting)
Total des revenus estimés (revenus nets) générés par la publicité vendue par réservation via DoubleClick (DCLK) et d'autres sources vendues sur YouTube. Cette métrique s'appelait auparavant estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (uniquement compatible avec l'API YouTube Reporting)
Revenus estimés (revenus nets) provenant de la publicité vendue par réservation via DoubleClick (DCLK) et d'autres sources vendues sur YouTube.

estimated_partner_red_revenue (uniquement compatible avec l'API YouTube Reporting)
Total des revenus estimés (revenus nets) générés par les abonnements à YouTube Premium (anciennement YouTube Red).
estimated_partner_transaction_revenue (uniquement compatible avec l'API YouTube Reporting)
Montant total estimé des revenus issus des transactions, comme les contenus payants et le financement par les fans, moins les remboursements facturés par les partenaires.

Métriques de performance des annonces

estimated_youtube_ad_revenue
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.
estimated_cpm
Revenus bruts estimés pour mille impressions d'annonces.
ad_impressions
Nombre d'impressions d'annonces validées diffusées.
estimated_monetized_playbacks
Nombre de fois où un spectateur a regardé votre vidéo et qu'au moins une impression d'annonce lui a été présentée. 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%.
estimated_playback_based_cpm
Revenu brut estimé pour mille lectures.