Cette page liste les rapports que les propriétaires de contenu peuvent récupérer à l'aide de l'API YouTube Reporting. Le id
de chaque rapport, tel qu'il est renvoyé par la méthode reportTypes.list
de l'API, s'affiche entre parenthèses à côté du nom du rapport.
Signalements de vidéos
Les rapports sur les vidéos fournissent des statistiques sur l'activité des utilisateurs concernant les vidéos d'une chaîne ou d'un propriétaire de contenu. Par exemple, ces rapports indiquent le nombre de fois où vos vidéos ont été regardées.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur l'activité des utilisateurs concernant les chaînes d'un propriétaire de contenu et les vidéos de ces chaînes. La valeur id
de la version actuelle de ce rapport est content_owner_basic_a3
.
La valeur id
de cette version du rapport est content_owner_basic_a3
. Elle présente les différences suivantes par rapport à la version a2
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Remarque:Le rapport content_owner_basic_a1
a été complètement abandonné.
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour les États américains et le district de Columbia. La valeur id
de ce rapport est content_owner_province_a2
.
La valeur id
de cette version du rapport est content_owner_province_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les vidéos ont été lues. La valeur id
de ce rapport est content_owner_playback_location_a2
.
La valeur id
de cette version du rapport est content_owner_playback_location_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé aux vidéos sur les chaînes du propriétaire de contenu.
Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée. La valeur id
de ce rapport est content_owner_traffic_source_a2
.
La valeur id
de cette version du rapport est content_owner_traffic_source_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage des vidéos en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows. La valeur id
de ce rapport est content_owner_device_os_a2
.
La valeur id
de cette version du rapport est content_owner_device_os_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Données démographiques des spectateurs
Ce rapport regroupe les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs.
La valeur id
de ce rapport est content_owner_demographics_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
Métriques : | views_percentage |
Partage de contenu par plate-forme
Ce rapport fournit des statistiques sur la fréquence de partage des vidéos sur les chaînes du propriétaire du contenu sur différentes plates-formes de réseaux sociaux.
La valeur id
de ce rapport est content_owner_sharing_service_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
Métriques : | actions |
Annotations
Ce rapport fournit des statistiques sur les annotations qui s'affichent pendant les vidéos sur les chaînes d'un propriétaire de contenu.
Les données du rapport mesurent les performances des annotations individuelles pour chaque vidéo. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les annotations d'une vidéo.
La valeur id
de ce rapport est content_owner_annotations_a1
.
Cartes
Ce rapport fournit des statistiques sur les impressions et les clics pour les fiches qui s'affichent pendant les vidéos sur les chaînes d'un propriétaire de contenu.
Les données du rapport mesurent les performances de chaque fiche. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les fiches d'une vidéo.
La valeur id
de ce rapport est content_owner_cards_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
Métriques : | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Écrans de fin
Ce rapport fournit des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent à la fin de la lecture d'une vidéo.
Il contient des statistiques sur les vidéos des chaînes d'un propriétaire de contenu.
La valeur id
de ce rapport est content_owner_end_screens_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, end_screen_element_type, end_screen_element_id |
Métriques : | end_screen_element_clicks, end_screen_element_impressions, end_screen_element_click_rate |
Sous-titres
Ce rapport fournit des statistiques sur la langue des sous-titres utilisée pendant la durée la plus longue lors des visionnages de vidéos. Les vues pour lesquelles les sous-titres sont généralement désactivés sont exclues. La valeur id
de ce rapport est content_owner_subtitles_a2
.
La valeur id
de cette version du rapport est content_owner_subtitles_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Combinées
Ce rapport fournit des statistiques vidéo détaillées en combinant les dimensions utilisées dans les rapports Emplacement de la lecture, Source de trafic et Appareil/OS. La valeur id
de ce rapport est content_owner_combined_a2
.
La valeur id
de cette version du rapport est content_owner_combined_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Rapports sur les playlists
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos dans le cadre d'une playlist.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists sur les chaînes d'un propriétaire de contenu.
La valeur id
de ce rapport est content_owner_playlist_basic_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs concernant leurs interactions avec les playlists sur les chaînes d'un propriétaire de contenu pour les utilisateurs situés dans les États américains et le district de Columbia.
Cela signifie que le rapport est filtré pour n'inclure que les données si la valeur de la dimension country_code est US
. La valeur id
de ce rapport est content_owner_playlist_province_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les playlists ont été lues. La valeur id
de ce rapport est content_owner_playlist_playback_location_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé aux vidéos de playlist sur les chaînes d'un propriétaire de contenu.
Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée. La valeur id
de ce rapport est content_owner_playlist_traffic_source_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage des playlists en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows. La valeur id
de ce rapport est content_owner_playlist_device_os_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Combinées
Ce rapport fournit des statistiques détaillées sur les playlists en combinant les dimensions utilisées dans les rapports Emplacement de lecture, Source de trafic et Appareil/OS. La valeur id
de ce rapport est content_owner_playlist_combined_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Rapports sur le tarif des annonces
Les rapports sur les tarifs publicitaires fournissent des métriques basées sur les impressions pour les annonces diffusées pendant la lecture de vidéos. Ces métriques comptabilisent chaque impression d'annonce, et chaque lecture de vidéo peut générer plusieurs impressions.
L'API est compatible avec le rapport sur les tarifs publicitaires suivant, qui fournit des métriques sur les tarifs publicitaires pour les vidéos d'un propriétaire de contenu. La valeur id
de la version actuelle de ce rapport est content_owner_ad_rates_a1
.
La valeur id
de cette version du rapport est content_owner_ad_rates_a1
. L'ID de la version précédente de ce rapport, qui est désormais complètement obsolète, était content_owner_ad_performance_a1
.
La seule différence avec la version précédente est que cette version modifie le nom du rapport pour utiliser le mot rates
au lieu du mot performance
. Par conséquent, le rapport lui-même a le même numéro de version (a1
) que la version précédente, mais le report ID
est différent.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, country_code, ad_type |
Métriques : | estimated_youtube_ad_revenue, ad_impressions, estimated_cpm |
Rapports sur les revenus prévisionnels
Les rapports sur les revenus estimés indiquent le total des revenus estimés pour les vidéos provenant de sources publicitaires vendues par Google et de sources non publicitaires. Ces rapports contiennent également certaines métriques sur les performances des annonces.
Les métriques sur les revenus identifient des sources de revenus spécifiques et le montant total des revenus générés par ces sources.
Revenu prévisionnel des vidéos
Ce rapport indique le revenu total de toutes les vidéos d'un propriétaire de contenu provenant de sources publicitaires vendues par Google, ainsi que de sources non publicitaires. Il contient également des métriques de performances des annonces. La valeur id
de la version actuelle de ce rapport est content_owner_estimated_revenue_a1
.
La valeur id
de cette version du rapport est content_owner_estimated_revenue_a1
. Il présente les différences suivantes par rapport à la version précédente, qui était content_owner_estimated_earnings_a1
:
- Ajout de la métrique estimated_partner_red_revenue
- Ajout de la métrique estimated_partner_transaction_revenue
- Renommage de la métrique estimated_partner_ad_sense_revenue en estimated_partner_ad_auction_revenue
- Renommage de la métrique estimated_partner_double_click_revenue en estimated_partner_ad_reserved_revenue
- Modifie le nom du rapport pour utiliser le mot
revenue
au lieu du motearnings
. Par conséquent, le rapport lui-même a le même numéro de version (a1
) que la version précédente, mais lereport ID
est différent.
Revenu prévisionnel des éléments
Ce rapport indique le revenu total de tous les composants d'un propriétaire de contenu provenant de sources publicitaires vendues par Google, ainsi que de sources non publicitaires. Il contient également des métriques de performances des annonces. Notez que la dimension channel_id identifie la chaîne qui a mis en ligne l'video_id pour lequel les métriques sont fournies. La valeur id
de la version actuelle de ce rapport est content_owner_asset_estimated_revenue_a1
.
La valeur id
de cette version du rapport est content_owner_asset_estimated_revenue_a1
. Il présente les différences suivantes par rapport à la version précédente, qui était content_owner_asset_estimated_earnings_a1
:
- Ajout de la métrique estimated_partner_red_revenue
- Ajout de la métrique estimated_partner_transaction_revenue
- Renommage de la métrique estimated_partner_ad_sense_revenue en estimated_partner_ad_auction_revenue
- Renommage de la métrique estimated_partner_double_click_revenue en estimated_partner_ad_reserved_revenue
- Modifie le nom du rapport pour utiliser le mot
revenue
au lieu du motearnings
. Par conséquent, le rapport lui-même a le même numéro de version (a1
) que la version précédente, mais lereport ID
est différent.
Rapports sur les éléments
Les rapports sur les éléments fournissent des métriques sur l'activité des utilisateurs concernant les vidéos associées aux éléments d'un propriétaire de contenu. Une vidéo est incluse dans le rapport d'un propriétaire de contenu s'il l'a revendiquée comme correspondant à l'un de ses éléments. La vidéo peut avoir été mise en ligne par le propriétaire du contenu ou par un autre utilisateur YouTube.
Dans les rapports sur les éléments, la dimension channel_id identifie la chaîne qui a mis en ligne l'video_id pour lequel les métriques sont fournies.
Par exemple, supposons qu'une vidéo soit visionnée 10 fois un jour donné, qu'elle soit revendiquée, puis qu'elle soit visionnée 10 fois de plus. Le rapport sur les éléments de ce jour indiquera que la vidéo a été visionnée 20 fois, même si seulement 10 de ces vues ont eu lieu après la revendication. Les métriques de tous les jours successifs doivent refléter avec précision l'activité des utilisateurs liée à la vidéo reclamée.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les actions des utilisateurs sur les vidéos associées aux composants d'un propriétaire de contenu. La valeur id
de ce rapport est content_owner_asset_basic_a2
.
La valeur id
de cette version du rapport est content_owner_asset_basic_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs pour les États américains et le district de Columbia. Cela signifie que le rapport est filtré pour n'inclure que les données si la valeur de la dimension country_code est US
. La valeur id
de ce rapport est content_owner_asset_province_a2
.
La valeur id
de cette version du rapport est content_owner_asset_province_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Contextes de lecture vidéo
Ce rapport fournit des statistiques sur le type de page ou d'application sur laquelle les vidéos ont été lues. La valeur id
de ce rapport est content_owner_asset_playback_location_a2
.
La valeur id
de cette version du rapport est content_owner_asset_playback_location_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé au contenu vidéo associé aux éléments d'un propriétaire de contenu. Par exemple, il identifie le nombre de visionnages provenant d'une recherche Google ou d'un lien vers une vidéo associée. La valeur id
de ce rapport est content_owner_asset_traffic_source_a2
.
La valeur id
de cette version du rapport est content_owner_asset_traffic_source_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage des vidéos en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues sur les tablettes Android ou les ordinateurs de bureau Windows. La valeur id
de ce rapport est content_owner_asset_device_os_a2
.
La valeur id
de cette version du rapport est content_owner_asset_device_os_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
Métriques : | views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Données démographiques des spectateurs
Ce rapport regroupe les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs. La valeur id
de ce rapport est content_owner_asset_demographics_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
Métriques : | views_percentage |
Partage de contenu par plate-forme
Ce rapport fournit des statistiques sur la fréquence de partage des vidéos associées aux composants d'un propriétaire de contenu sur différentes plates-formes de réseaux sociaux. La valeur id
de ce rapport est content_owner_asset_sharing_service_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
Métriques : | actions |
Annotations
Ce rapport fournit des statistiques sur les annotations qui s'affichent pendant les vidéos associées aux éléments d'un propriétaire de contenu. Les données du rapport mesurent les performances de chaque annotation. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les annotations d'une vidéo. La valeur id
de ce rapport est content_owner_asset_annotations_a1
.
Cartes
Ce rapport fournit des statistiques sur les impressions et les clics pour les fiches qui s'affichent pendant les vidéos associées aux composants d'un propriétaire de contenu. Les données du rapport mesurent les performances de chaque fiche. En revanche, le rapport sur l'activité des utilisateurs regroupe les statistiques de toutes les fiches qui s'affichent dans chaque vidéo associée à un élément. La valeur id
de ce rapport est content_owner_asset_cards_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
Métriques : | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Écrans de fin
Ce rapport fournit des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent à la fin de la lecture d'une vidéo. Il contient des statistiques sur les vidéos revendiquées sur les chaînes d'un propriétaire de contenu, et identifie également les éléments associés aux vidéos. La valeur id
de ce rapport est content_owner_asset_end_screens_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, end_screen_element_type, end_screen_element_id |
Métriques : | end_screen_element_clicks, end_screen_element_impressions, end_screen_element_click_rate |
Combinées
Ce rapport fournit des statistiques vidéo détaillées en combinant les dimensions utilisées dans les rapports Emplacement de la lecture, Source de trafic et Appareil/OS. La valeur id
de ce rapport est content_owner_asset_combined_a2
.
La valeur id
de cette version du rapport est content_owner_asset_combined_a2
. Elle présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter la métrique red_watch_time_minutes