이 페이지에는 콘텐츠 소유자가 YouTube Reporting API를 사용하여 가져올 수 있는 보고서가 나열되어 있습니다. API의 reportTypes.list
메서드에서 반환된 각 보고서의 id
는 보고서 이름 옆의 괄호 안에 표시됩니다.
동영상 보고서
동영상 보고서는 채널의 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이러한 보고서에는 동영상이 조회된 횟수가 포함됩니다.
사용자 활동
이 보고서는 콘텐츠 소유자의 채널과 해당 채널의 동영상에 관련된 사용자 활동 통계를 제공합니다.
이 보고서의 id
는 content_owner_basic_a4
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code
측정항목:
engaged_views , views , comments , shares , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes , card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks , subscribers_gained , subscribers_lost , videos_added_to_playlists , videos_removed_from_playlists , likes , dislikes , red_views
행정구역별 사용자 활동
이 보고서는 미국 주 및 컬럼비아 특별구의 사용자 활동 통계를 제공합니다.
이 보고서의 id
는 content_owner_province_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , province_code
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes , card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks , red_views , red_watch_time_minutes
재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다.
이 보고서의 id
는 content_owner_playback_location_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자의 채널에서 동영상에 도달한 방식을 기반으로 시청 통계를 집계합니다.
예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다.
이 보고서의 id
는 content_owner_traffic_source_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 동영상 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다.
이 보고서의 id
는 content_owner_device_os_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
시청자 인구통계
이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다.
이 보고서의 id
는 content_owner_demographics_a1
입니다.
플랫폼별 콘텐츠 공유
이 보고서는 콘텐츠 소유자의 채널에 있는 동영상이 다양한 소셜 플랫폼에서 공유된 빈도를 보여주는 통계를 제공합니다.
이 보고서의 id
는 content_owner_sharing_service_a1
입니다.
주석
이 보고서는 콘텐츠 소유자의 채널에서 동영상 재생 중에 표시되는 주석에 대한 통계를 제공합니다.
보고서 데이터는 각 동영상의 개별 특수효과 실적을 측정합니다. 반면 사용자 활동 보고서 는 동영상의 모든 주석에 대한 통계를 집계합니다.
이 보고서의 id
는 content_owner_annotations_a1
입니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , annotation_type , annotation_id
측정항목:
annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes
카드
이 보고서는 콘텐츠 소유자 채널의 동영상 재생 중에 표시되는 카드 의 노출수 및 클릭률 통계를 제공합니다.
보고서 데이터는 개별 카드의 실적을 측정합니다. 반면 사용자 활동 보고서 는 동영상의 모든 카드의 통계를 집계합니다.
이 보고서의 id
는 content_owner_cards_a1
입니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , card_type , card_id
측정항목:
card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks
최종 화면
이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면의 노출수 및 클릭률 통계를 제공합니다.
이 보고서에는 콘텐츠 소유자의 채널에 있는 동영상에 대한 통계가 포함되어 있습니다.
이 보고서의 id
은 content_owner_end_screens_a1
입니다.
목차
크기:
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
측정항목:
end_screen_element_clicks , end_screen_element_impressions , end_screen_element_click_rate
자막
이 보고서는 동영상 조회 중에 가장 오랫동안 사용된 자막 언어에 관한 통계를 제공합니다. 자막이 대부분 사용 중지된 조회수는 제외됩니다.
이 보고서의 id
는 content_owner_subtitles_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , subtitle_language , subtitle_language_autotranslated
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
결합
이 보고서는 재생 위치 , 트래픽 소스 , 기기/OS 보고서에 사용된 측정기준을 결합하여 세부적인 동영상 통계를 제공합니다.
이 보고서의 id
는 content_owner_combined_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , traffic_source_type , device_type , operating_system
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
재생목록 보고서
재생목록 보고서는 재생목록 컨텍스트에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다.
사용자 활동
이 보고서는 콘텐츠 소유자 채널의 재생목록과 사용자의 상호작용에 관한 통계를 제공합니다.
이 보고서의 id
는 content_owner_playlist_basic_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
행정구역별 사용자 활동
이 보고서는 미국 주 및 컬럼비아 특별구의 사용자를 대상으로 콘텐츠 소유자 채널의 재생목록과 사용자의 상호작용에 관련된 사용자 활동 통계를 제공합니다. country_code 측정기준 값이 US
인 경우에만 데이터가 포함되도록 보고서가 필터링됩니다.
이 보고서의 id
는 content_owner_playlist_province_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , province_code
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
재생 위치
이 보고서는 재생목록 재생이 발생한 페이지 또는 애플리케이션 유형과 관련된 통계를 제공합니다.
이 보고서의 id
는 content_owner_playlist_playback_location_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자 채널에서 재생목록 동영상에 도달한 방식을 기반으로 조회 통계를 집계합니다. 예를 들어 이 보고서는 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 파악합니다.
이 보고서의 id
는 content_owner_playlist_traffic_source_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 재생목록 조회 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다.
이 보고서의 id
는 content_owner_playlist_device_os_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , device_type , operating_system
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
결합
이 보고서는 재생 위치 , 트래픽 소스 , 기기/OS 보고서에 사용되는 측정기준을 결합하여 세부적인 재생목록 통계를 제공합니다.
이 보고서의 id
는 content_owner_playlist_combined_a2
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
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
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed
광고료 보고서
광고 비율 보고서는 동영상 재생 중에 게재된 광고의 노출수 기반 측정항목을 제공합니다. 이러한 측정항목은 각 광고 노출을 고려하며 각 동영상 재생은 여러 노출을 발생시킬 수 있습니다.
API는 콘텐츠 소유자의 동영상에 대한 광고 비율 측정항목을 제공하는 다음 광고 비율 보고서를 지원합니다.
이 보고서의 id
는 content_owner_ad_rates_a1
입니다.
이제 완전히 지원 중단된 이 보고서의 이전 버전 ID는 content_owner_ad_performance_a1
입니다.
이전 버전과의 유일한 차이점은 이 버전에서 보고서 이름이 performance
대신 rates
단어를 사용하도록 업데이트된다는 점입니다. 따라서 보고서 자체의 버전 번호는 이전 버전과 동일한 a1
이지만 report ID
은 다릅니다.
예상 수익 보고서
예상 수익 보고서에는 Google 판매 광고 소스 및 비광고 소스에서 발생한 동영상의 총 예상 수익이 표시됩니다. 이러한 보고서에는 일부 광고 실적 측정항목도 포함되어 있습니다.
수입 측정항목은 특정 수익원과 해당 수익원을 통해 발생한 총수익 금액을 식별합니다.
예상 동영상 수익
이 보고서는 콘텐츠 소유자의 모든 동영상에서 Google 판매 광고 소스 및 비광고 소스를 통해 발생한 총수입을 제공합니다. 또한 일부 광고 실적 측정항목도 포함되어 있습니다.
이 보고서의 id
는 content_owner_estimated_revenue_a2
입니다.
목차
크기:
date , channel_id , video_id , claimed_status , uploader_type , country_code
측정항목:
estimated_partner_revenue ,
estimated_partner_ad_revenue ,
estimated_partner_ad_auction_revenue ,
estimated_partner_ad_reserved_revenue ,
estimated_youtube_ad_revenue ,
estimated_monetized_playbacks ,
estimated_playback_based_cpm ,
ad_impressions ,
estimated_cpm ,
estimated_partner_red_revenue ,
estimated_partner_transaction_revenue
예상 자산 수익
이 보고서에는 콘텐츠 소유자의 모든 애셋에서 Google 판매 광고 소스 및 비광고 소스를 통해 발생한 총수입이 표시됩니다. 또한 일부 광고 실적 측정항목도 포함되어 있습니다. channel_id 측정기준은 측정항목이 제공되는 video_id 를 업로드한 채널을 식별합니다.
이 보고서의 id
는 content_owner_asset_estimated_revenue_a2
입니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , country_code
측정항목:
estimated_partner_revenue , estimated_partner_ad_revenue , estimated_partner_ad_auction_revenue , estimated_partner_ad_reserved_revenue , estimated_partner_red_revenue , estimated_partner_transaction_revenue
저작물 보고서
저작물 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상과 관련된 사용자 활동 측정항목을 제공합니다. 콘텐츠 소유자가 동영상을 콘텐츠 소유자의 저작물 중 하나의 일치 항목으로 소유권을 주장한 경우 해당 동영상은 콘텐츠 소유자의 보고서에 포함됩니다. 동영상은 콘텐츠 소유자 또는 다른 YouTube 사용자가 업로드했을 수 있습니다.
저작물 보고서에서 channel_id 측정기준은 측정항목이 제공되는 video_id 를 업로드한 채널을 식별합니다.
참고: 동영상의 소유권이 주장된 날짜의 경우 저작물 보고서의 사용자 활동 측정항목이 올바르지 않을 수 있습니다. 이러한 차이는 보고서의 측정항목이 신고가 제출된 후 발생한 활동뿐만 아니라 해당 날짜의 모든 사용자 활동을 반영하기 때문에 발생합니다.
예를 들어 특정 날짜에 동영상이 10회 시청된 후 소유권 주장이 제기되고 다시 10회 시청된다고 가정해 보겠습니다. 소유권 주장이 제기된 후 발생한 조회수는 10회에 불과하지만 해당 날짜의 저작물 보고서에는 동영상이 20회 시청된 것으로 표시됩니다. 모든 연속된 날짜의 측정항목은 소유권 주장이 제기된 동영상과 관련된 사용자 활동을 정확하게 반영해야 합니다.
사용자 활동
이 보고서는 콘텐츠 소유자의 애셋에 연결된 동영상에 대한 사용자의 활동과 관련된 통계를 제공합니다.
이 버전의 보고서에 대한 id
은 content_owner_asset_basic_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code
측정항목:
engaged_views , views , comments , likes , dislikes , videos_added_to_playlists , videos_removed_from_playlists , shares , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes , card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks , red_views , red_watch_time_minutes
행정구역별 사용자 활동
이 보고서는 미국 주 및 컬럼비아 특별구의 사용자 활동 통계를 제공합니다. 즉, country_code 측정기준의 값이 US
인 경우에만 보고서에 데이터가 포함되도록 필터링됩니다. 이 보고서의 id
는 content_owner_asset_province_a3
입니다.
이 버전의 보고서에 대한 id
은 content_owner_asset_province_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , province_code
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes , card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks , red_views , red_watch_time_minutes
동영상 재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다.
이 버전의 보고서에 대한 id
은 content_owner_asset_playback_location_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자의 저작물에 연결된 동영상 콘텐츠에 도달한 방식을 기반으로 시청 통계를 집계합니다. 예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다.
이 버전의 보고서에 대한 id
은 content_owner_asset_traffic_source_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
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
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 동영상 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다.
이 버전의 보고서에 대한 id
은 content_owner_asset_device_os_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes
시청자 인구통계
이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다. 이 보고서의 id
는 content_owner_asset_demographics_a1
입니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , age_group , gender
측정항목:
views_percentage
플랫폼별 콘텐츠 공유
이 보고서는 콘텐츠 소유자의 애셋에 연결된 동영상이 다양한 소셜 플랫폼에서 공유된 빈도를 보여주는 통계를 제공합니다. 이 보고서의 id
는 content_owner_asset_sharing_service_a1
입니다.
주석
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상에 표시되는 주석에 대한 통계를 제공합니다. 보고서 데이터는 개별 특수효과의 실적을 측정합니다. 반면 사용자 활동 보고서 는 동영상의 모든 주석에 대한 통계를 집계합니다. 이 보고서의 id
는 content_owner_asset_annotations_a1
입니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , annotation_type , annotation_title
측정항목:
annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes
카드
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상 재생 중에 표시되는 카드 의 노출수 및 클릭률 통계를 제공합니다. 보고서 데이터는 개별 카드의 실적을 측정합니다. 반면 사용자 활동 보고서 는 애셋에 연결된 각 동영상에 표시되는 모든 카드의 통계를 집계합니다. 이 보고서의 id
는 content_owner_asset_cards_a1
입니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , card_type , card_id
측정항목:
card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks
최종 화면
이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면의 노출수 및 클릭률 통계를 제공합니다. 이 보고서에는 콘텐츠 소유자 채널에서 소유권 주장이 제기된 동영상의 통계가 포함되어 있으며 동영상과 연결된 저작물도 식별됩니다. 이 보고서의 id
는 content_owner_asset_end_screens_a1
입니다.
목차
크기:
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
측정항목:
end_screen_element_clicks , end_screen_element_impressions , end_screen_element_click_rate
결합
이 보고서는 재생 위치 , 트래픽 소스 , 기기/OS 보고서에 사용된 측정기준을 결합하여 세부적인 동영상 통계를 제공합니다.
이 보고서의 id
는 content_owner_asset_combined_a3
입니다.
참고: 이 보고서의 최신 버전은 이전 버전과 다음과 같은 차이가 있습니다.
목차
크기:
date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , traffic_source_type , device_type , operating_system
측정항목:
engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes