Metrics

이 문서에서는 YouTube Reporting API가 가져오는 측정항목을 정의합니다. 이 API는 채널 또는 콘텐츠 소유자를 위해 YouTube 분석 데이터가 포함된 일괄 데이터 보고서를 가져옵니다.

측정항목은 사용자 활동, 광고 실적 또는 예상 수익의 개별 측정입니다. 사용자 활동 측정항목에는 동영상 조회수, 평점 (좋아요 및 싫어요) 등이 포함됩니다.

핵심 측정항목

YouTube Reporting API는 서비스 약관에 정의된 지원 중단 정책을 따르지만 비핵심 측정항목 (및 비핵심 측정기준)은 이 정책을 따르지 않습니다. 이 페이지의 정의에서 핵심 측정항목인 측정항목은 명시적으로 핵심 측정항목으로 식별됩니다.

아래 목록은 API의 핵심 측정항목을 식별합니다. YouTube Analytics API에서도 사용되는 이러한 측정항목은 해당 API의 핵심 측정항목이기도 합니다.

자세한 내용은 지원 중단 정책이 적용되는 YouTube API 목록을 참고하세요.

측정항목 보기

engaged_views (핵심 측정항목)
채널 동영상이 처음 몇 초가 지난 후에도 시청된 횟수입니다.
views (핵심 측정항목)
동영상이 시청된 횟수입니다. 재생목록 보고서에서 이 측정항목은 재생목록과 관련된 동영상이 시청된 횟수를 나타냅니다. YouTube 고객센터에서는 조회수가 보고되는 방식에 관한 추가 정보를 제공합니다. This is a core metric and is subject to the Deprecation Policy.
red_views
YouTube Premium (기존의 YouTube Red) 회원이 동영상을 시청한 횟수입니다.
views_percentage (핵심 측정항목)
동영상 또는 재생목록을 시청할 때 로그인한 시청자의 비율입니다. This is a core metric and is subject to the Deprecation Policy.

도달범위 측정항목

video_thumbnail_impressions
동영상 썸네일이 시청자에게 표시된 횟수입니다. 썸네일이 1초 이상 표시되고 화면에 썸네일의 50% 이상이 표시되어야 노출수로 집계됩니다. 자세한 내용은 YouTube 고객센터를 참고하세요.
video_thumbnail_impressions_ctr
동영상을 시청하기 위해 클릭으로 이어진 노출수의 비율입니다. 클릭수를 노출수로 나눈 값으로 계산됩니다.

시청 시간 측정항목

watch_time_minutes (핵심 측정항목)
사용자가 지정된 채널, 콘텐츠 소유자, 동영상 또는 재생목록의 동영상을 시청한 시간(분)입니다. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
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.
dislikes (핵심 측정항목)
사용자가 부정적인 평점을 남겨 동영상을 싫어함을 나타낸 횟수입니다. This is a core metric and is subject to the Deprecation Policy.
shares (핵심 측정항목)
사용자가 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 측정항목의 값도 지정하지만 다른 측정항목의 값은 지정하지 않습니다.
videos_added_to_playlists
동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상은 동영상 소유자의 재생목록 또는 다른 채널의 재생목록에 추가되었을 수 있습니다.

측정항목 값에는 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록에 동영상이 추가된 횟수가 포함됩니다. 하지만 동영상이 자동으로 추가되는 재생목록(예: 채널의 업로드 재생목록 또는 사용자의 시청 기록)은 집계되지 않습니다.

이 측정항목은 절대값을 반환합니다. 즉, 사용자가 재생목록에 동영상을 추가한 후 삭제하고 다시 추가하면 측정항목 값은 동영상이 재생목록에 두 번 추가된 것을 반영합니다. 이 측정항목의 데이터는 2014년 10월 1일 이전 날짜에는 사용할 수 없습니다.
videos_removed_from_playlists
동영상이 YouTube 재생목록에서 삭제된 횟수입니다. 동영상은 동영상 소유자의 재생목록 또는 다른 채널의 재생목록에서 삭제되었을 수 있습니다.

측정항목 값에는 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록에서 동영상이 삭제된 횟수가 포함됩니다.

