YouTube Analytics API: Content Owner Reports

참고: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

이 페이지에는 콘텐츠 소유자가 YouTube 분석 API로 가져올 수 있는 보고서가 나와 있습니다. 콘텐츠 소유자 보고서에는 지정된 YouTube 콘텐츠 소유자와 연결된 채널의 측정항목이 포함됩니다. 측정항목은 사용자 활동, 광고 실적 또는 예상 수익을 개별적으로 측정한 것입니다.

• 동영상 보고서에는 콘텐츠 소유자의 채널에 있는 동영상의 사용자 활동, 광고 실적, 예상 수익 측정항목이 포함됩니다.

• 재생목록 보고서는 재생목록 맥락에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다. 재생목록 보고서는 동영상 보고서와 동일한 측정기준과 필터를 많이 사용합니다.

• 광고 실적 보고서에는 수익 및 광고 실적과 관련된 측정항목이 포함되어 있습니다. adType 측정기준을 사용하여 동영상 재생 중에 게재된 광고 유형을 기준으로 측정항목을 그룹화합니다. 광고 실적 보고서 섹션에서는 API에서 지원하는 두 가지 유형의 광고 실적 측정항목을 설명합니다.

보고서 검색하기

콘텐츠 소유자 보고서를 검색하려면 API의 reports.query 메서드를 호출하고 API 요청에서 ids 매개변수 값을 contentOwner==OWNER_NAME로 설정합니다. 여기서 OWNER_NAME은 콘텐츠 소유자의 ID를 지정합니다. 값을 잘 모르겠다면 파트너 관리자에게 문의하세요.

승인

모든 YouTube Analytics API 요청은 승인된 상태여야 합니다. 승인 가이드에서는 OAuth 2.0 프로토콜을 사용하여 승인 토큰을 검색하는 방법을 설명합니다.

YouTube 분석 API 요청은 다음 승인 범위를 사용합니다.

범위
https://www.googleapis.com/auth/yt-analytics.readonly	YouTube 콘텐츠에 관한 YouTube 분석 보고서 보기 이 범위를 사용하여 사용자 활동 측정항목(예: 조회수, 평가 횟수)을 조회할 수 있습니다.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	YouTube 콘텐츠에 관한 YouTube 분석 금전 보고서 보기 이 범위에서는 사용자 활동 측정항목, 예상 수익, 광고 실적 측정항목에 액세스할 수 있습니다.
https://www.googleapis.com/auth/youtube	YouTube 계정을 관리합니다. YouTube Analytics API에서 채널 소유자는 이 범위를 사용하여 YouTube 분석 그룹과 그룹 항목을 관리합니다.
https://www.googleapis.com/auth/youtubepartner	YouTube에서 YouTube 저작물과 관련 콘텐츠를 보고 관리합니다. YouTube 분석 API에서 콘텐츠 소유자는 이 범위를 사용하여 YouTube 분석 그룹과 그룹 항목을 관리합니다.

참고: 별표 (*)로 표시된 측정항목에는 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위에 대한 액세스 권한을 부여하는 승인 토큰이 필요합니다.

필터

콘텐츠 소유자 보고서를 검색하기 위한 모든 API 요청은 video 측정기준, channel 측정기준, isCurated 측정기준 또는 지원되는 claimedStatus 및 uploaderType 측정기준 조합을 사용하여 데이터를 필터링해야 합니다. 지원되는 조합은 uploaderType 측정기준의 정의에 나와 있습니다.

지원되는 보고서를 설명하는 표에는 특정 보고서에 사용할 수 있는 필터가 표시됩니다. 설명에서 괄호로 표시된 필터는 선택사항입니다. 예를 들어 보고서에 video(,country)가 필터링 옵션으로 표시되면 보고서를 특정 동영상의 데이터만 포함하도록 필터링하거나 특정 국가의 특정 동영상의 데이터만 포함하도록 필터링할 수 있습니다.

또한 이 API는 video, playlist, channel 필터에 여러 값을 지정하는 기능을 지원합니다. 이러한 필터 중 하나에 여러 개의 값을 지정하는 경우 요청에 지정하는 측정기준 목록에 해당 필터를 추가할 수도 있습니다. 이는 필터가 특정 보고서에서 지원되는 측정기준으로 표시되지 않은 경우에도 마찬가지입니다.

