Metrics

이 문서에서는 YouTube Analytics API를 사용하여 검색할 수 있는 측정항목을 정의합니다. 이 API는 실시간 쿼리를 지원하여 맞춤 YouTube 분석 보고서를 생성합니다.

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

핵심 측정항목

YouTube Analytics API에는 서비스 약관에 정의된 지원 중단 정책이 적용되지만 핵심이 아닌 측정항목 (및 비핵심 측정기준)에는 이 정책이 적용되지 않습니다. 이 페이지의 정의에서는 핵심 측정항목인 모든 측정항목이 명확하게 식별됩니다.

아래 목록은 API의 핵심 측정항목을 나타냅니다.

참고: 다음 핵심 측정항목은 완전히 지원 중단되었습니다.
  • earnings 핵심 측정항목은 2016년 8월 4일에 지원 중단되었으며 estimatedRevenue로 이름이 변경되었습니다. 서비스 약관에 정의된 지원 중단 정책에 따라 2017년 8월 10일까지 earningsestimatedRevenue 측정항목이 동시에 지원되었습니다.
  • favoritesAddedfavoritesRemoved 핵심 측정항목은 2015년 3월 31일에 지원 중단되었습니다. 이러한 측정항목은 YouTube Analytics API를 통해서만 검색할 수 있습니다.

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

측정항목 보기

조회수(핵심 측정항목)
동영상이 조회된 횟수입니다. 재생목록 보고서에서 측정항목은 재생목록과 관련하여 동영상이 조회된 횟수를 나타냅니다. YouTube 고객센터에서 조회수 보고 방식에 대한 추가 정보를 확인할 수 있습니다. This is a core metric and is subject to the Deprecation Policy.
빨간색 보기
YouTube Premium (이전 명칭: YouTube Red) 회원이 동영상을 시청한 횟수입니다.
순 집계 (2016년 9월 27일 지원 중단됨)
동영상을 시청한 순 시청자 수입니다. 이 계산은 고유 쿠키 수를 기반으로 하기 때문에 여러 기기 또는 브라우저를 사용하는 사용자를 실제보다 많이 집계합니다.
uniques 측정항목은 2016년 9월 27일에 지원 중단되었습니다. 핵심 측정항목은 아니며 2016년 10월 31일까지 지원됩니다.
viewerPercentage(핵심 측정항목)
동영상 또는 재생목록을 시청할 때 로그인한 시청자의 비율입니다. This is a core metric and is subject to the Deprecation Policy.

시청 시간 측정항목

estimatedMinutesWatched(핵심 측정항목)
사용자가 지정된 채널, 콘텐츠 소유자, 동영상 또는 재생목록의 동영상을 시청한 시간(분)입니다. This is a core metric and is subject to the Deprecation Policy.
예상되는 RedMinutesWatched
YouTube Premium(이전 명칭: YouTube Red) 회원이 동영상을 시청한 시간(분)
averageViewDuration(핵심 측정항목)
동영상 재생의 평균 길이(초)입니다. 2021년 12월 13일부터 이 측정항목에는 루프 클립 트래픽이 제외됩니다. 재생목록 보고서에서 측정항목은 재생목록의 컨텍스트에서 발생한 동영상 재생의 평균 길이(초)를 나타냅니다. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
동영상 재생 중에 동영상을 시청한 평균 비율입니다. 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획득ed(핵심 측정항목)
사용자가 채널을 구독한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.

채널은 동영상 보기 페이지, 채널 페이지, YouTube 홈페이지에 표시되는 가이드 등 다양한 위치에서 구독자를 모으거나 잃을 수 있습니다. 채널 보고서에서 이 측정항목은 이러한 모든 위치에서 획득한 구독자를 포함합니다. 하지만 video 측정기준 또는 filter 매개변수를 사용하여 특정 동영상의 데이터만 포함하도록 응답을 제한하는 보고서에서 subscribersGained 측정항목에는 지정된 동영상의 보기 페이지에 관한 통계만 포함됩니다.
subscribersLost(핵심 측정항목)
사용자가 채널을 구독 취소한 횟수입니다. This is a core metric and is subject to the Deprecation Policy.

이 측정항목의 데이터는 subscribersGained 측정항목과 유사하게 보고됩니다. 채널 보고서에서 이 측정항목은 사용자가 채널 구독을 취소할 수 있는 모든 방법을 통해 이탈한 구독자를 포함합니다. 하지만 특정 측정기준의 데이터만 포함하도록 video 측정기준 또는 filter 매개변수를 사용하여 응답을 제한하는 보고서에서 이 측정항목은 지정된 동영상의 보기 페이지에서 구독을 취소한 사용자만 포함합니다.
동영상에 추가할 동영상
동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에 추가되었을 수 있습니다.

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