이 측정항목은 절대값을 반환합니다. 즉, 사용자가 재생목록에 동영상을 추가한 후 삭제하고 다시 추가한 후 다시 삭제하면 측정항목 값은 동영상이 재생목록에서 두 번 삭제된 것을 반영합니다. 이 측정항목의 데이터는 2014년 10월 1일 이전 날짜에는 사용할 수 없습니다.

재생목록 측정항목

재생목록 보고서에는 시청자가 재생목록의 동영상 과 상호작용하는 방식을 설명하는 두 가지 유형의 측정항목이 포함되어 있습니다.

  • 집계된 동영상 측정항목은 재생목록을 소유한 채널이 소유한 재생목록의 모든 동영상에 대해 집계된 사용자 활동 및 노출 측정항목을 제공합니다. 다른 채널에서 소유한 동영상의 측정항목은 집계에서 계산되지 않습니다. 따라서 채널에서 다른 채널이 소유한 동영상만 포함된 재생목록을 만드는 경우 이러한 재생목록의 보고서에는 이러한 측정항목의 값이 제공되지 않습니다.

    지원되는 집계된 동영상 측정항목의 정의는 이 문서의 조회수 측정항목 및 시청 시간 측정항목 섹션을 참고하세요.

  • 재생목록 내 측정항목은 재생목록 페이지와 관련된 사용자 활동 및 참여도를 반영합니다. 이러한 측정항목에는 재생목록에 있는 모든 동영상의 조회수가 포함되지만, 조회수가 발생한 채널에 관계없이 재생목록 컨텍스트에서 발생한 조회수만 집계됩니다.

다음 측정항목의 대부분은 재생목록 내 측정항목입니다. 목록의 나머지 측정항목(예: playlistSaves 측정항목)은 재생목록의 동영상이 아닌 재생목록 자체와의 사용자 상호작용에 관한 것입니다. 따라서 이러한 측정항목은 집계된 동영상 측정항목 또는 재생목록 내 측정항목으로 분류되지 않습니다.

playlist_starts
시청자가 재생목록의 재생을 시작한 횟수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회수만 포함됩니다.
playlist_saves_added (YouTube Reporting API에서만 지원됨)
사용자가 재생목록을 저장한 횟수입니다. 저장된 재생목록에 관한 자세한 내용은 YouTube 고객센터를 참고하세요. 이 측정항목은 절대값을 반환합니다. 즉, 사용자가 재생목록을 저장한 후 저장된 재생목록 목록에서 삭제하고 다시 저장하면 측정항목 값은 재생목록 저장 횟수가 두 번 추가된 것을 반영합니다.
playlist_saves_removed (YouTube Reporting API에서만 지원됨)
사용자가 저장된 재생목록 목록에서 재생목록을 삭제한 횟수입니다. 이 측정항목은 절대값을 반환합니다. 즉, 사용자가 재생목록을 저장한 후 저장된 재생목록 목록에서 삭제하고 다시 저장한 후 다시 삭제하면 측정항목 값은 재생목록 저장 횟수가 두 번 삭제된 것을 반영합니다.

특수효과 측정항목

annotation_impressions
총 특수효과 노출수입니다.
annotation_clickable_impressions
표시되어 클릭할 수 있는 특수효과의 수입니다.
annotation_clicks
클릭된 특수효과의 수입니다.
annotation_click_through_rate (핵심 측정항목)
시청자가 클릭한 특수효과의 비율을 클릭 가능한 총 특수효과 노출수로 나눈 값입니다. This is a core metric and is subject to the Deprecation Policy. YouTube 고객센터에는 특수효과를 만들고 링크 특수효과를 사용하는 방법에 관한 자세한 정보가 있습니다.
annotation_closable_impressions
표시되어 닫을 수 있는 특수효과의 수입니다.
annotation_closes
닫힌 특수효과의 수입니다.
annotation_close_rate (핵심 측정항목)
시청자가 닫은 특수효과의 비율을 총 특수효과 노출수로 나눈 값입니다. This is a core metric and is subject to the Deprecation Policy.

카드 측정항목

