이 페이지에는 콘텐츠 소유자가 YouTube Reporting API로 가져올 수 있는 보고서가 나와 있습니다. API의 reportTypes.list
메서드에서 반환한 각 보고서의 id
는 보고서 이름 옆에 괄호로 표시됩니다.
동영상 보고서
동영상 보고서는 채널의 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이러한 보고서에는 동영상 조회수가 포함됩니다.
사용자 활동
이 보고서는 콘텐츠 소유자의 채널과 해당 채널의 동영상과 관련된 사용자 활동 통계를 제공합니다. 이 보고서의 현재 버전의 id
는 content_owner_basic_a3
입니다.
이 버전의 보고서의 id
는 content_owner_basic_a3
입니다. 버전 a2
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
참고: content_owner_basic_a1
보고서는 완전히 지원 중단되었습니다.
행정구역별 사용자 활동
이 보고서는 미국 각 주 및 워싱턴 D.C. 의 사용자 활동 통계를 제공합니다. 이 보고서의 id
는 content_owner_province_a2
입니다.
이 버전의 보고서의 id
는 content_owner_province_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다. 이 보고서의 id
는 content_owner_playback_location_a2
입니다.
이 버전의 보고서의 id
는 content_owner_playback_location_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자의 채널에서 동영상에 도달한 방식을 기준으로 시청 통계를 집계합니다.
예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_traffic_source_a2
입니다.
이 버전의 보고서의 id
는 content_owner_traffic_source_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 동영상 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_device_os_a2
입니다.
이 버전의 보고서의 id
는 content_owner_device_os_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
시청자 인구통계
이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다.
이 보고서의 id
는 content_owner_demographics_a1
입니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
측정항목: | views_percentage |
플랫폼별 콘텐츠 공유
이 보고서는 콘텐츠 소유자의 채널에 있는 동영상이 여러 소셜 플랫폼에 공유된 빈도를 보여주는 통계를 제공합니다.
이 보고서의 id
는 content_owner_sharing_service_a1
입니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
측정항목: | shares |
주석
이 보고서는 콘텐츠 소유자의 채널에 있는 동영상 중에 표시되는 주석에 대한 통계를 제공합니다.
보고서 데이터는 각 동영상의 개별 특수효과 실적을 측정합니다. 반면 사용자 활동 보고서는 동영상의 모든 주석에 대한 통계를 집계합니다.
이 보고서의 id
는 content_owner_annotations_a1
입니다.
카드
이 보고서는 콘텐츠 소유자의 채널에 있는 동영상 중에 표시되는 카드의 노출수 및 클릭률 통계를 제공합니다.
보고서 데이터는 개별 카드의 실적을 측정합니다. 반면 사용자 활동 보고서는 동영상의 모든 카드에 대한 통계를 집계합니다.
이 보고서의 id
는 content_owner_cards_a1
입니다.
최종 화면
이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면에 대한 노출수 및 클릭률 통계를 제공합니다.
이 보고서에는 콘텐츠 소유자의 채널에 있는 동영상의 통계가 포함됩니다.
이 보고서의 id
는 content_owner_end_screens_a1
입니다.
자막
이 보고서는 동영상 재생 중에 가장 오래 사용된 자막 언어에 대한 통계를 제공합니다. 자막이 대부분 사용 중지된 조회수는 제외됩니다. 이 보고서의 id
는 content_owner_subtitles_a2
입니다.
이 버전의 보고서의 id
는 content_owner_subtitles_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
결합
이 보고서는 재생 위치, 트래픽 소스, 기기/OS 보고서에 사용된 측정기준을 결합하여 세부적인 동영상 통계를 제공합니다. 이 보고서의 id
는 content_owner_combined_a2
입니다.
이 버전의 보고서의 id
는 content_owner_combined_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
재생목록 보고서
재생목록 보고서는 재생목록 맥락에서 발생한 동영상 조회수와 관련된 통계를 제공합니다.
사용자 활동
이 보고서는 콘텐츠 소유자 채널의 재생목록과 관련된 사용자 상호작용에 관한 통계를 제공합니다.
이 보고서의 id
는 content_owner_playlist_basic_a1
입니다.
행정구역별 사용자 활동
이 보고서는 미국 각 주 및 워싱턴 D.C. 의 사용자를 대상으로 콘텐츠 소유자 채널의 재생목록과 관련된 사용자 상호작용에 관한 사용자 활동 통계를 제공합니다.
즉, country_code 측정기준의 값이 US
인 경우에만 데이터가 포함되도록 보고서가 필터링됩니다. 이 보고서의 id
는 content_owner_playlist_province_a1
입니다.
재생 위치
이 보고서는 재생목록 재생이 발생한 페이지 또는 애플리케이션 유형과 관련된 통계를 제공합니다. 이 보고서의 id
는 content_owner_playlist_playback_location_a1
입니다.
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자의 채널에서 재생목록 동영상에 도달한 방식을 기준으로 시청 통계를 집계합니다.
예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_playlist_traffic_source_a1
입니다.
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 재생목록 조회 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_playlist_device_os_a1
입니다.
결합
이 보고서는 재생 위치, 트래픽 소스, 기기/OS 보고서에 사용된 측정기준을 결합하여 세분화된 재생목록 통계를 제공합니다. 이 보고서의 id
는 content_owner_playlist_combined_a1
입니다.
광고료 보고서
광고비율 보고서는 동영상 재생 중에 게재된 광고의 노출 기반 측정항목을 제공합니다. 이 측정항목은 각 광고 노출을 고려하며, 동영상 재생마다 여러 노출이 발생할 수 있습니다.
API는 콘텐츠 소유자의 동영상에 대한 광고 요금 측정항목을 제공하는 다음과 같은 광고 요금 보고서를 지원합니다. 이 보고서의 현재 버전의 id
는 content_owner_ad_rates_a1
입니다.
이 버전의 보고서의 id
는 content_owner_ad_rates_a1
입니다. 이제 완전히 지원 중단된 이 보고서의 이전 버전 ID는 content_owner_ad_performance_a1
였습니다.
이전 버전과의 유일한 차이점은 이 버전에서는 보고서 이름을 업데이트하여 performance
대신 rates
라는 단어를 사용한다는 점입니다. 따라서 보고서 자체의 버전 번호 (a1
)는 이전 버전과 동일하지만 report ID
는 다릅니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, claimed_status, uploader_type, country_code, ad_type |
측정항목: | estimated_youtube_ad_revenue, ad_impressions, estimated_cpm |
예상 수익 보고서
예상 수익 보고서에는 Google에서 판매한 광고 소스 및 광고 이외의 소스에서 발생한 동영상의 총 예상 수익이 표시됩니다. 이 보고서에는 일부 광고 실적 측정항목도 포함되어 있습니다.
수입 측정항목은 특정 수익원과 해당 수익원을 통해 발생한 총수익 금액을 식별합니다.
예상 동영상 수익
이 보고서에는 콘텐츠 소유자의 모든 동영상에서 Google에서 판매한 광고 소스와 비광고 소스에서 발생한 총 수입이 표시됩니다. 여기에는 일부 광고 실적 측정항목도 포함되어 있습니다. 이 보고서의 현재 버전의 id
는 content_owner_estimated_revenue_a1
입니다.
이 버전의 보고서의 id
는 content_owner_estimated_revenue_a1
입니다. 이전 버전(content_owner_estimated_earnings_a1
)과는 다음과 같은 차이점이 있습니다.
- estimated_partner_red_revenue 측정항목을 추가합니다.
- estimated_partner_transaction_revenue 측정항목을 추가합니다.
- estimated_partner_ad_sense_revenue 측정항목의 이름을 estimated_partner_ad_auction_revenue로 변경합니다.
- estimated_partner_double_click_revenue 측정항목의 이름을 estimated_partner_ad_reserved_revenue로 변경합니다.
earnings
대신revenue
단어를 사용하도록 보고서 이름을 업데이트합니다. 따라서 보고서 자체의 버전 번호 (a1
)는 이전 버전과 동일하지만report ID
는 다릅니다.
예상 자산 수익
이 보고서에는 Google에서 판매한 광고 소스 및 광고 이외의 소스에서 발생한 콘텐츠 소유자의 모든 애셋의 총수익이 표시됩니다. 여기에는 일부 광고 실적 측정항목도 포함되어 있습니다. channel_id 측정기준은 측정항목이 제공되는 video_id를 업로드한 채널을 식별합니다. 이 보고서의 현재 버전의 id
는 content_owner_asset_estimated_revenue_a1
입니다.
이 버전의 보고서의 id
는 content_owner_asset_estimated_revenue_a1
입니다. 이전 버전(content_owner_asset_estimated_earnings_a1
)과는 다음과 같은 차이점이 있습니다.
- estimated_partner_red_revenue 측정항목을 추가합니다.
- estimated_partner_transaction_revenue 측정항목을 추가합니다.
- estimated_partner_ad_sense_revenue 측정항목의 이름을 estimated_partner_ad_auction_revenue로 변경합니다.
- estimated_partner_double_click_revenue 측정항목의 이름을 estimated_partner_ad_reserved_revenue로 변경합니다.
earnings
대신revenue
단어를 사용하도록 보고서 이름을 업데이트합니다. 따라서 보고서 자체의 버전 번호 (a1
)는 이전 버전과 동일하지만report ID
는 다릅니다.
저작물 보고서
저작물 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상과 관련된 사용자 활동 측정항목을 제공합니다. 콘텐츠 소유자가 동영상이 콘텐츠 소유자의 저작물 중 하나와 일치한다고 주장한 경우 동영상이 콘텐츠 소유자의 보고서에 포함됩니다. 동영상은 콘텐츠 소유자 또는 다른 YouTube 사용자가 업로드했을 수 있습니다.
저작물 보고서에서 channel_id 측정기준은 측정항목이 제공되는 video_id를 업로드한 채널을 식별합니다.
예를 들어 특정 날짜에 동영상이 10회 조회된 후 소유권 주장이 제기되고 다시 10회 조회되었다고 가정해 보겠습니다. 이 날의 저작물 보고서에는 소유권 주장이 제기된 후 발생한 조회 10회만 포함되어 있지만 동영상이 20회 조회된 것으로 표시됩니다. 연속된 모든 날짜의 측정항목은 소유권 주장이 제기된 동영상과 관련된 사용자 활동을 정확하게 반영해야 합니다.
사용자 활동
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상에서 사용자의 액션과 관련된 통계를 제공합니다. 이 보고서의 id
는 content_owner_asset_basic_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_basic_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
행정구역별 사용자 활동
이 보고서는 미국 각 주 및 워싱턴 D.C. 의 사용자 활동 통계를 제공합니다. 즉, country_code 측정기준의 값이 US
인 경우에만 데이터가 포함되도록 보고서가 필터링됩니다. 이 보고서의 id
는 content_owner_asset_province_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_province_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
동영상 재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다. 이 보고서의 id
는 content_owner_asset_playback_location_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_playback_location_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
트래픽 소스
이 보고서는 시청자가 콘텐츠 소유자의 저작물에 연결된 동영상 콘텐츠에 도달한 방식을 기반으로 시청 통계를 집계합니다. 예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_asset_traffic_source_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_traffic_source_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 동영상 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 content_owner_asset_device_os_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_device_os_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- 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
입니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
측정항목: | shares |
주석
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상 중에 표시되는 주석에 대한 통계를 제공합니다. 보고서 데이터는 개별 특수효과의 실적을 측정합니다. 반면 사용자 활동 보고서는 동영상의 모든 주석에 대한 통계를 집계합니다. 이 보고서의 id
는 content_owner_asset_annotations_a1
입니다.
카드
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상 중에 표시되는 카드의 노출수 및 클릭률 통계를 제공합니다. 보고서 데이터는 개별 카드의 실적을 측정합니다. 반면 사용자 활동 보고서는 저작물에 연결된 각 동영상에 표시되는 모든 카드의 통계를 집계합니다. 이 보고서의 id
는 content_owner_asset_cards_a1
입니다.
최종 화면
이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면에 대한 노출수 및 클릭률 통계를 제공합니다. 이 보고서에는 콘텐츠 소유자의 채널에서 소유권 주장이 제기된 동영상에 대한 통계가 포함되며 동영상과 연결된 저작물도 식별됩니다. 이 보고서의 id
는 content_owner_asset_end_screens_a1
입니다.
결합
이 보고서는 재생 위치, 트래픽 소스, 기기/OS 보고서에 사용된 측정기준을 결합하여 세부적인 동영상 통계를 제공합니다. 이 보고서의 id
는 content_owner_asset_combined_a2
입니다.
이 버전의 보고서의 id
는 content_owner_asset_combined_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목 추가