이 측정항목은 절댓값을 반환합니다. 즉, 사용자가 재생목록에 동영상을 추가했다가 삭제한 다음 다시 추가하면 동영상이 재생목록에 두 번 반영되는 것을 의미합니다. 이 측정항목의 데이터는 2014년 10월 1일 이후부터 제공됩니다.
동영상 삭제:재생목록
YouTube 재생목록에서 동영상이 삭제된 횟수입니다. 동영상 소유자의 재생목록 또는 다른 채널의 재생목록에서 동영상이 삭제된 것일 수 있습니다.

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

이 측정항목은 사용자가 재생목록에 동영상을 추가했다가 삭제한 후 다시 삭제할 경우 재생목록에서 동영상이 두 번 삭제되었음을 나타내는 절대적인 수치를 표시합니다. 이 측정항목의 데이터는 2014년 10월 1일 이후부터 제공됩니다.

지원 중단된 참여도 측정항목

다음 측정항목은 2015년 3월 31일에 지원 중단된 핵심 측정항목입니다.

즐겨찾기 추가(핵심 측정항목)(2015년 3월 31일 지원 중단됨)
사용자가 동영상을 즐겨찾는 동영상으로 표시한 횟수입니다. 자세한 내용은 YouTube 고객센터를 참고하세요. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved(핵심 측정항목)(2015년 3월 31일 지원 중단됨)
사용자가 즐겨찾는 동영상 목록에서 동영상을 삭제한 횟수입니다. 자세한 내용은 YouTube 고객센터를 참고하세요. This is a core metric and is subject to the Deprecation Policy.

재생목록 측정항목

재생목록 시작
시청자가 재생목록 재생을 시작한 횟수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회수만 포함됩니다.
조회수 재생 목록 시작
재생목록이 시작될 때마다 발생한 평균 동영상 조회수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회수만 포함됩니다.
평균시 재생목록
재생목록이 시작된 후 시청자가 재생목록의 동영상을 시청한 추정 시간(분)입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회수만 포함됩니다.

특수효과 측정항목

참고: YouTube Analytics API 보고서는 2012년 6월 10일 기준으로 annotationClickThroughRateannotationCloseRate 측정항목의 데이터만 반환합니다. 또한 YouTube Analytics API 보고서는 2013년 7월 16일 현재 나머지 특수효과 측정항목에 대한 데이터만 반환합니다.

주석 노출수
총 주석 노출수입니다.
주석 클릭 가능 노출
표시되어 클릭 가능한 주석의 수입니다.
annotationClicks
클릭한 주석의 수입니다.
annotationClickThroughRate(핵심 측정항목)
클릭 가능한 특수효과의 총 노출수 대비 시청자가 클릭한 특수효과의 비율입니다. This is a core metric and is subject to the Deprecation Policy. YouTube 고객센터에서 특수효과 만들기링크 특수효과 사용에 대해 자세히 알아보세요.
annotationClosableImpression
표시되고 닫을 수 있는 주석 수입니다.
주석 닫기
닫힌 주석의 수입니다.
annotationCloseRate(핵심 측정항목)
총 특수효과 노출수에 대한 시청자가 닫은 특수효과의 비율입니다. This is a core metric and is subject to the Deprecation Policy.

카드 측정항목

동영상에 카드를 추가하고 YouTube 분석 카드 보고서를 참조하세요.

카드 노출수
카드가 표시된 횟수입니다. 카드 패널을 열면 동영상의 각 카드에 대한 카드 노출수가 기록됩니다.
cardClicks
카드를 클릭한 횟수입니다.
cardClickRate
카드 클릭률입니다. 카드 클릭수에 대한 카드 클릭수의 비율로 계산됩니다.
cardTeaserImpression
카드 티저가 표시된 횟수입니다. 동영상 조회 1회당 티저 노출수가 여러 번 발생할 수 있습니다.
cardTeaserClicks
카드 티저가 클릭된 횟수입니다. 카드 아이콘 클릭수는 사용자에게 마지막으로 표시된 티저에 표시됩니다.
cardTeaserClickRate
카드 티저의 클릭률로, 카드 티저의 총 노출수에 대한 카드 티저의 클릭수의 비율로 계산됩니다.

시청 지속 시간 측정항목

audienceWatchRatio
동영상의 특정 지점에서 동영상을 시청한 사용자의 절대 비율입니다. 이 비율은 동영상의 한 부분을 시청한 횟수를 총 조회수와 비교하여 계산합니다. elapsedVideoTimeRatio 측정기준은 동영상에서 측정항목이 해당하는 부분을 식별합니다.

특정 동영상 조회가 발생할 경우 한 부분이 2회 이상 조회되거나 전혀 시청되지 않을 수 있습니다. 예를 들어 사용자가 동영상의 같은 부분을 여러 번 되감고 시청하는 경우 동영상에서 이 부분의 절대 비율이 1보다 클 수 있습니다.

