Cette page liste les rapports que les propriétaires de contenu peuvent récupérer avec l'API YouTube Reporting. Le id de chaque rapport, tel qu'il est renvoyé par la méthode reportTypes.list de l'API, est indiqué entre parenthèses à côté du nom du rapport.
Signalements de vidéos
Les rapports sur les vidéos fournissent des statistiques sur l'ensemble de 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 id de ce rapport est content_owner_basic_a4.
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.
Le id de ce rapport est
content_owner_province_a3
.
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application sur lesquelles les vidéos ont été lues.
Le id de ce rapport est
content_owner_playback_location_a3
.
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 vues provenant d'une recherche Google ou d'un lien vers une vidéo associée.
Le id de ce rapport est
content_owner_traffic_source_a3
.
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage de vidéos en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues qui ont eu lieu sur des tablettes Android ou sur des ordinateurs de bureau Windows.
Le id de ce rapport est
content_owner_device_os_a3
.
| 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 : | engaged_views, 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.
Le 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 indiquant la fréquence à laquelle les vidéos des chaînes du propriétaire du contenu ont été partagées sur différentes plates-formes sociales.
Le 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 dans les vidéos des 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 agrège les statistiques de toutes les annotations d'une vidéo.
Le 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 agrège les statistiques de toutes les fiches d'une vidéo.
Le 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 le taux de clics pour les écrans de fin qui s'affichent après la lecture d'une vidéo.
Il contient des statistiques sur les vidéos des chaînes d'un propriétaire de contenu.
Le 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és le plus longtemps lors des visionnages de vidéos. Les vues pour lesquelles les sous-titres sont désactivés la plupart du temps sont exclues.
La id de ce rapport est content_owner_subtitles_a3.
Combinées
Ce rapport fournit des statistiques vidéo précises en combinant les dimensions utilisées dans les rapports Emplacement de lecture, Source de trafic et Appareil/OS.
La id de ce rapport est content_owner_combined_a3.
Rapports sur les playlists
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos qui se produisent dans le contexte d'une playlist.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists des chaînes d'un propriétaire de contenu.
La id de ce rapport est content_owner_playlist_basic_a2.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
| Métriques : | engaged_views, 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 résidant dans les États américains et le district de Columbia. Le rapport est filtré pour n'inclure des données que si la valeur de la dimension country_code est US.
La id de ce rapport est content_owner_playlist_province_a2.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
| Métriques : | engaged_views, 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 où les lectures de playlists ont eu lieu.
Le id de ce rapport est
content_owner_playlist_playback_location_a2
.
| 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 : | engaged_views, 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 playlists sur les chaînes d'un propriétaire de contenu. Par exemple, ce rapport identifie le nombre de vues générées par une recherche Google ou par un lien vers une vidéo associée.
La id de ce rapport est content_owner_playlist_traffic_source_a2.
| 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 : | engaged_views, 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 qui ont eu lieu sur des tablettes Android ou sur des ordinateurs de bureau Windows.
Le id de ce rapport est
content_owner_playlist_device_os_a2
.
| Sommaire | |
|---|---|
| Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
| Métriques : | engaged_views, 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 id de ce rapport est content_owner_playlist_combined_a2.
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 lors de la lecture de vidéos. Ces métriques tiennent compte de chaque impression d'annonce. 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 id de ce rapport est content_owner_ad_rates_a1.
L'ID de la version précédente de ce rapport, qui est désormais entièrement obsolète, était content_owner_ad_performance_a1.
La seule différence par rapport à la version précédente est que le nom du rapport est mis à jour pour utiliser le mot rates au lieu de performance. Par conséquent, le rapport lui-même porte 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 des métriques sur les performances des annonces.
Les métriques sur les revenus identifient des sources de revenus spécifiques et le montant des revenus totaux générés par ces sources.
Revenu prévisionnel des vidéos
Ce rapport indique les revenus totaux générés par toutes les vidéos d'un propriétaire de contenu à partir de sources de revenus publicitaires vendues par Google et de sources de revenus non publicitaires. Il contient également des métriques sur les performances des annonces.
La id de ce rapport est content_owner_estimated_revenue_a2.
Revenu prévisionnel des éléments
Ce rapport indique le total des revenus générés par l'ensemble des assets d'un propriétaire de contenu à partir de sources publicitaires vendues par Google et de sources non publicitaires. Il contient également des métriques sur les performances des annonces. Notez que la dimension channel_id identifie la chaîne qui a mis en ligne la video_id pour laquelle des métriques sont fournies.
La id de ce rapport est content_owner_asset_estimated_revenue_a2.
- 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
- Renomme la métrique estimated_partner_double_click_revenue en estimated_partner_ad_reserved_revenue
- Modifie le nom du rapport pour utiliser le mot
revenueau lieu deearnings. Par conséquent, le rapport lui-même porte le même numéro de version (a1) que la version précédente, mais lereport IDest 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 si celui-ci l'a revendiquée comme correspondant à l'un de ses éléments. La vidéo a peut-être é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 la video_id pour laquelle des métriques sont fournies.
Par exemple, imaginons qu'une vidéo soit visionnée 10 fois un jour donné, puis qu'elle soit revendiquée, puis qu'elle soit visionnée 10 fois de plus. Le rapport sur l'élément pour 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 suivants doivent refléter précisément l'activité des utilisateurs liée à la vidéo revendiquée.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les actions des utilisateurs concernant les vidéos associées aux composants d'un propriétaire de contenu.
Le id de cette version du rapport est content_owner_asset_basic_a3.
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 des données que si la valeur de la dimension country_code est US. La id de ce rapport est content_owner_asset_province_a3.
Le id de cette version du rapport est content_owner_asset_province_a3.
Contextes de lecture vidéo
Ce rapport fournit des statistiques sur le type de page ou d'application sur lesquelles les vidéos ont été lues.
Le id de cette version du rapport est content_owner_asset_playback_location_a3.
Sources de trafic
Ce rapport regroupe les statistiques de visionnage en fonction de la manière dont les spectateurs ont accédé aux contenus vidéo associés aux éléments d'un propriétaire de contenu. Par exemple, il identifie le nombre de vues provenant d'une recherche Google ou d'un lien vers une vidéo associée.
Le id de cette version du rapport est content_owner_asset_traffic_source_a3.
le type d'appareil et le système d'exploitation ;
Ce rapport regroupe les statistiques de visionnage de vidéos en fonction des systèmes d'exploitation et des types d'appareils des spectateurs. Par exemple, il identifie le nombre de vues qui ont eu lieu sur des tablettes Android ou sur des ordinateurs de bureau Windows.
Le id de cette version du rapport est content_owner_asset_device_os_a3.
| 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 : | engaged_views, 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 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 indiquant la fréquence à laquelle les vidéos associées aux composants d'un propriétaire de contenu ont été partagées sur différentes plates-formes sociales. La 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 agrège les statistiques de toutes les annotations d'une vidéo. La id de ce rapport est content_owner_asset_annotations_a1.
Cartes
Ce rapport fournit des statistiques sur les impressions et le taux de 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 affichées dans chaque vidéo associée à un composant. La 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 le taux de clics pour les écrans de fin qui s'affichent après la lecture d'une vidéo. Ce rapport contient des statistiques sur les vidéos revendiquées sur les chaînes d'un propriétaire de contenu. Il identifie également les éléments associés aux vidéos. La 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 précises en combinant les dimensions utilisées dans les rapports Emplacement de lecture, Source de trafic et Appareil/OS.
La id de ce rapport est content_owner_asset_combined_a3.