특정 값 또는 값 집합에 대해 API 결과를 필터링하는 방법에 관한 자세한 설명은 filters 매개변수 정의를 참고하세요.

보고서 표 이해하기

이 섹션에서는 API에서 지원하는 보고서를 정의하는 표에 사용되는 형식 및 용어를 설명합니다. 다음 표에는 시간 측정기준과 averageViewPercentage 측정항목을 사용하는 재생 세부정보 동영상 보고서에 지원되는 측정기준, 측정항목, 필터가 나열되어 있습니다.

목차
크기:	0 이상을 사용합니다. creatorContentType, subscribedStatus, youtubeProduct 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 동영상, 그룹 0 이상을 사용합니다. subscribedStatus, youtubeProduct

테이블에는 측정기준 행 2개, 측정항목 행 1개, 필터 행 3개가 있습니다. 측정기준 및 필터의 경우 조합이 표의 사용 규칙을 따르는 한 각 행의 값을 API 요청에서 결합할 수 있습니다. 예를 들어 이 보고서의 유효한 dimensions 매개변수 값은 다음과 같습니다.

• dimensions=day
• dimensions=day,subscribedStatus
• dimensions=month,subscribedStatus,youtubeProduct
• dimensions=month,youtubeProduct

그러나 매개변수 값 day,month는 두 가지 시간 기반 측정기준을 사용하므로 유효하지 않으며 요청은 0 또는 1을 사용해야 합니다.

보고서 표 용어

표에서는 측정기준이 필수인지 선택사항인지를 나타내는 데 다음 용어를 사용합니다.

• 다음 용어는 값이 필요하다는 의미입니다.
  • 필수: 값을 포함해야 합니다.
  • 정확히 1개 사용: 그룹에서 값을 하나 포함해야 합니다.
  • 1 이상 사용: 그룹의 일부 또는 모든 값을 포함할 수 있지만 하나 이상 포함해야 합니다.
• 다음 용어는 값이 선택사항임을 의미합니다.
  • 선택사항: 값을 포함할 수 있습니다.
  • 0 또는 1 사용: 그룹에서 값을 하나 포함할 수 있습니다.
  • 0 이상 사용: 그룹의 일부 또는 모든 값을 포함할 수 있습니다.

동영상 보고서

기본 통계

기본 통계 (구독자 수 포함)

이 보고서는 콘텐츠 소유자의 모든 채널에서 발생한 사용자 작업과 관련된 통계를 제공합니다. 특정 동영상 또는 국가에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다. 콘텐츠 소유자, 서드 파티 또는 둘 다에 의해 업로드된 소유권 주장이 제기된 콘텐츠의 통계만 가져오는 데도 사용할 수 있습니다.

목차
크기:	[없음]
측정항목:	1개 이상 사용 조회수, redViews, 댓글, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, continent, subContinent

미국 주별 기본 통계

이 보고서는 특정 미국 주 또는 워싱턴 D.C. 의 통계를 제공합니다. 이 보고서는 위에서 설명한 국가별 보고서에서 사용할 수 있는 측정항목의 하위 집합만 지원한다는 점에 유의하세요.

목차
크기:	[없음]
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 province

시간 기준

기간별 활동

이 보고서는 특정 시간 간격 동안 콘텐츠 소유자의 모든 채널에서 발생한 사용자 작업과 관련된 통계를 제공합니다. 특정 동영상 또는 국가에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:	정확히 1 사용 일, 월 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, 댓글, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, 고유한 시청자 수, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, Cpm*
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, continent, subContinent

특정 기간 동안의 미국 여러 주의 사용자 활동

이 보고서는 특정 미국 주 또는 워싱턴 D.C. 의 통계를 제공합니다. 이 보고서는 위에서 설명한 국가별 보고서에서 사용할 수 있는 측정항목의 하위 집합만 지원한다는 점에 유의하세요.

목차
크기:	정확히 1 사용 일, 월 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 province

사용자 지역

국가별 사용자 활동

이 보고서는 콘텐츠 소유자의 모든 채널에 대한 국가별 사용자 활동 통계를 제공합니다. 특정 동영상 또는 채널의 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:	필수 country 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, 댓글, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 continent, subContinent

행정구역별 사용자 활동