다음 예는 값이 계산되는 방식을 보여줍니다.
  • 1분 길이의 동영상을 100회 시청합니다. 시청자의 절반은 15초 후에 시청을 중단하고 나머지는 전체 동영상을 시청합니다. 동영상의 어떤 부분도 두 번 이상 시청하지 않습니다. 이 경우 동영상의 1사분기에 있는 시간 버킷의 경우 이 측정항목의 값은 1이고 나머지 동영상의 값은 0.50입니다.
  • 1분 길이의 동영상을 100회 시청합니다. 모든 시청자가 전체 동영상을 시청하지만 20명이 동영상의 45초 지점까지 시청하고 동영상의 30초 지점으로 건너뛴 다음 동영상의 나머지 부분도 시청합니다. 이 경우 동영상의 전반부 또는 후반기의 시간 버킷에 대한 측정항목 값은 1입니다. 하지만 동영상의 3/4에 해당하는 시간 버킷에 대한 값은 1.2입니다. 시청자의 100%가 해당 동영상 세그먼트를 시청했지만 전체 시청자의 20%가 해당 세그먼트를 두 번 시청했기 때문입니다.
상대적 보관 성과
재생하는 동안 길이가 비슷한 모든 YouTube 동영상과 비교하여 동영상이 얼마나 효과적으로 시청자를 유지하는지 보여주는 측정항목입니다. 측정항목의 0~1 값은 동영상의 특정 지점에서 동영상의 상대적인 보관 실적을 나타냅니다. 동영상의 지점은 elapsedVideoTimeRatio 측정기준을 통해 제공됩니다.

0은 동영상이 비슷한 길이의 다른 동영상보다 시청자 유지율이 낮음을 의미하고, 1 값은 동영상이 비슷한 길이의 다른 동영상보다 시청자 보유율이 높음을 나타냅니다. 중앙값 0.5을 사용하면 비슷한 길이의 동영상 중 절반이 시청자 유지율이 더 우수하고 절반은 시청자 유지율이 낮음을 나타냅니다.

다음 가상의 예는 보고서에 값이 표시되는 방식을 보여줍니다. 평균적으로 10분 길이의 동영상을 시청하는 시청자 중 90%는 3분 후에도 계속 시청하고 70%는 8분 후에도 계속 시청하고 있습니다. 하지만 10분 길이의 특정 동영상에서는 3분 후에도 80%의 시청자만 시청을 하지만 모든 시청자가 8분 후에도 계속 시청 중입니다.
  • 동영상의 3분 지점에 해당하는 elapsedVideoTimeRatio 값에서 relativeRetentionPerformance 측정항목의 값은 0.5 미만입니다. 이 시점에서는 동영상 실적이 평균 동영상보다 저조하기 때문입니다.
  • 동영상의 8분 지점에 해당하는 elapsedVideoTimeRatio 값에서 relativeRetentionPerformance 측정항목의 값은 0.5보다 큽니다. 이 시점에서는 동영상이 비슷한 길이의 다른 동영상보다 실적이 우수하기 때문입니다.

예상 수익 측정항목

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

기본적으로 모든 예상 수익 금액은 미국 달러(USD)로 보고됩니다. 하지만 YouTube 분석 API는 일부 예상 수익 및 광고 실적 측정항목에 currency 매개변수를 사용하므로 다른 통화로 예상 수익 데이터를 가져올 수 있습니다.
estimatedRevenue(핵심 측정항목)(이전 이름: earnings)
선택한 기간 및 지역에 대해 모든 Google 판매 광고 소스 및 광고 이외의 소스에서 발생한 총 예상 순수익입니다. This is a core metric and is subject to the Deprecation Policy.

예상 수익 측정항목은 월말에 조정되며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다.
estimatedAdRevenue(이전 명칭: adEarnings)
선택한 기간 및 지역의 모든 Google 판매 광고 소스에서 발생한 예상 총 순수익입니다.

예상 수익 측정항목은 월말에 조정되며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다.
estimatedRedPartnerRevenue(이전 이름: redPartnerRevenue)
선택한 보고서 측정기준에 대해 YouTube Premium (이전 명칭: YouTube Red) 구독에서 발생한 총 예상 수익입니다. 측정항목의 값은 음악 및 음악 외 콘텐츠의 수익을 반영하며 월말에 조정됩니다.

광고 실적 측정항목

총수익
선택한 기간 및 지역의 모든 Google 판매 또는 DoubleClick 파트너 판매 광고에서 발생한 예상 총 수익(USD)입니다. 총 수익은 월말에 조정되며 파트너 게재 광고는 포함되지 않습니다. 총 수익을 소유 지분과 수익 공유 협정을 고려하는 순수익 또는 예상 수익과 혼동해서는 안 됩니다.
cpm(이전 명칭: impressionBasedCpm)
1,000회 광고 노출당 총 수입 추정액입니다.
adImpressions(이전 명칭: impressions)
게재된 확인된 광고 노출수입니다.
monetizedPlaybacks
시청자가 내 동영상을 재생하고 하나 이상의 광고 노출을 기록한 횟수입니다. 시청자가 프리롤 광고를 봤지만 동영상이 시작되기 전에 광고 시청을 중단하면 수익 창출 재생으로 집계됩니다. 이 수치의 예상 추정 오차는 ±2.0%입니다.
재생 기반 CPM
재생 1,000회당 예상 총 수익입니다.