이 페이지에는 콘텐츠 소유자가 YouTube Reporting API로 검색할 수 있는 보고서가 나와 있습니다. API의 reportTypes.list
메서드에서 반환하는 각 보고서의 id
는 보고서 이름 옆에 괄호로 표시됩니다.
동영상 보고서
동영상 보고서는 채널 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이 보고서에는 동영상이 조회된 횟수가 포함되어 있습니다.
사용자 활동
이 보고서는 콘텐츠 소유자의 채널 및 해당 동영상과 관련된 사용자 활동 통계를 제공합니다. 이 보고서의 현재 버전에 대한 id
은 content_owner_basic_a3
입니다.
이 보고서의 id
버전은 content_owner_basic_a3
입니다. a2
버전과의 차이점은 다음과 같습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목을 추가합니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code |
측정항목: | 을 확인해 주세요. |
참고: content_owner_basic_a1
보고서는 완전히 지원 중단되었습니다.
행정구역별 사용자 활동
이 보고서에서는 미국 주 및 컬럼비아 특별구에 대한 사용자 활동 통계를 제공합니다. 이 보고서의 id
은 content_owner_province_a2
입니다.
이 보고서의 id
버전은 content_owner_province_a2
입니다. a1
버전과의 차이점은 다음과 같습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목을 추가합니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, state_code |
측정항목: | 10월 24일까지 |
재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다. 이 보고서의 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 |
측정항목: | 조회수_백분율 |
플랫폼별 콘텐츠 공유
이 보고서는 콘텐츠 소유자 채널의 동영상이 여러 소셜 플랫폼에서 얼마나 자주 공유되었는지를 보여주는 통계를 제공합니다.
이 보고서의 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 |
측정항목: | 공유 |
주석
이 보고서는 콘텐츠 소유자 채널에서 동영상 재생 중에 표시되는 특수효과에 대한 통계를 제공합니다.
보고서 데이터는 각 동영상에 대한 개별 특수효과의 실적을 측정합니다. 반대로 사용자 활동 보고서는 동영상의 모든 특수효과에 대한 통계를 집계합니다.
이 보고서의 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
입니다.
행정구역별 사용자 활동
이 보고서는 미국 주 및 컬럼비아 특별구의 사용자를 위해 콘텐츠 소유자 채널에서 사용자와 재생목록의 상호작용과 관련된 사용자 활동 통계를 제공합니다.
즉, 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_Scheduled_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_Scheduled_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 측정항목을 추가합니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code |
측정항목: | 을 확인해 주세요. |
행정구역별 사용자 활동
이 보고서에서는 미국 주 및 컬럼비아 특별구에 대한 사용자 활동 통계를 제공합니다. 즉, country_code 측정기준의 값이 US
인 경우에만 데이터가 포함되도록 보고서가 필터링됩니다. 이 보고서의 id
은 content_owner_asset_province_a2
입니다.
이 보고서의 id
버전은 content_owner_asset_province_a2
입니다. a1
버전과의 차이점은 다음과 같습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목을 추가합니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, state_code |
측정항목: | 10월 24일까지 |
동영상 재생 위치
이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다. 이 보고서의 id
은 content_owner_asset_playback_location_a2
입니다.
이 보고서의 id
버전은 content_owner_asset_playback_location_a2
입니다. a1
버전과의 차이점은 다음과 같습니다.
- red_views 측정항목 추가
- red_watch_time_minutes 측정항목을 추가합니다.
목차 | |
---|---|
크기: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_type |
측정항목: | 조회수, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, 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, {20 |
측정항목: | 조회수_백분율 |
플랫폼별 콘텐츠 공유
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상이 여러 소셜 플랫폼에서 얼마나 자주 공유되었는지를 보여주는 통계를 제공합니다. 이 보고서의 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 |
측정항목: | 공유 |
주석
이 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상 중에 표시되는 특수효과에 대한 통계를 제공합니다. 보고서 데이터는 개별 주석의 실적을 측정합니다. 반대로 사용자 활동 보고서는 동영상의 모든 특수효과에 대한 통계를 집계합니다. 이 보고서의 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 측정항목을 추가합니다.