이 보고서는 미국 각 주 및 워싱턴 D.C. 의 사용자 활동 통계를 제공합니다. 이 보고서의 경우 filters 매개변수 값을 country==US로 설정해야 합니다.

목차
크기:	필수 province 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 country==US

도시별 사용자 활동(<= 250개 결과)

참고: 이 보고서를 사용하려면 maxResults 매개변수를 250 이하의 정수 값으로 설정해야 합니다. 다른 대부분의 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서는 도시별 사용자 활동 통계를 제공합니다.

목차
크기:	필수 city 0 이상을 사용합니다. creatorContentType, country, province, subscribedStatus 참고: province 측정기준을 포함하는 경우 country==US 필터도 사용해야 합니다. 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent
정렬 옵션:	-조회수 -estimatedMinutesWatched

재생 세부정보

재생 세부정보 보고서에는 다음과 같은 시청 속성과 관련된 통계가 제공됩니다.

• 라이브 동영상 방송을 시청했나요? 아니면 주문형 동영상을 시청했나요?
• 시청자가 동영상 소유자의 채널을 구독했나요?
• 조회가 발생한 YouTube 제품은 무엇인가요?

엄밀히 말해 이러한 보고서에서 지원하는 재생 세부정보 측정기준은 모두 선택사항입니다. 요청에 재생 세부 측정기준을 포함하지 않으면 반환된 보고서는 실제로 기본 통계, 시간 기반 또는 사용자 지역 보고서 중 하나와 유사합니다.

참고: liveOrOnDemand 측정기준 및 필터는 averageViewPercentage 측정항목과 함께 사용할 수 없습니다. 따라서 다음 하위 섹션에는 각각 두 개의 보고서가 나열됩니다. 한 보고서는 liveOrOnDemand 측정기준 (및 필터)를 지원하고 다른 보고서는 averageViewPercentage 측정항목을 지원합니다.

구독 상태별 사용자 활동

이 보고서는 구독자 및 비구독자 시청자의 사용자 활동 측정항목을 제공합니다. 통계는 기간 (일 또는 월)별로 그룹화할 수 있으며, 보고서는 국가, 대륙 또는 subContinent별로 필터링할 수도 있습니다.

목차
크기:	0 이상을 사용합니다. creatorContentType, subscribedStatus 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, redViews, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, continent, subContinent 선택사항 subscribedStatus

행정구역별 구독 상태에 따른 사용자 활동

이 보고서는 미국 주 또는 컬럼비아 특별구에서 구독 중인 시청자와 구독 취소한 시청자의 사용자 활동 측정항목을 제공합니다. 이 보고서는 이전 보고서보다 적은 수의 측정항목을 지원합니다.

목차
크기:	0 이상을 사용합니다. creatorContentType, subscribedStatus 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 province 선택사항 subscribedStatus

시간 측정기준(선택사항)이 포함된 재생 세부정보

시간 측정기준(일 또는 월)은 이러한 보고서에 선택사항입니다. startDate 및 endDate 요청 매개변수를 사용하여 보고서에 포함할 기간을 지정해야 하므로 이러한 측정기준은 중요하지 않습니다. 측정기준이 있는 경우 보고서의 데이터를 일, 월 등으로 집계할 것임을 나타냅니다.

시간 측정기준(선택사항) 및 liveOrOnDemand 통계가 포함된 재생 세부정보

이 보고서는 특정 시간 간격에 대한 재생 세부정보 통계를 제공합니다. liveOrOnDemand 측정기준 (및 필터)을 지원합니다.

목차
크기:	0 이상을 사용합니다. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus, youtubeProduct

시간 측정기준(선택사항) 및 averageViewPercentage 측정항목이 포함된 재생 세부정보

이 보고서는 특정 시간 간격에 대한 재생 세부정보 통계를 제공합니다.

목차
크기:	0 이상을 사용합니다. creatorContentType, subscribedStatus, youtubeProduct 0 또는 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct

국가별 재생 세부정보

liveOrOnDemand 통계가 포함된 국가별 재생 세부정보

이 보고서는 국가별 재생 세부 통계를 제공합니다. liveOrOnDemand 측정기준 (및 필터)을 지원합니다.

목차
크기:	선택사항 country 0 이상을 사용합니다. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus, youtubeProduct

