Cette page liste les rapports que les propriétaires de contenu peuvent récupérer avec l'API de création de rapports YouTube. Le paramètre id
de chaque rapport, tel que 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 toutes les activités des utilisateurs concernant les vidéos d'une chaîne ou celles d'un propriétaire de contenu. Ces rapports indiquent, par exemple, le nombre de vues de vos vidéos.
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. Le id
pour la version actuelle de ce rapport est content_owner_basic_a3
.
Le id
pour cette version de ce rapport est content_owner_basic_a3
. Il présente les différences suivantes par rapport à la version a2
:
- Ajouter la métrique red_views
- Ajouter une 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. |
Métriques : | : |
Remarque:Le rapport content_owner_basic_a1
est entièrement obsolète.
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs dans les États des États-Unis et dans le District de Columbia. La id
de ce rapport est content_owner_province_a2
.
Le id
pour cette version de ce rapport est content_owner_province_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, province_code |
Métriques : | : |
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application où les vidéos ont été lues. La id
de ce rapport est content_owner_playback_location_a2
.
Le id
pour cette version de ce rapport est content_owner_playback_location_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une métrique red_watch_time_minutes
Sources de trafic
Ce rapport présente des statistiques sur la façon dont les internautes ont accédé aux vidéos sur les chaînes du propriétaire de contenu.
Il permet par exemple d'identifier le nombre de vues résultant d'une recherche Google ou d'un lien vers une vidéo similaire. La id
de ce rapport est content_owner_traffic_source_a2
.
Le id
pour cette version de ce 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 une 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 : | vues, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Type d'appareil et 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'appareil des spectateurs. Par exemple, il identifie le nombre de vues enregistrées sur les tablettes Android ou sur les ordinateurs de bureau Windows. La id
de ce rapport est content_owner_device_os_a2
.
Le id
pour cette version de ce 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 une 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 : | vues, 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 présente le nombre de vues cumulées en fonction de la tranche d'âge et du sexe des spectateurs.
La 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, genre |
Métriques : | vues_percentage |
Partage de contenu par plate-forme
Ce rapport présente des statistiques sur la fréquence à laquelle les vidéos des chaînes du propriétaire de contenu ont été partagées sur différentes plates-formes de réseaux sociaux.
La 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 : | partages |
Annotations
Ce rapport présente des statistiques sur les annotations qui s'affichent pendant la lecture des vidéos sur les chaînes des propriétaires de contenu.
Les données du rapport mesurent les performances de chaque annotation pour chaque vidéo. En revanche, le rapport sur l'activité de l'utilisateur regroupe les statistiques de toutes les annotations d'une vidéo.
La id
de ce rapport est content_owner_annotations_a1
.
Fiches
Ce rapport fournit des statistiques sur les impressions et les clics pour les fiches qui s'affichent pendant les vidéos sur la chaîne d'un propriétaire de contenu.
Les données du rapport mesurent les performances de chaque fiche. En revanche, le rapport sur l'activité de l'utilisateur regroupe les statistiques de toutes les fiches d'une vidéo.
La 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 après l'arrêt de la vidéo.
Le rapport contient des statistiques sur les vidéos des chaînes d'un propriétaire de contenu.
La 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_type_id_ |
Métriques : | end_screen_element_clicks, end_screen_element_impressions et end_screen_element_click_rate |
Sous-titres
Ce rapport présente des statistiques sur la langue de sous-titres utilisée le plus longtemps lors du visionnage d'une vidéo. Les vues pour lesquelles les sous-titres sont principalement désactivés sont exclues. La id
de ce rapport est content_owner_subtitles_a2
.
Le id
pour cette version de ce rapport est content_owner_subtitles_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une métrique red_watch_time_minutes
Combinées
Ce rapport présente des statistiques détaillées sur les vidéos en combinant les dimensions utilisées dans les rapports sur les lieux de lecture, les sources de trafic et les appareils/OS. La id
de ce rapport est content_owner_combined_a2
.
Le id
pour cette version de ce rapport est content_owner_combined_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, playback_location_type, traffic_source_type |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Rapports sur les playlists
Les rapports sur les playlists fournissent des statistiques spécifiques aux vues de vidéos enregistrées dans le cadre d'une playlist.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les interactions des utilisateurs avec les playlists d'un propriétaire de contenu.
La 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 : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs concernant les interactions des internautes avec les playlists d'un propriétaire de contenu sur les chaînes d'un utilisateur aux États-Unis et dans 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_playlist_province_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Contextes de lecture
Ce rapport fournit des statistiques sur le type de page ou d'application où les playlists ont été lues. La 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 : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Sources de trafic
Ce rapport présente les statistiques de visionnage selon la façon dont les internautes ont accédé aux vidéos d'une playlist sur les chaînes d'un propriétaire de contenu.
Il permet par exemple d'identifier le nombre de vues résultant d'une recherche Google ou d'un lien vers une vidéo similaire. La 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 : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Type d'appareil et système d'exploitation
Ce rapport regroupe les statistiques de visionnage des playlists en fonction des systèmes d'exploitation et des types d'appareil des spectateurs. Par exemple, il identifie le nombre de vues enregistrées sur les tablettes Android ou sur les ordinateurs de bureau Windows. La 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 : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Combinées
Ce rapport présente des statistiques détaillées sur les playlists en combinant les dimensions utilisées dans les rapports sur les lieux de lecture, les sources de trafic et les appareils/OS. La id
de ce rapport est content_owner_playlist_combined_a1
.
Sommaire | |
---|---|
Dimensions : | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_location, country_code, playback_location_type, traffic_source_type, device_typesystem |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added et playlist_saves_removed |
Rapports sur le tarif des annonces
Les rapports sur le taux d'annonces fournissent des métriques basées sur les impressions pour les annonces diffusées pendant les lectures de vidéos. Ces métriques tiennent compte de 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 statistiques relatives aux annonces suivant, qui fournit des métriques sur les statistiques relatives aux vidéos d'un propriétaire de contenu. Le id
pour la version actuelle de ce rapport est content_owner_ad_rates_a1
.
Le id
pour cette version de ce 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 met à jour le nom du rapport pour utiliser le mot rates
au lieu de 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 des vidéos provenant de sources publicitaires vendues et vendues par Google. 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 total des revenus générés grâce à ces sources.
Revenu prévisionnel des vidéos
Ce rapport fournit le total des revenus de toutes les vidéos d'un propriétaire de contenu provenant de sources publicitaires vendues par Google et non publicitaires. Il contient également des métriques sur les performances des annonces. Le id
pour la version actuelle de ce rapport est content_owner_estimated_revenue_a1
.
Le id
pour cette version de ce 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
:
- Ajoute la métrique estimated_partner_red_revenue
- Ajoute la métrique estimated_partner_transaction_revenue
- La métrique estimated_partner_ad_sense_revenue est renommée estimated_partner_ad_auction_revenue.
- La métrique estimated_partner_double_click_revenue est renommée estimated_partner_ad_reserved_revenue.
- Met à jour le nom du rapport pour utiliser le mot
revenue
au lieu deearnings
. 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.
Sommaire | |
---|---|
Dimensions : | date, channel_id, video_id, claimed_status, uploader_type, country_code |
Métriques : | : |
Revenu prévisionnel des éléments
Ce rapport fournit le total des revenus de tous les éléments d'un propriétaire de contenu provenant de sources publicitaires vendues par Google et 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 importé le video_id pour lequel les métriques sont fournies. Le id
pour la version actuelle de ce rapport est content_owner_asset_estimated_revenue_a1
.
Le id
pour cette version de ce 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
:
- Ajoute la métrique estimated_partner_red_revenue
- Ajoute la métrique estimated_partner_transaction_revenue
- La métrique estimated_partner_ad_sense_revenue est renommée estimated_partner_ad_auction_revenue.
- La métrique estimated_partner_double_click_revenue est renommée estimated_partner_ad_reserved_revenue.
- Met à jour le nom du rapport pour utiliser le mot
revenue
au lieu deearnings
. 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 lié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 ce dernier a revendiqué la vidéo en faisant une correspondance avec l'un des éléments du propriétaire de contenu. La vidéo peut avoir été mise en ligne par le propriétaire du contenu ou un autre utilisateur YouTube.
Dans les rapports sur les assets, la dimension channel_id identifie la chaîne qui a importé le video_id pour lequel des métriques sont fournies.
Par exemple, un jour donné, une vidéo est regardée 10 fois, puis elle est revendiquée, puis 10 fois une autre fois. Le rapport sur les éléments de ce jour indiquera que la vidéo a été vue 20 fois, même si seulement 10 de ces vues se sont produites après la revendication. Les métriques sur tous les jours suivants doivent refléter fidèlement l'activité des utilisateurs en lien avec la vidéo revendiquée.
Activité de l'utilisateur
Ce rapport fournit des statistiques sur les actions des utilisateurs sur les vidéos liées aux éléments d'un propriétaire de contenu. La id
de ce rapport est content_owner_asset_basic_a2
.
Le id
pour cette version de ce rapport est content_owner_asset_basic_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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 |
Métriques : | : |
Activité des utilisateurs par province
Ce rapport fournit des statistiques sur l'activité des utilisateurs dans les États des États-Unis et dans 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_a2
.
Le id
pour cette version de ce rapport est content_owner_asset_province_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, province_code |
Métriques : | : |
Contextes de lecture vidéo
Ce rapport fournit des statistiques sur le type de page ou d'application où les vidéos ont été lues. La id
de ce rapport est content_owner_asset_playback_location_a2
.
Le id
pour cette version de ce rapport est content_owner_asset_playback_location_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, playback_location_type2 |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Sources de trafic
Ce rapport présente les statistiques de visionnage selon la façon dont les internautes accèdent au contenu vidéo associé aux éléments de son propriétaire. Il permet par exemple d'identifier le nombre de vues résultant d'une recherche Google ou d'un lien vers une vidéo similaire. La id
de ce rapport est content_owner_asset_traffic_source_a2
.
Le id
pour cette version de ce 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 une 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_type |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Type d'appareil et 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'appareil des spectateurs. Par exemple, il identifie le nombre de vues enregistrées sur les tablettes Android ou sur les ordinateurs de bureau Windows. La id
de ce rapport est content_owner_asset_device_os_a2
.
Le id
pour cette version de ce rapport est content_owner_asset_device_os_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, system |
Métriques : | vues, 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 présente le nombre de vues cumulées en fonction de la tranche d'âge et du sexe 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, |
Métriques : | vues_percentage |
Partage de contenu par plate-forme
Ce rapport présente des statistiques sur la fréquence à laquelle les vidéos associées aux éléments d'un propriétaire de contenu ont été partagées sur différentes plates-formes de réseaux sociaux. 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 : | partages |
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é de l'utilisateur regroupe les statistiques de toutes les annotations d'une vidéo. La id
de ce rapport est content_owner_asset_annotations_a1
.
Fiches
Ce rapport fournit des statistiques sur les impressions et les clics pour les fiches 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 fiche. En revanche, le rapport sur l'activité de l'utilisateur regroupe les statistiques de toutes les fiches qui s'affichent dans chaque vidéo associée à un asset. 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, |
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 après l'arrêt de la vidéo. Ce rapport contient des statistiques sur les vidéos revendiquées sur les chaînes d'un propriétaire de contenu, ainsi que 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 |
Métriques : | end_screen_element_clicks, end_screen_element_impressions et end_screen_element_click_rate |
Combinées
Ce rapport présente des statistiques détaillées sur les vidéos en combinant les dimensions utilisées dans les rapports sur les lieux de lecture, les sources de trafic et les appareils/OS. La id
de ce rapport est content_owner_asset_combined_a2
.
Le id
pour cette version de ce rapport est content_owner_asset_combined_a2
. Il présente les différences suivantes par rapport à la version a1
:
- Ajouter la métrique red_views
- Ajouter une 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, playback_location_type |
Métriques : | vues, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |