Metrics

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

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

핵심 측정항목

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

아래 목록에는 API의 핵심 측정항목이 나와 있습니다.

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

측정항목 보기

조회수 (핵심 측정항목)
이 측정항목은 보고서 유형에 따라 다른 숫자를 나타냅니다.
  • 동영상 보고서에서 이 측정항목은 동영상이 조회된 횟수를 나타냅니다.
  • isCurated 측정기준을 사용하지 않는 재생목록 보고서에서 이 측정항목은 재생목록 맥락에서 발생했는지와 관계없이 재생목록의 동영상 총 조회수를 지정합니다. 측정항목 값에는 채널 소유자의 동영상 조회수만 포함됩니다.

    이 보고서에서 playlistViews 측정항목은 특정 재생목록의 맥락에서 재생목록 동영상이 조회된 횟수를 나타냅니다.
  • isCurated 측정기준을 사용하는 재생목록 보고서에서 이 측정항목은 특정 재생목록 맥락에서 동영상이 조회된 횟수를 나타냅니다. 이러한 보고서에는 playlistViews 측정항목이 지원되지 않습니다.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
이 측정항목은 재생목록 측정항목 섹션에 정의되어 있습니다.
redViews
YouTube Premium (이전 명칭: YouTube Red) 회원이 동영상을 시청한 횟수입니다.
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.
estimatedRedMinutesWatched
YouTube Premium (이전 명칭: YouTube Red) 회원이 동영상을 시청한 분입니다.
averageViewDuration (핵심 측정항목)
동영상 재생의 평균 길이(초)입니다. 2021년 12월 13일부터 이 측정항목에서 반복 재생 클립 트래픽이 제외됩니다. 재생목록 보고서에서 이 측정항목은 재생목록 맥락에서 발생한 동영상 재생의 평균 길이(초)를 나타냅니다. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
동영상 재생 중에 시청한 동영상의 평균 비율입니다. 2021년 12월 13일부터 이 측정항목에서 반복 재생 클립 트래픽이 제외됩니다.

참여도 측정항목

comments (핵심 측정항목)
사용자가 동영상에 댓글을 단 횟수입니다. 자세한 내용은 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.
shares (핵심 측정항목)
사용자가 Share 버튼을 통해 동영상을 공유한 횟수입니다. 자세한 내용은 YouTube 고객센터를 참고하세요. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (핵심 측정항목)
사용자가 채널을 구독한 횟수입니다. 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 매개변수를 사용하여 특정 동영상의 데이터만 포함하도록 응답을 제한하는 보고서에서는 이 측정항목에 지정된 동영상의 보기 페이지에서 구독을 취소한 사용자만 포함됩니다.
videosAddedToPlaylists
동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상이 동영상 소유자의 재생목록 또는 다른 채널의 재생목록에 추가되었을 수 있습니다.

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

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

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

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

재생목록 측정항목

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

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

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

  • 재생목록 내 측정항목은 재생목록 페이지의 맥락에서 사용자 활동 및 참여도를 반영합니다. 이 측정항목에는 소유한 채널과 관계없이 재생목록의 모든 동영상 조회수가 포함되지만 재생목록 맥락에서 발생한 조회수만 집계됩니다.

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

averageTimeInPlaylist
재생목록이 시작된 후 시청자가 재생목록의 동영상을 시청한 것으로 추정되는 평균 시간(분)입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회만 포함됩니다.
playlistAverageViewDuration
재생목록 조회당 예상되는 평균 시청 시간(초)입니다. 이 측정항목은 재생목록 내 개별 동영상의 평균 조회 시간을 나타냅니다. 반면 averageTimeInPlaylist 측정항목은 각 시청자가 재생목록 전체를 시청하는 데 소비하는 평균 시간을 나타냅니다. 이 측정항목에는 다른 채널에서 소유한 재생목록 동영상의 데이터가 포함됩니다.
playlistEstimatedMinutesWatched
사용자가 재생목록의 일부로 재생목록 콘텐츠를 시청한 시간(분)입니다. 다른 맥락에서 발생한 시청 시간(예: 시청자가 다른 재생목록의 일부로 동일한 동영상을 시청할 때 발생한 조회수의 시청 시간)은 집계되지 않습니다. 이 측정항목에는 다른 채널에서 소유한 재생목록 동영상의 데이터가 포함됩니다.
playlistSaves
사용자가 재생목록을 저장한 순 횟수입니다. 저장된 재생목록에 관한 자세한 내용은 YouTube 고객센터를 참고하세요. 이 측정항목은 순 변경 수를 반환합니다. 즉, 사용자가 재생목록을 저장하고 저장된 재생목록 목록에서 삭제한 후 다시 저장하면 측정항목 값에 재생목록 저장 1개가 추가된 것으로 반영됩니다.
playlistStarts
시청자가 재생목록의 재생을 시작한 횟수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회만 포함됩니다.
playlistViews
재생목록의 동영상이 재생목록의 맥락에서 시청된 횟수입니다. 이 측정항목에는 다른 채널에서 소유한 재생목록 동영상의 데이터가 포함됩니다.
viewsPerPlaylistStart
재생목록이 시작될 때마다 발생한 평균 동영상 조회수입니다. 이 측정항목에는 웹에서 발생한 재생목록 조회만 포함됩니다.

특수효과 측정항목

참고: YouTube 분석 API 보고서는 2012년 6월 10일부터 annotationClickThroughRate 및 annotationCloseRate 측정항목에 대한 데이터만 반환합니다. 또한 YouTube 분석 API 보고서는 2013년 7월 16일 현재 나머지 주석 측정항목의 데이터만 반환합니다.

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

카드 측정항목

YouTube 고객센터에서 동영상에 카드 추가 및 YouTube 분석 카드 보고서에 관한 자세한 안내를 확인하세요.

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

라이브 스트림 측정항목 (동시 시청자 수)

averageConcurrentViewers
특정 동영상의 평균 동시 시청자 수입니다. 보고서에 livestreamPosition 측정기준이 지정된 경우 averageConcurrentViewers 값은 특정 세그먼트의 평균 동시 시청자 수를 지정합니다.
peakConcurrentViewers
특정 동영상의 최대 동시 시청자 수입니다. 보고서에 livestreamPosition 측정기준이 지정된 경우 peakConcurrentViewers 값은 동영상의 특정 세그먼트 동안 최대 동시 시청자 수를 지정합니다.

시청 지속 시간 측정항목

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

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

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

값이 0이면 동영상의 시청 지속 시간이 비슷한 길이의 다른 동영상보다 낮음을 나타내고, 값이 1이면 동영상의 시청 지속 시간이 비슷한 길이의 다른 동영상보다 높음을 나타냅니다. 중앙값이 0.5인 경우 비슷한 길이의 동영상 중 절반은 시청자를 더 잘 유지하고 절반은 시청자를 더 나쁘게 유지한다는 의미입니다.

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

예를 들어 동영상 X의 길이가 5분이라고 가정해 보겠습니다. 이 보고서의 목적을 위해 YouTube는 동영상을 3초 길이의 세그먼트 100개로 나누고 이를 elapsedVideoTimeRatio 측정기준으로 식별합니다. 시청자가 YouTube를 방문하여 동영상의 처음 1분 10초(동영상의 처음 24개 세그먼트의 전부 또는 일부 포함)를 시청합니다. 이후 YouTube를 방문한 시청자는 동영상의 나머지 부분을 시청하면서 세그먼트 24에서 재생을 재개하고 세그먼트 100까지 계속 시청합니다.

이 예에서는 다음과 같은 보기 측정항목 값이 생성됩니다.
  • startedWatching 측정항목의 값은 세그먼트 1과 24의 경우 1이고 다른 모든 세그먼트의 경우 0입니다.
  • stoppedWatching 측정항목의 값은 세그먼트 24 및 100의 경우 1이고 다른 모든 세그먼트의 경우 0입니다.
  • totalSegmentImpressions 측정항목의 값은 세그먼트 24의 경우 2이고 다른 모든 세그먼트의 경우 1입니다.
stoppedWatching
동영상 재생 중에 동영상의 특정 세그먼트가 마지막으로 표시된 횟수입니다. 이 측정항목 값이 계산되는 방식의 예는 startedWatching 측정항목의 정의를 참고하세요.
totalSegmentImpressions
동영상의 특정 세그먼트가 시청된 횟수입니다. 이 측정항목 값이 계산되는 방식의 예는 startedWatching 측정항목의 정의에서 확인하세요. 시청자가 동일한 재생에서 동영상의 동일한 세그먼트를 여러 번 시청할 수 있습니다.

멤버십 취소 측정항목

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

예상 수익 측정항목

참고: 예상 수익 측정항목은 월말에 조정되며 파트너 판매 및 파트너 게재 광고는 포함되지 않습니다. 예상 수익 수치에 대한 자세한 내용과 메모는 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) 구독에서 발생한 총 예상 수익입니다. 이 측정항목의 값은 음악 및 음악 외 콘텐츠의 수익을 모두 반영하며 월말에 조정될 수 있습니다.

광고 실적 측정항목

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