averageViewPercentage 측정항목을 사용한 국가별 재생 세부정보

다음 신고는 이전 신고와 유사합니다. averageViewPercentage 측정항목에 대한 지원을 추가하지만 liveOrOnDemand를 측정기준 또는 필터로 지원하지는 않습니다.

목차
크기:	선택사항 country 0 이상을 사용합니다. creatorContentType, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct

시/도별 재생 세부정보

liveOrOnDemand 통계가 포함된 지역별 재생 세부정보

이 보고서는 미국 각 주 및 워싱턴 D.C. 의 재생 세부 통계를 제공합니다. liveOrOnDemand 측정기준 (및 필터)을 지원합니다.

목차
크기:	선택사항 province 0 이상을 사용합니다. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 국가==US 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus, youtubeProduct

averageViewPercentage 측정항목을 사용한 시/도별 재생 세부정보

다음 신고는 이전 신고와 유사합니다. averageViewPercentage 측정항목에 대한 지원을 추가하지만 liveOrOnDemand를 측정기준 또는 필터로 지원하지는 않습니다.

목차
크기:	선택사항 province 0 이상을 사용합니다. creatorContentType, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 국가==US 0 이상을 사용합니다. subscribedStatus, youtubeProduct

재생 위치

동영상 재생 위치 보고서

이 보고서에서는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형과 관련된 통계를 제공합니다.

목차
크기:	필수 insightPlaybackLocationType 0 이상을 사용합니다. creatorContentType, day, liveOrOnDemand, subscribedStatus
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus

재생 위치 세부정보 (<= 25개 결과)

참고: 이 보고서를 사용하려면 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 다른 대부분의 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서에서는 콘텐츠 소유자의 콘텐츠에 대해 가장 많은 조회수 또는 시청 시간을 발생시킨 삽입된 동영상 플레이어를 식별합니다. 이 보고서를 검색할 때는 insightPlaybackLocationType 필터를 EMBEDDED로 설정해야 합니다.

목차
크기:	필수 insightPlaybackLocationDetail 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 insightPlaybackLocationType==EMBEDDED 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus
정렬 옵션:	-조회수 -estimatedMinutesWatched

트래픽 소스

트래픽 소스

이 보고서는 시청자가 동영상 콘텐츠에 도달한 방식을 기반으로 시청 통계를 집계합니다. 예를 들어 Google 검색 또는 관련 동영상 링크에서 발생한 조회수를 식별합니다.

참고: 이 보고서는 검색된 동영상 수 X 기간 일 수의 곱이 50,000을 초과하면 오류를 반환합니다. 예를 들어 500개의 동영상 ID에 대한 데이터를 검색하는 쿼리는 최대 100일 동안의 데이터를 요청할 수 있습니다. 요청이 반환하는 행 수를 줄이려면 쿼리를 동영상 수를 줄이거나 기간을 더 짧게 설정하는 여러 쿼리로 분할하세요.

목차
크기:	필수 insightTrafficSourceType 0 이상을 사용합니다. creatorContentType, day, liveOrOnDemand, subscribedStatus
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus

트래픽 소스 세부정보(<= 25개 결과)

참고: 이 보고서를 사용하려면 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 다른 대부분의 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서는 콘텐츠 소유자의 콘텐츠에 대해 가장 많은 조회수를 발생시킨 추천 사이트를 기반으로 시청 통계를 집계합니다. 추천 사이트는 트래픽 소스 유형별로 분류되며 insightTrafficSourceDetail 측정기준의 정의는 보고서를 사용할 수 있는 트래픽 소스를 식별합니다. 예를 들어 insightTrafficSourceType 필터를 ADVERTISING로 설정하면 보고서에 콘텐츠 소유자의 콘텐츠에서 조회수 또는 시청 시간을 가장 많이 발생시킨 광고 유형이 표시됩니다.

목차
크기:	필수 insightTrafficSourceDetail 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 필수 insightTrafficSourceType (아래 표 참고) 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus
정렬 옵션:	-조회수 -estimatedMinutesWatched

참고: 이 보고서는 특정 트래픽 소스에서만 지원됩니다. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, NO_LINK_EMBEDDED 트래픽 소스는 지원되지 않는 소스 중 일부입니다.

기기 유형 및 운영체제

기기 유형

