YouTube에서 Shorts 동영상의 조회수를 집계하는 방식에 맞게 YouTube 분석 및 보고 API가 업데이트됩니다.
자세히 알아보기
Channel Reports
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에는 채널 소유자가 YouTube Reporting API로 가져올 수 있는 보고서가 나와 있습니다. API의 reportTypes.list
메서드에서 반환한 각 보고서의 id
는 보고서 설명에 제공됩니다.
동영상 보고서
동영상 보고서는 채널의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이러한 보고서에는 동영상 조회수가 포함됩니다.
사용자 활동
이 보고서는 채널과 동영상에 관련된 사용자 활동 통계를 제공합니다. 이 보고서의 id
는 channel_basic_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_basic_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code |
측정항목: |
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, subscribers_gained, subscribers_lost, red_views, red_watch_time_minutes |
행정구역별 사용자 활동
이 보고서는 미국 각 주 및 워싱턴 D.C. 의 사용자 활동 통계를 제공합니다. 이 보고서의 id
는 channel_province_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_province_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code
|
측정항목: |
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
는 channel_playback_location_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_playback_location_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
트래픽 소스
이 보고서는 시청자가 채널의 동영상 콘텐츠에 도달한 방식을 기준으로 시청 통계를 집계합니다.
예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 channel_traffic_source_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_traffic_source_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 동영상 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 channel_device_os_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_device_os_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
시청자 인구통계
이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다.
이 보고서의 id
는 channel_demographics_a1
입니다.
플랫폼별 콘텐츠 공유
이 보고서에서는 채널의 동영상이 여러 소셜 플랫폼에서 공유된 빈도를 보여주는 통계를 제공합니다.
이 보고서의 id
는 channel_sharing_service_a1
입니다.
주석
이 보고서는 채널의 동영상 중에 표시되는 주석에 대한 통계를 제공합니다.
보고서 데이터는 각 동영상의 개별 특수효과 실적을 측정합니다. 반면 사용자 활동 보고서는 동영상의 모든 주석에 대한 통계를 집계합니다.
이 보고서의 id
는 channel_annotations_a1
입니다.
목차 |
크기: |
date, channel_id, video_id, 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
는 channel_cards_a1
입니다.
목차 |
크기: |
date, channel_id, video_id, 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
는 channel_end_screens_a1
입니다.
자막
이 보고서는 동영상 재생 중에 가장 오래 사용된 자막 언어에 대한 통계를 제공합니다. 자막이 대부분 사용 중지된 조회수는 제외됩니다. 이 보고서의 id
는 channel_subtitles_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_subtitles_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, subtitle_language, subtitle_language_autotranslated
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
결합
이 보고서는 재생 위치, 트래픽 소스, 기기/OS 보고서에 사용된 측정기준을 결합하여 세부적인 동영상 통계를 제공합니다. 이 보고서의 id
는 channel_combined_a2
입니다.
상태: 현재
이 버전의 보고서의 id
는 channel_combined_a2
입니다. 버전 a1
와는 다음과 같은 차이점이 있습니다.
목차 |
크기: |
날짜, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
재생목록 보고서
재생목록 보고서는 재생목록 맥락에서 발생한 동영상 조회수와 관련된 통계를 제공합니다.
사용자 활동
이 보고서는 사용자가 채널의 재생목록과 상호작용한 것과 관련된 통계를 제공합니다.
이 보고서의 id
는 playlist_basic_a1
입니다.
목차 |
크기: |
date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
행정구역별 사용자 활동
이 보고서는 미국 각 주 및 워싱턴 D.C. 의 채널 재생목록과 관련된 사용자 상호작용에 관한 사용자 활동 통계를 제공합니다.
즉, country_code 측정기준의 값이 US
인 경우에만 데이터가 포함되도록 보고서가 필터링됩니다. 이 보고서의 id
는 playlist_province_a1
입니다.
목차 |
크기: |
date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
재생 위치
이 보고서는 재생목록 재생이 발생한 페이지 또는 애플리케이션 유형과 관련된 통계를 제공합니다. 이 보고서의 id
는 playlist_playback_location_a1
입니다.
목차 |
크기: |
date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
트래픽 소스
이 보고서는 시청자가 채널의 재생목록 동영상에 도달한 방식을 기준으로 시청 통계를 집계합니다.
예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 playlist_traffic_source_a1
입니다.
목차 |
크기: |
date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
기기 유형 및 운영체제
이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 재생목록 조회 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다. 이 보고서의 id
는 playlist_device_os_a1
입니다.
목차 |
크기: |
date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
결합
이 보고서는 재생 위치, 트래픽 소스, 기기/OS 보고서에 사용된 측정기준을 결합하여 세분화된 재생목록 통계를 제공합니다. 이 보고서의 id
는 playlist_combined_a1
입니다.
목차 |
크기: |
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
|
측정항목: |
views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-05-08(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-05-08(UTC)"],[[["This page provides an overview of the various reports available through the YouTube Reporting API, each offering different types of channel and video activity data."],["Video reports detail user engagement with a channel's videos, including views, likes, dislikes, shares, and watch time."],["Playlist reports provide insights into user interactions with channel playlists, such as playlist starts, saves, and overall viewing statistics within the playlist context."],["Several reports are structured to include geographical, playback location, traffic source, and device/OS information, allowing for a detailed breakdown of user behavior."],["Metrics such as `red_views` and `red_watch_time_minutes` have been added to newer versions of several reports to reflect more detailed information."]]],["Channel owners can retrieve various reports via the YouTube Reporting API. Video reports cover user activity statistics, including views, likes, and watch time. Playlist reports offer insights into user interactions with playlists, such as playlist starts and saves. Additional reports provide data on demographics, traffic sources, playback locations, device types, sharing platforms, annotations, cards, end screens and subtitles. Most reports have been updated in version `a2` to include `red_views` and `red_watch_time_minutes` metrics.\n"]]