YouTube 고객센터에는 동영상에 카드를 추가하는 방법과 YouTube 분석 카드 보고서에 관한 자세한 안내가 포함되어 있습니다.

card_impressions
카드가 표시된 횟수입니다. 카드 패널이 열리면 동영상의 각 카드에 대한 카드 노출수가 기록됩니다.
card_clicks
카드가 클릭된 횟수입니다.
card_click_rate
카드 클릭률은 카드 노출수에 대한 카드 클릭수의 비율로 계산됩니다.
card_teaser_impressions
카드 티저가 표시된 횟수입니다. 동영상 조회는 여러 티저 노출수를 생성할 수 있습니다.
card_teaser_clicks
카드 티저에서 발생한 클릭수입니다. 카드 아이콘 클릭수는 사용자에게 표시된 마지막 티저에 기여한 것으로 간주됩니다.
card_teaser_click_rate
카드 티저 클릭률은 총 카드 티저 노출수에 대한 카드 티저 클릭수의 비율로 계산됩니다.

최종 화면 측정항목

최종 화면은 동영상의 마지막 5~20초 동안 표시되어 콘텐츠, 채널, 웹사이트를 홍보하는 요소입니다. YouTube 고객센터에는 동영상에 최종 화면을 추가하는 방법과 YouTube 분석 최종 화면 보고서에 관한 자세한 안내가 포함되어 있습니다.

end_screen_element_impressions
표시된 최종 화면 요소의 수입니다. 표시되는 각 최종 화면 요소에 대해 하나의 노출수가 기록됩니다.
end_screen_element_clicks
최종 화면 요소가 클릭된 횟수입니다.
end_screen_element_click_rate
최종 화면 요소 클릭률은 최종 화면 요소 노출수에 대한 최종 화면 요소 클릭수의 비율로 계산됩니다.

멤버십 취소 측정항목

membershipsCancellationSurveyResponses
보고 기간 동안 지정된 채널의 채널 멤버십을 취소한 YouTube 사용자가 완료한 설문조사 수입니다.

예상 수익 측정항목

참고: 예상 수익 측정항목은 월말 조정을 거치며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다. 예상 수익 수치에 관한 추가 정보 및 참고사항은 YouTube 고객센터를 참고하세요.

YouTube Reporting API는 모든 예상 수익 및 수입 수치를 미국 달러로 보고합니다.
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_reserved_revenue (YouTube Reporting API에서만 지원됨)
DoubleClick (DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고에서 발생한 총 예상 수입 (순수익)입니다. 이 측정항목의 이전 이름은 estimated_partner_double_click_revenue였습니다.
estimated_partner_red_revenue (YouTube Reporting API에서만 지원됨)
YouTube Premium (기존의 YouTube Red) 구독에서 발생한 총 예상 수입 (순수익)입니다.
estimated_partner_transaction_revenue (YouTube Reporting API에서만 지원됨)
유료 콘텐츠, 팬 자금지원 등의 거래에서 발생한 총 예상 수익에서 파트너가 청구한 환불 금액을 공제한 금액입니다.

광고 실적 측정항목

estimated_youtube_ad_revenue
선택한 기간 및 지역의 모든 Google 판매 또는 DoubleClick 파트너 판매 광고에서 발생한 예상 총 수익(미국 달러)입니다. 총 수익은 월말에 조정되며 파트너 게재 광고는 포함되지 않습니다. 총 수익은 소유 지분 및 수익 공유 계약을 반영한 예상 수익 또는 순수익과 혼동해서는 안 됩니다.
estimated_cpm
1,000회 광고 노출당 예상 총 수익입니다.
ad_impressions
게재된 인증된 광고 노출수입니다.
estimated_monetized_playbacks
시청자가 동영상을 재생하고 하나 이상의 광고 노출을 기록한 횟수입니다. 시청자에게 프리롤 광고가 표시되었지만 동영상이 시작되기 전에 광고 시청을 중단한 경우 수익 창출 재생으로 집계됩니다. 이 수치의 예상 추정 오차는 ±2.0%입니다.
estimated_playback_based_cpm
1,000회 재생당 예상 총 수익입니다.