이 보고서는 시청자가 콘텐츠를 시청할 때 사용한 기기 유형을 기준으로 시청 통계를 집계합니다. 예를 들어 태블릿 또는 게임 콘솔에서 발생한 조회수를 식별합니다.

목차
크기:	필수 deviceType 0 이상을 사용합니다. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

운영체제

이 보고서는 시청자의 운영체제를 기준으로 시청 통계를 집계합니다. 예를 들어 Android 기기 또는 PlayStation에서 발생한 조회수를 식별합니다.

목차
크기:	필수 operatingSystem 0 이상을 사용합니다. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

운영체제 및 기기 유형

이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 조회수를 식별합니다.

목차
크기:	필수 operatingSystem,deviceType 0 이상을 사용합니다. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus, youtubeProduct

시청자 인구통계

이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다.

목차
크기:	1개 이상 사용 ageGroup, gender 0 이상을 사용합니다. creatorContentType, liveOrOnDemand, subscribedStatus
측정항목:	1개 이상 사용 viewerPercentage
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus

참여도 및 콘텐츠 공유

이 보고서에서는 채널의 동영상이 여러 소셜 플랫폼에서 공유된 빈도를 보여주는 통계를 제공합니다.

목차
크기:	필수 sharingService 선택사항 creatorContentType, subscribedStatus
측정항목:	1개 이상 사용 shares
필터:	정확히 1 사용 동영상, 채널, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, continent, subContinent 선택사항 subscribedStatus

시청 지속 시간

이 보고서는 동영상이 시청자의 관심을 얼마나 끌고 있는지를 측정합니다. elapsedVideoTimeRatio 측정기준은 해당 측정항목 값에 대해 경과된 동영상 길이를 측정합니다. audienceWatchRatio 및 relativeRetentionPerformance 측정항목은 동영상이 시청자의 관심을 얼마나 끌 수 있는지를 보여주는 두 가지 측정치를 제공합니다. 첫 번째는 절대 값이고, 두 번째는 비슷한 길이의 다른 YouTube 동영상과 비교한 동영상 실적을 보여줍니다.

참고: 시청 지속 시간 보고서는 video 필터에 쉼표로 구분된 값 목록을 지정하는 기능을 지원하지 않습니다. 값은 단일 동영상 ID를 지정해야 합니다.

목차
크기:	필수 elapsedVideoTimeRatio 선택사항 creatorContentType
측정항목:	1개 이상 사용 audienceWatchRatio, relativeRetentionPerformance
필터:	필수 video 0 이상을 사용합니다. audienceType, subscribedStatus, youtubeProduct

인기 동영상

참고: 이러한 보고서를 사용하려면 maxResults 매개변수를 200 이하의 정수 값으로 설정해야 합니다. 2013년 1월 1일 이전의 데이터는 인기 급상승 동영상 10개에 대해서만 제공됩니다. 다른 대부분의 보고서와 달리 이러한 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

전체, 국가, 대륙 또는 아대륙별 인기 동영상(<= 200개 결과)

이 보고서에는 지정된 필터링 및 정렬 기준에 따라 콘텐츠 소유자의 인기 동영상이 표시됩니다.

목차
크기:	필수 video 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, 댓글, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, CPM*
필터:	정확히 1 사용 채널 또는 지원되는 uploaderType 및 claimedStatus 조합 0 또는 1 사용 country, continent, subContinent
정렬 옵션:	-views -redViews -estimatedRevenue -estimatedRedPartnerRevenue -estimatedMinutesWatched -estimatedRedMinutesWatched -subscribersGained -subscribersLost

미국 주별 전체 인기 동영상 (<= 200개 결과)

이 보고서에는 특정 미국 주 또는 컬럼비아 특별구에서 콘텐츠 소유자의 인기 동영상이 표시됩니다. 이 보고서는 위에서 설명한 국가별 보고서에서 사용할 수 있는 측정항목의 하위 집합만 지원한다는 점에 유의하세요.

목차
크기:	필수 video 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 채널 또는 지원되는 uploaderType 및 claimedStatus 조합 필수 province
정렬 옵션:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

구독자 또는 구독 취소한 시청자의 인기 동영상(<= 200개 결과)

