이 문서에서는 YouTube Reporting API에서 가져오는 측정항목을 정의합니다. 이 API는 채널 또는 콘텐츠 소유자의 YouTube 분석 데이터가 포함된 일괄 데이터 보고서를 검색합니다.
측정항목은 사용자 활동, 광고 실적 또는 예상 수익을 개별적으로 측정한 것입니다. 사용자 활동 측정항목에는 동영상 조회수 및 평점 (좋아요 및 싫어요) 등이 포함됩니다.
핵심 측정항목
YouTube Reporting API에는 서비스 약관에 정의된 지원 중단 정책이 적용되지만 핵심이 아닌 측정항목 (및 비핵심 측정기준)에는 정책이 적용되지 않습니다. 이 페이지의 정의에서는 핵심 측정항목인 모든 측정항목이 명확하게 식별됩니다.
아래 목록은 API의 핵심 측정항목을 나타냅니다. YouTube 분석 API에서도 사용되는 이러한 측정항목은 API의 핵심 측정항목이기도 합니다.
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
자세한 내용은 지원 중단 정책이 적용되는 YouTube API 목록을 참고하세요.
측정항목 보기
- 조회수(핵심 측정항목)
- 동영상이 조회된 횟수입니다. 재생목록 보고서에서 측정항목은 재생목록과 관련하여 동영상이 조회된 횟수를 나타냅니다. YouTube 고객센터에서 조회수 보고 방식에 대한 추가 정보를 확인할 수 있습니다. This is a core metric and is subject to the Deprecation Policy.
- 빨간색 조회
- YouTube Premium (이전 명칭: YouTube Red) 회원이 동영상을 시청한 횟수입니다.
- views_percentage(핵심 측정항목)
- 동영상 또는 재생목록을 시청할 때 로그인한 시청자의 비율입니다. This is a core metric and is subject to the Deprecation Policy.
시청 시간 측정항목
- watch_time_minutes(핵심 측정항목)
- 사용자가 지정된 채널, 콘텐츠 소유자, 동영상 또는 재생목록의 동영상을 시청한 시간(분)입니다. This is a core metric and is subject to the Deprecation Policy.
- 빨간색_시계_시간_분
- YouTube Premium(이전 명칭: YouTube Red) 회원이 동영상을 시청한 시간(분)
- average_view_duration_seconds(핵심 측정항목)
- 동영상 재생의 평균 길이(초)입니다. 2021년 12월 13일부터 이 측정항목에는 루프 클립 트래픽이 제외됩니다. 재생목록 보고서에서 측정항목은 재생목록의 컨텍스트에서 발생한 동영상 재생의 평균 길이(초)를 나타냅니다. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- 동영상 재생 중에 동영상을 시청한 평균 비율입니다. 2021년 12월 13일부터 이 측정항목에는 루프 클립 트래픽이 제외됩니다.
참여도 측정항목
- 댓글(핵심 측정항목)
- 사용자가 동영상에 댓글을 단 횟수입니다. 자세한 내용은 YouTube 고객센터를 참고하세요. This is a core metric and is subject to the Deprecation Policy.
- 좋아요(핵심 측정항목)
- 사용자가 동영상을 좋아한다고 평가한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.
- 싫어요(핵심 측정항목)
- 사용자가 동영상에 싫어요 표시를 하여 싫어요를 표시한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.
- 사용자가
Share
버튼을 통해 동영상을 공유한 횟수입니다. 자세한 내용은 YouTube 고객센터를 참고하세요. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained(핵심 측정항목)
- 사용자가 채널을 구독한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.
채널은 동영상 보기 페이지, 채널 페이지, YouTube 홈페이지에 표시되는 가이드 등 다양한 위치에서 구독자를 모으거나 잃을 수 있습니다. 동영상 보기 페이지를 통해 구독하지 않은 새로운 채널 구독자 수를 확인하기 위해 기본 사용자 활동 보고서에는 video_id 측정기준 값을 지정하지 않는 행이 포함되어 있습니다. 이 행은subscribersLost
측정항목의 값도 지정하지만 다른 측정항목의 값은 지정하지 않습니다. - subscribers_lost(핵심 측정항목)
- 사용자가 채널을 구독 취소한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.
이 측정항목의 데이터는subscribers_gained
측정항목과 유사하게 보고됩니다. 구독을 취소했지만 동영상 보기 페이지에서 구독을 취소하지 않은 사용자 수를 파악하기 위해 기본 사용자 활동 보고서에는 video_id 측정기준 값을 지정하지 않는 행이 포함되어 있습니다. 이 행은subscribers_gained
측정항목의 값도 지정하지만 다른 측정항목의 값은 지정하지 않습니다. - 동영상_추가_재생목록에 추가
- 동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에 추가되었을 수 있습니다.
측정항목 값에는 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록에 동영상이 추가된 횟수가 포함됩니다. 하지만 동영상의 업로드 재생목록이나 사용자의 시청 기록과 같이 동영상이 자동으로 추가되는 재생목록은 포함되지 않습니다.
이 측정항목은 절댓값을 반환합니다. 즉, 사용자가 재생목록에 동영상을 추가했다가 삭제한 다음 다시 추가하면 동영상이 재생목록에 두 번 반영되는 것을 의미합니다. 이 측정항목의 데이터는 2014년 10월 1일 이후부터 제공됩니다. - 동영상_삭제됨_재생목록
- YouTube 재생목록에서 동영상이 삭제된 횟수입니다. 동영상 소유자의 재생목록 또는 다른 채널의 재생목록에서 동영상이 삭제된 것일 수 있습니다.
측정항목 값에는 '나중에 볼 동영상' 재생목록과 같이 기본 재생목록에서 동영상이 삭제된 횟수가 포함됩니다.
이 측정항목은 사용자가 재생목록에 동영상을 추가했다가 삭제한 후 다시 삭제할 경우 재생목록에서 동영상이 두 번 삭제되었음을 나타내는 절대적인 수치를 표시합니다. 이 측정항목의 데이터는 2014년 10월 1일 이후부터 제공됩니다.
재생목록 측정항목
- 재생목록 시작
- 시청자가 재생목록 재생을 시작한 횟수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회수만 포함됩니다.
- playlist_saves_added(YouTube Reporting API에서만 지원됨)
- 사용자가 재생목록을 저장한 횟수입니다. 저장된 재생목록에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요. 이 측정항목은 절대값을 반환합니다. 즉, 사용자가 재생목록을 저장하고 저장된 재생목록 목록에서 삭제한 후 다시 저장하면 측정항목 값에 추가된 재생목록 두 개가 반영됩니다.
- playlist_saves_deleted(YouTube Reporting API에서만 지원됨)
- 사용자가 저장한 재생목록 목록에서 재생목록을 삭제한 횟수입니다. 이 측정항목은 절댓값을 반환합니다. 즉, 사용자가 재생목록을 저장하고 저장된 재생목록 목록에서 삭제한 후 다시 저장한 후 다시 삭제하면 삭제된 재생목록 두 개가 측정항목 값에 반영됩니다.
특수효과 측정항목
- 주석_노출수
- 총 주석 노출수입니다.
- 주석_클릭 가능_노출
- 표시되어 클릭 가능한 주석의 수입니다.
- 주석_클릭
- 클릭한 주석의 수입니다.
- annotation_click_through_rate(핵심 측정항목)
- 클릭 가능한 특수효과의 총 노출수 대비 시청자가 클릭한 특수효과의 비율입니다. This is a core metric and is subject to the Deprecation Policy. YouTube 고객센터에서 특수효과 만들기 및 링크 특수효과 사용에 대해 자세히 알아보세요.
- annotation_closable_impressions
- 표시되고 닫을 수 있는 주석 수입니다.
- 주석_닫기
- 닫힌 주석의 수입니다.
- annotation_close_rate(핵심 측정항목)
- 총 특수효과 노출수에 대한 시청자가 닫은 특수효과의 비율입니다. This is a core metric and is subject to the Deprecation Policy.
카드 측정항목
동영상에 카드를 추가하고 YouTube 분석 카드 보고서를 참조하세요.
- card_impressions
- 카드가 표시된 횟수입니다. 카드 패널을 열면 동영상의 각 카드에 대한 카드 노출수가 기록됩니다.
- card_clicks
- 카드를 클릭한 횟수입니다.
- card_click_rate
- 카드 클릭률입니다. 카드 클릭수에 대한 카드 클릭수의 비율로 계산됩니다.
- 카드 티저가 표시된 횟수입니다. 동영상 조회 1회당 티저 노출수가 여러 번 발생할 수 있습니다.
- 카드 티저가 클릭된 횟수입니다. 카드 아이콘 클릭수는 사용자에게 마지막으로 표시된 티저에 표시됩니다.
- 카드 티저의 클릭률로, 카드 티저의 총 노출수에 대한 카드 티저의 클릭수의 비율로 계산됩니다.
최종 화면 측정항목
최종 화면은 콘텐츠, 채널, 웹사이트를 홍보하기 위해 동영상의 마지막 5~20초 동안 표시되는 요소입니다. YouTube 고객센터에서 동영상에 최종 화면을 추가하는 방법과 YouTube 분석 최종 화면 보고서를 확인하는 방법을 자세히 알아보세요.
참고: 최종 화면 측정항목의 데이터는 2016년 5월 1일부터 사용할 수 있습니다.
- end_screen_element_impressions
- 표시된 최종 화면 요소의 수입니다. 표시되는 최종 화면 요소마다 1회의 노출이 기록됩니다.
- end_screen_element_clicks
- 최종 화면 요소가 클릭된 횟수입니다.
- end_screen_element_click_rate
- 최종 화면 요소 클릭률입니다. 최종 화면 요소 노출수 대비 최종 화면 요소 클릭수의 비율로 계산됩니다.
시청 지속 시간 측정항목
- audience_retention_percentage
- 동영상의 특정 지점에서 동영상을 시청한 사용자의 절대 비율입니다. 이 비율은 동영상의 한 부분을 시청한 횟수를 총 조회수와 비교하여 계산합니다.
elapsed_video_time_percentage
측정기준은 동영상에서 측정항목이 해당하는 부분을 식별합니다.
특정 동영상 조회가 발생할 경우 한 부분이 2회 이상 조회되거나 전혀 시청되지 않을 수 있습니다. 예를 들어 사용자가 동영상의 같은 부분을 여러 번 되감고 시청하는 경우 동영상에서 이 부분의 절대 비율이1
보다 클 수 있습니다.
다음 예는 값이 계산되는 방식을 보여줍니다.- 1분 길이의 동영상을 100회 시청합니다. 시청자의 절반은 15초 후에 시청을 중단하고 나머지는 전체 동영상을 시청합니다. 동영상의 어떤 부분도 두 번 이상 시청하지 않습니다. 이 경우 동영상의 1사분기에 있는 시간 버킷의 경우 이 측정항목의 값은
1
이고 나머지 동영상의 값은0.50
입니다. - 1분 길이의 동영상을 100회 시청합니다. 모든 시청자가 전체 동영상을 시청하지만 20명이 동영상의 45초 지점까지 시청하고 동영상의 30초 지점으로 건너뛴 다음 동영상의 나머지 부분도 시청합니다. 이 경우 동영상의 전반부 또는 후반기의 시간 버킷에 대한 측정항목 값은
1
입니다. 하지만 동영상의 3/4에 해당하는 시간 버킷에 대한 값은1.2
입니다. 시청자의 100%가 해당 동영상 세그먼트를 시청했지만 전체 시청자의 20%가 해당 세그먼트를 두 번 시청했기 때문입니다.
- 1분 길이의 동영상을 100회 시청합니다. 시청자의 절반은 15초 후에 시청을 중단하고 나머지는 전체 동영상을 시청합니다. 동영상의 어떤 부분도 두 번 이상 시청하지 않습니다. 이 경우 동영상의 1사분기에 있는 시간 버킷의 경우 이 측정항목의 값은
예상 수익 측정항목
참고: 예상 수익 측정항목은 월말에 조정되며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다. 예상 수익 수치에 대한 추가 정보 및 참고사항은 YouTube 고객센터에서 확인하세요.
- estimated_partner_revenue(핵심 측정항목)
- 선택한 기간 및 지역에 대해 모든 Google 판매 광고 소스 및 광고 이외의 소스에서 발생한 총 예상 순수익입니다.
- estimated_partner_ad_revenue
- 선택한 기간 및 지역의 모든 Google 판매 광고 소스에서 발생한 예상 총 순수익입니다.
예상 수익 측정항목은 월말에 조정되며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다. - estimated_partner_ad_auction_revenue(YouTube Reporting API에서만 지원)
- 선택한 기간 및 지역에서 애드센스를 통한 입찰 판매 광고의 총 예상 수익 (순수익)입니다. 이 측정항목의 이전 이름은
estimated_partner_ad_sense_revenue
였습니다. - estimated_partner_ad_sense_revenue(YouTube Reporting API에서만 지원)
- 선택한 기간 및 지역의 입찰 판매 애드센스 광고에서 발생한 총 예상 수익 (순수익)입니다.
- estimated_partner_ad_Scheduled_revenue(YouTube Reporting API에서만 지원)
- DoubleClick (DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고로 발생한 총 예상 수익 (순수익)입니다. 이 측정항목의 이전 이름은
estimated_partner_double_click_revenue
였습니다. - estimated_partner_double_click_revenue(YouTube Reporting API에서만 지원)
- DoubleClick (DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고의 총 예상 수익 (순수익)입니다.
- estimated_partner_red_revenue(YouTube Reporting API에서만 지원)
- YouTube Premium (이전 명칭: YouTube Red) 구독의 총 예상 수입 (순수익)입니다.
- estimated_partner_transaction_revenue(YouTube Reporting API에서만 지원)
- 유료 콘텐츠, 팬 자금지원 등의 거래에서 발생한 총 예상 수익에서 파트너가 청구한 환불 금액을 차감한 금액입니다.
광고 실적 측정항목
- estimated_youtube_ad_revenue
- 선택한 기간 및 지역의 모든 Google 판매 또는 DoubleClick 파트너 판매 광고에서 발생한 예상 총 수익(USD)입니다. 총 수익은 월말에 조정되며 파트너 게재 광고는 포함되지 않습니다. 총 수익을 소유 지분과 수익 공유 협정을 고려하는 순수익 또는 예상 수익과 혼동해서는 안 됩니다.
- 예상_CPM
- 1,000회 광고 노출당 총 수입 추정액입니다.
- ad_impressions
- 게재된 확인된 광고 노출수입니다.
- estimated_monetized_playbacks
- 시청자가 내 동영상을 재생하고 하나 이상의 광고 노출을 기록한 횟수입니다. 시청자가 프리롤 광고를 봤지만 동영상이 시작되기 전에 광고 시청을 중단하면 수익 창출 재생으로 집계됩니다. 이 수치의 예상 추정 오차는 ±2.0%입니다.
- 추정_재생_기반_CPM
- 재생 1,000회당 예상 총 수익입니다.