이 보고서에는 구독자 또는 구독 취소한 시청자의 인기 동영상이 표시됩니다. 이 보고서는 국가, 대륙 또는 subContinent별로 인기 동영상을 표시하도록 필터링할 수 있습니다. 이전 보고서에서는 구독 또는 구독 취소한 시청자를 기준으로 특정 미국 주에서 인기 있는 동영상을 검색할 수 있지만 이 보고서보다 지원되는 측정항목이 적습니다.

목차
크기:	필수 video 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, 좋아요, 싫어요, videosAddedToPlaylists, videosRemovedFromPlaylists, 공유, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
필터:	정확히 1 사용 채널 또는 지원되는 uploaderType 및 claimedStatus 조합 선택사항 subscribedStatus 0 또는 1 사용 country, continent, subContinent
정렬 옵션:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

YouTube 제품별 인기 동영상 (<= 200개 결과)

이 보고서에는 인기 동영상이 나열되며 재생 세부정보 및 지역 필터가 지원됩니다. 이 보고서는 이전 보고서와 비슷하지만 지원하는 측정항목이 적고 youtubeProduct 필터에 대한 지원이 추가되었습니다.

목차
크기:	필수 video 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:	정확히 1 사용 채널 또는 지원되는 uploaderType 및 claimedStatus 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct
정렬 옵션:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

재생 세부정보 필터가 적용된 인기 동영상(<= 200개 결과)

이 보고서에는 콘텐츠 소유자의 인기 동영상이 표시되며 liveOrOnDemand, subscribedStatus, youtubeProduct 등 하나 이상의 재생 세부 측정기준을 기준으로 필터링됩니다. 이 보고서는 지역별 필터링도 지원합니다.

목차
크기:	필수 video 선택사항 creatorContentType
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:	정확히 1 사용 채널 또는 지원되는 uploaderType 및 claimedStatus 조합 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. liveOrOnDemand, subscribedStatus, youtubeProduct
정렬 옵션:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

재생목록 보고서

재생목록 보고서에는 채널 소유자의 재생목록에 있는 동영상과 관련된 사용자 활동과 관련된 측정항목이 포함됩니다. 이 보고서는 두 가지 버전으로 제공되며, 사용 가능한 각 보고서에 대해 다음 섹션에 각 버전에 관한 설명이 포함되어 있습니다.

• 각 섹션의 권장 탭에는 해당 보고서를 가져오는 데 권장되는 API 요청 형식이 설명되어 있습니다. 추천 보고서는 집계된 동영상 측정항목과 재생목록 내 측정항목을 모두 포함하는 확장된 측정항목 집합을 지원합니다. 이 요청 형식은 isCurated 측정기준을 사용하지 않습니다.
• 각 섹션의 isCurated 사용 탭에는 isCurated 측정기준이 필요한 이전 API 요청 형식이 설명되어 있습니다. 이 보고서는 재생목록 내 측정항목만 지원합니다. isCurated 측정기준은 모든 보고서에서 지원 중단되었습니다. 아래의 경고 메모에는 지원 중단 일정이 설명되어 있습니다.

다음 경고 메모에서는 두 보고서 버전 간의 변경사항을 자세히 설명합니다.

집계된 동영상 측정항목

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

YouTube에서 지원하는 집계된 동영상 측정항목 목록은 지원되는 재생목록 측정항목 섹션을 참고하세요.

재생목록 내 측정항목

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

지원되는 재생목록 측정항목

권장

목차
집계된 동영상 측정항목	조회수, estimatedMinutesWatched, averageViewDuration
재생목록 내 측정항목	playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

isCurated 사용

목차
집계된 동영상 측정항목	지원되지 않음
재생목록 내 측정항목	조회수, estimatedMinutesWatched, averageViewDuration, averageViewPercentage, redViews, estimatedRedMinutesWatched

기본 통계

이 보고서는 콘텐츠 소유자 채널의 재생목록에 있는 동영상과 사용자의 상호작용과 관련된 통계를 제공합니다. 보고서에 필수 측정기준이 없습니다.

권장

목차
크기:	[없음]
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	[없음]
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 채널, 재생목록, 그룹 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct

시간 기준

이 보고서는 특정 시간 간격 동안 콘텐츠 소유자 채널의 재생목록에 있는 동영상과 사용자의 상호작용과 관련된 통계를 제공합니다. 보고서를 필터링하여 특정 재생목록 또는 채널의 데이터만 반환할 수 있습니다.

권장

목차
크기:	정확히 1 사용 일, 월
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	정확히 1 사용 일, 월 0 이상을 사용합니다. subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 채널, 재생목록, 그룹 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct

사용자 지역

이 보고서는 특정 국가의 사용자가 채널 재생목록의 동영상과 상호작용한 것과 관련된 통계를 제공합니다.

이 보고서는 국가별 재생목록 통계를 제공합니다.

권장

목차
크기:	필수 country
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 0 또는 1 사용 continent, subContinent 선택사항 channel

isCurated 사용

목차
크기:	필수 country 0 이상을 사용합니다. subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 0 이상을 사용합니다. subscribedStatus, youtubeProduct

행정구역별 재생목록 활동

이 보고서는 미국 각 주 및 워싱턴 D.C. 의 재생목록 활동 통계를 제공합니다. 이 보고서의 경우 filters 매개변수 값에 country==US를 포함합니다.

권장

목차
크기:	필수 province
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration
필터:	필수 국가==US 0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 province 0 이상을 사용합니다. subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1;country==US 0 또는 1 사용 채널, 재생목록, 그룹 0 이상을 사용합니다. subscribedStatus, youtubeProduct

재생 위치

이 보고서는 재생목록 재생이 발생한 페이지 또는 애플리케이션 유형과 관련된 통계를 제공합니다.

권장

목차
크기:	필수 insightPlaybackLocationType
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 insightPlaybackLocationType 0 이상을 사용합니다. day, subscribedStatus
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 선택사항 subscribedStatus

재생 위치 세부정보 (<= 25개 결과)

참고: 이 보고서를 사용하려면 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 다른 대부분의 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서는 콘텐츠 소유자의 재생목록에서 조회수 또는 시청 시간이 가장 많이 발생한 삽입된 동영상 플레이어를 식별합니다.

권장

목차
크기:	필수 insightPlaybackLocationDetail
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	필수 insightPlaybackLocationType==EMBEDDED 0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel
정렬 옵션:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

isCurated 사용

목차
크기:	필수 insightPlaybackLocationDetail
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1;insightPlaybackLocationType==EMBEDDED 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 선택사항 subscribedStatus
정렬 옵션:	-views -estimatedMinutesWatched -playlistStarts

트래픽 소스

이 보고서는 시청자가 재생목록 콘텐츠에 도달한 방식을 기준으로 시청 통계를 집계합니다. 예를 들어 Google 검색 또는 채널 페이지에서 발생한 조회수를 식별합니다.

권장

목차
크기:	필수 insightTrafficSourceType
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 insightTrafficSourceType 0 이상을 사용합니다. day, subscribedStatus
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 선택사항 subscribedStatus

트래픽 소스 세부정보(<= 25개 결과)

참고: 이 보고서를 사용하려면 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 다른 대부분의 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서는 콘텐츠 소유자의 재생목록에서 가장 많은 조회수를 발생시킨 리퍼러를 기준으로 시청 통계를 집계합니다. 추천 사이트는 트래픽 소스 유형별로 분류되며 insightTrafficSourceDetail 측정기준의 정의는 보고서를 사용할 수 있는 트래픽 소스를 식별합니다. 예를 들어 insightTrafficSourceType 필터를 ADVERTISING로 설정하면 콘텐츠 소유자의 재생목록에서 조회수 또는 시청 시간을 가장 많이 발생시킨 광고 유형이 보고서에 표시됩니다.

권장

목차
크기:	필수 insightTrafficSourceDetail
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	필수 insightTrafficSourceType 0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel
정렬 옵션:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

isCurated 사용

목차
크기:	필수 insightTrafficSourceDetail
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1;insightTrafficSourceType 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 선택사항 subscribedStatus
정렬 옵션:	-views -estimatedMinutesWatched -playlistStarts

참고: 이 보고서는 특정 트래픽 소스에서만 지원됩니다. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, NO_LINK_EMBEDDED 트래픽 소스는 지원되지 않는 소스 중 일부입니다.

기기 유형 및 운영체제

재생목록의 기기 유형

이 보고서는 시청자가 재생목록 콘텐츠를 시청하는 데 사용한 기기 유형을 기준으로 시청 통계를 집계합니다. 예를 들어 휴대기기 또는 게임 콘솔에서 발생한 조회수를 식별합니다.

권장

목차
크기:	필수 deviceType
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 deviceType 0 이상을 사용합니다. day, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 0 이상을 사용합니다. operatingSystem, subscribedStatus, youtubeProduct

재생목록 운영체제

이 보고서는 시청자의 운영체제를 기준으로 시청 통계를 집계합니다. 예를 들어 Android 기기 또는 PlayStation에서 발생한 재생목록 조회 수를 식별합니다.

권장

목차
크기:	필수 operatingSystem
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 operatingSystem 0 이상을 사용합니다. day, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 0 이상을 사용합니다. deviceType, subscribedStatus, youtubeProduct

재생목록의 운영체제 및 기기 유형

이 보고서는 시청자의 운영체제 및 기기 유형을 기준으로 시청 통계를 집계합니다. 예를 들어 Android 태블릿 또는 Windows 데스크톱 기기에서 발생한 재생목록 조회 수를 식별합니다.

권장

목차
크기:	필수 deviceType, operatingSystem
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	필수 deviceType, operatingSystem 0 이상을 사용합니다. day, subscribedStatus, youtubeProduct
측정항목:	1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 0 이상을 사용합니다. subscribedStatus, youtubeProduct

시청자 인구통계

이 보고서는 시청자의 연령 그룹 및 성별에 따라 조회 통계를 집계합니다.

권장

목차
크기:	1개 이상 사용 ageGroup, gender
측정항목:	필수 viewerPercentage
필터:	0 또는 1을 사용합니다.* 재생목록, 그룹 참고: 보고서에서 조회수, estimatedMinutesWatched 또는 averageViewDuration 측정항목 중 하나라도 요청된 경우 이러한 필터 중 하나만 지정해야 합니다. 선택사항 channel

isCurated 사용

목차
크기:	1개 이상 사용 ageGroup, gender 0 이상을 사용합니다. subscribedStatus
측정항목:	필수 viewerPercentage
필터:	필수 isCurated==1 0 또는 1 사용 country, province, continent, subContinent 0 또는 1 사용 재생목록, 채널, 그룹 선택사항 subscribedStatus

상위 재생목록

참고: 이러한 보고서를 사용하려면 maxResults 매개변수를 200 이하의 정수 값으로 설정해야 합니다. 2013년 1월 1일 이전의 데이터는 인기 재생목록 10개에 대해서만 사용할 수 있습니다. 다른 대부분의 보고서와 달리 이러한 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.

이 보고서에는 지정된 필터링 및 정렬 기준에 따라 콘텐츠 소유자의 인기 재생목록이 표시됩니다.

권장

목차
크기:	필수 playlist
측정항목:	1개 이상 사용 averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
정렬 옵션:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

isCurated 사용

목차
크기:	필수 playlist
측정항목:	1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:	필수 isCurated==1 0 또는 1 사용 재생목록, 채널 0 또는 1 사용 country, province, continent, subContinent 0 이상을 사용합니다. subscribedStatus, youtubeProduct
정렬 옵션:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched -playlistStarts

광고 실적 보고서

참고: 광고 실적 보고서에는 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위에 대한 액세스 권한을 부여하는 승인 토큰이 필요합니다.

광고 실적 보고서는 동영상 재생 중에 게재된 광고의 노출 기반 측정항목을 제공합니다. 이 측정항목은 각 광고 노출을 고려하며, 동영상 재생마다 여러 노출이 발생할 수 있습니다.

노출 기반 광고 실적 측정항목은 다음과 같습니다.

• grossRevenue
• adImpressions
• cpm

또한 일부 동영상 보고서에서는 다음과 같은 재생 기반 광고 실적 측정항목을 지원합니다. 하지만 이러한 측정항목은 광고 실적 보고서에 포함되지 않습니다.

• playbackBasedCpm
• monetizedPlaybacks

광고 유형별 광고 실적

목차
크기:	필수 adType 선택사항 일
측정항목:	1개 이상 사용 grossRevenue, adImpressions, cpm
필터:	정확히 1 사용 동영상, 그룹 또는 uploaderType 및 claimedStatus의 지원되는 조합 0 또는 1 사용 country, continent, subContinent