YouTube Analytics API: Channel Reports

7DayTotals30DayTotals 측정기준은 지원 중단되었습니다. 자세한 내용은 업데이트 기록을 참고하세요.

이 페이지에는 채널 소유자가 YouTube Analytics API로 검색할 수 있는 보고서가 나와 있습니다. 채널 보고서는 지정된 채널의 사용자 활동 측정항목을 제공하고 동영상 조회수, 평가 및 구독 수 등을 측정합니다.

  • 동영상 보고서는 채널 동영상과 관련된 모든 사용자 활동에 관한 통계를 제공합니다.
  • 재생목록 보고서는 구체적으로 재생목록의 맥락에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다.
  • 광고 실적 보고서에는 수익 및 광고 실적과 관련된 측정항목이 포함됩니다. adType 측정기준을 사용하여 동영상 재생 중에 게재된 광고 유형을 기준으로 측정항목을 그룹화합니다. 광고 실적 보고서 섹션에서는 API가 지원하는 두 가지 유형의 광고 실적 측정항목을 설명합니다.

보고서 검색하기

채널 보고서를 검색하려면 API 요청의 ids 매개변수 값을 다음 값 중 하나로 설정해야 합니다.

  • channel==MINE – API는 인증된 사용자의 YouTube 채널에 대한 데이터를 반환합니다.

  • channel==CHANNEL_ID: CHANNEL_ID을 데이터를 검색할 채널의 고유 채널 ID로 설정합니다. 요청을 승인한 사용자가 채널의 소유자여야 합니다.

    채널 ID는 현재 UC 문자로 시작하는 문자열이며 형식은 변경될 수 있습니다. YouTube 채널의 고급 계정 설정 페이지에서 채널의 ID를 찾거나 YouTube Data API's channels.list 메서드를 사용하여 프로그래매틱 방식으로 채널의 ID를 검색할 수 있습니다.

승인

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

YouTube Analytics 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 분석 API에서 채널 소유자는 이 범위를 사용하여 YouTube 분석 그룹 및 그룹 항목을 관리합니다.
https://www.googleapis.com/auth/youtubepartner YouTube에서 YouTube 저작물과 관련 콘텐츠를 보고 관리합니다. YouTube 분석 API에서 콘텐츠 소유자는 이 범위를 사용하여 YouTube 분석 그룹 및 그룹 항목을 관리합니다.

참고: 채널 수익에는 현재 예상 수익 및 광고 실적 측정항목이 지원되지 않습니다. 따라서 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위는 현재 보고서의 금전적 데이터에 대한 액세스 권한을 부여하지 않습니다.

필터

지원되는 보고서를 설명하는 표에는 각 보고서에 사용할 수 있는 필터가 나와 있습니다. 표에서 괄호로 표시된 필터는 선택사항입니다. 예를 들어 필터링 옵션 video(,country)의 경우 동영상 필터가 필요하고 국가 필터는 선택사항입니다.

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

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

보고서 표 이해하기

이 섹션에서는 API가 지원하는 보고서를 정의하는 표에서 사용되는 형식 및 용어를 설명합니다. 아래 표에는 시간 기반 채널 재생목록 보고서에 지원되는 측정기준, 측정항목 및 필터가 나와 있습니다.

목차
크기:
정확히 1개 사용 ,
0 이상을 사용하세요. subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

표에는 측정기준 행 2개, 측정항목 행 1개, 필터 행 4개가 포함되어 있습니다. 측정기준 및 필터의 경우 표의 사용 규칙을 준수한다면 API 요청에서 각 행의 값을 결합할 수 있습니다. 예를 들어 이 보고서의 유효한 dimensions 매개변수 값에는 다음이 포함됩니다.

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

하지만 매개변수 값 day,month은(는) 두 개의 시간 기반 측정기준을 사용하지만 잘못된 요청이므로 정확히 1개만 사용해야 합니다. 이 경우 매개변수 값 subscribedStatus,youtubeProduct은 실제로 보고서를 반환하지만 측정항목은 일, 주, 월 등으로 집계되지 않습니다. 이 보고서는 문서에 별도로 설명되어 있습니다.

보고서 표 용어

표에는 측정기준이 사용되는지 아니면 선택사항인지를 나타내는 용어가 사용됩니다.

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

동영상 보고서

기본 통계

기본 사용자 활동 통계

이 보고서는 채널에서의 사용자 활동과 관련된 통계를 제공합니다. 특정 동영상 또는 국가에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:
[없음]
측정항목:
1개 이상 사용 을 확인해 주세요.
필터:
0 또는 1 사용 국가, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹

미국 여러 주의 기본 사용자 활동 통계

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

목차
크기:
[없음]
측정항목:
1개 이상 사용 views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration을 다시 표시합니다.
필터:
필수 province
0 또는 1 사용 동영상, 그룹

시간 기준

특정 기간 동안의 국가별 사용자 활동

이 보고서는 특정 기간의 사용자 행동과 관련된 통계를 제공합니다. 특정 동영상 또는 국가에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:
정확히 1개 사용 ,
선택사항 creatorContentType
측정항목:
1개 이상 사용 을 확인해 주세요.
필터:
0 또는 1 사용 국가, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹

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

이 보고서에서는 미국의 특정 주 또는 컬럼비아 특별구의 사용자 활동과 관련된 통계를 제공합니다. 이 보고서는 위에서 설명한 국가별 보고서에서 사용할 수 있는 측정항목의 하위 집합만 지원한다는 점에 유의하세요.

목차
크기:
정확히 1개 사용 ,
선택사항 creatorContentType
측정항목:
1개 이상 사용 views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration을 다시 표시합니다.
필터:
필수 province
0 또는 1 사용 동영상, 그룹

사용자 지역

국가별 사용자 활동

이 보고서는 채널에 대한 국가별 사용자 활동과 관련된 통계를 제공합니다. 특정 동영상에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:
필수 country
선택사항 creatorContentType
측정항목:
1개 이상 사용 을 확인해 주세요.
필터:
0 또는 1 사용 대륙, 아대륙
0 또는 1 사용 동영상, 그룹

행정구역별 사용자 활동

이 보고서에서는 미국 주 및 컬럼비아 특별구에 대한 사용자 활동 통계를 제공합니다. 이 보고서의 경우 filters 매개변수 값을 country==US로 설정해야 합니다.

목차
크기:
필수 province
선택사항 creatorContentType
측정항목:
1개 이상 사용 views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration을 다시 표시합니다.
필터:
필수 country==미국
0 또는 1 사용 동영상, 그룹

도시별 사용자 활동(결과 250개 이하)

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

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

목차
크기:
필수 city
0 이상을 사용하세요. creatorContentType, country, state, subscribedStatus

참고: 시/도 측정기준을 포함하면 country==US 필터도 사용해야 합니다.
0 또는 1 사용 ,
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
정렬 옵션: -조회수
-estimatedMinutesWatched

재생 세부정보

재생 세부정보 보고서는 다음 보기 속성과 관련된 통계를 제공합니다.

  • 실시간 동영상 방송 또는 주문형 동영상 중 어떤 것을 시청하셨나요?
  • 시청자가 동영상을 소유한 채널을 구독했나요?
  • 어떤 YouTube 제품에서 조회가 발생했나요?

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

구독 상태별 사용자 활동

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

목차
크기:
0 이상을 사용하세요. creatorContentType, subscribedStatus
0 또는 1 사용 ,
측정항목:
1개 이상 사용 조회수 0회
필터:
0 또는 1 사용 국가, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
선택사항 subscribedStatus

도의 구독 상태별 사용자 활동

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

목차
크기:
0 이상을 사용하세요. creatorContentType, subscribedStatus
0 또는 1 사용 ,
측정항목:
1개 이상 사용 views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration을 다시 표시합니다.
필터:
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. state, subscribedStatus

선택적 시간 측정기준이 포함된 재생 세부정보

이러한 보고서에서 시간 측정기준( 또는 )은 선택사항입니다. 그럼에도 불구하고 startDateendDate 요청 매개변수를 사용하여 보고서에 포함할 기간을 지정해야 하기 때문입니다. 측정기준(있는 경우)은 보고서의 데이터를 일, 월 등으로 집계하고자 한다는 것을 나타냅니다.

선택적 시간 측정기준 및 liveOrOnDemand 통계를 포함한 재생 세부정보

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

목차
크기:
0 이상을 사용하세요. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
0 또는 1 사용 ,
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus, youtubeProduct
시간 측정기준 및 averageViewPercentage 측정항목(선택사항)이 있는 재생 세부정보

이 보고서는 특정 시간 간격에 대한 재생 세부정보 통계를 제공합니다. averageViewPercentage 측정항목을 지원합니다.

목차
크기:
0 이상을 사용하세요. creatorContentType, subscribedStatus, youtubeProduct
0 또는 1 사용 ,
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

국가별 재생 세부정보

liveOrOnDemand 통계를 사용한 국가별 재생 세부정보

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

목차
크기:
필수 country
0 이상을 사용하세요. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:
0 또는 1 사용 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus, youtubeProduct
averageViewPercentage 측정항목을 사용하는 국가별 재생 세부정보

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

목차
크기:
필수 country
0 이상을 사용하세요. creatorContentType, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:
0 또는 1 사용 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

지역별 재생 세부정보

liveOrOnDemand 통계를 통한 지역별 재생 세부정보

이 보고서에서는 미국 주 및 컬럼비아 특별구의 재생 세부정보 통계를 제공합니다. liveOrOnDemand 측정기준 (및 필터)을 지원합니다.

목차
크기:
필수 province
0 이상을 사용하세요. creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:
필수 국가==US
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus, youtubeProduct
averageViewPercentage 측정항목을 사용한 지역별 재생 세부정보

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

목차
크기:
필수 province
0 이상을 사용하세요. creatorContentType, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:
필수 국가==US
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

재생 위치

동영상 재생 위치 보고서

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

목차
크기:
필수 insightPlaybackLocationType
0 이상을 사용하세요. creatorContentType, day, liveOrOnDemand, subscribedStatus
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus

재생 위치 세부정보(결과 25개 이하)

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

이 보고서는 채널 동영상의 조회수 또는 시청 시간이 가장 많이 발생한 내장 동영상 플레이어를 식별합니다.

목차
크기:
필수 insightPlaybackLocationDetail
선택사항 creatorContentType
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
필수 insightPlaybackLocationType==EMBEDDED
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus
정렬 옵션: -조회수
-estimatedMinutesWatched

트래픽 소스

트래픽 소스

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

목차
크기:
필수 insightTrafficSourceType
0 이상을 사용하세요. creatorContentType, day, liveOrOnDemand, subscribedStatus
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus

트래픽 소스 세부정보(결과 25개 이하)

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

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

목차
크기:
필수 insightTrafficSourceDetail
선택사항 creatorContentType
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
필수 insightTrafficSourceType (아래 표 참고)
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus
정렬 옵션: -조회수
-estimatedMinutesWatched

참고: 이 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스는 추가 세부정보가 없으므로 이 보고서를 지원하지 않습니다. 이 보고서를 지원하는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.

기기 유형 및 운영체제

기기 유형

이 보고서는 시청자가 동영상 콘텐츠에 도달한 방식을 기준으로 시청 통계를 집계합니다. 예를 들어 휴대기기 또는 게임 콘솔에서 발생한 조회수를 식별합니다.

목차
크기:
필수 기기 유형
0 이상을 사용하세요. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

운영체제

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

목차
크기:
필수 운영체제
0 이상을 사용하세요. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

운영체제 및 기기 유형

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

목차
크기:
필수 deviceType, operatingSystem
0 이상을 사용하세요. creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus, youtubeProduct

시청자 인구통계

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

목차
크기:
1개 이상 사용 ageGroup, 성별
0 이상을 사용하세요. creatorContentType, liveOrOnDemand, subscribedStatus
측정항목:
1개 이상 사용 viewerPercentage
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus
참고: 이 보고서의 viewerPercentage 값은 재생 세부정보 측정기준의 값 또는 값 조합(subscribedStatus, liveOrOnDemand, youtubeProduct)에 대해 정규화되지 않습니다.

예를 들어 subscribedStatus 데이터를 사용하는 조회수는 100%가 되고
조회 데이터가 100% 증가하며 구독자 수는 100%가 됩니다. 보고서의 모든 viewerPercentage 필드의 총 값은 200%입니다.

필터를 사용하여 보고서에 재생 세부정보 측정기준에 대한 하나의 값(또는 값의 조합)에 대한 viewerPercentage 데이터만 포함하도록 할 수 있습니다.

참여 및 콘텐츠 공유

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

목차
크기:
필수 sharingService
0 이상을 사용하세요. creatorContentType, subscribedStatus
측정항목:
1개 이상 사용 공유
필터:
0 또는 1 사용 국가, 대륙, 아대륙
0 또는 1 사용 동영상, 그룹
선택사항 subscribedStatus

시청 지속 시간

이 보고서는 동영상의 시청자층 유지 능력을 측정합니다. elapsedVideoTimeRatio 측정기준은 해당 측정항목 값에 대해 경과된 동영상의 양을 측정합니다. audienceWatchRatiorelativeRetentionPerformance 측정항목은 동영상이 잠재고객의 관심을 얼마나 잘 유지하는지를 보여주는 두 가지 측정값을 제공합니다. 첫 번째는 절댓값이고 두 번째는 비슷한 길이의 다른 YouTube 동영상과 비교하여 동영상 실적을 표시합니다.

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

목차
크기:
필수 elapsedVideoTimeRatio
선택사항 creatorContentType
측정항목:
1개 이상 사용 audienceWatchRatio, relativeRetainPerformance
필터:
필수 동영상
0 이상을 사용하세요. audienceType, subscribedStatus, youtubeProduct

인기 동영상

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

선택적 지역 필터가 있는 인기 동영상(결과 200개 이하)

이 보고서에는 채널의 인기 동영상이 표시됩니다. 보고서를 필터링하여 국가, 대륙, 아대륙별로 상위 동영상을 나열할 수 있습니다.

목차
크기:
필수 동영상
선택사항 creatorContentType
측정항목:
1개 이상 사용 을 확인해 주세요.
필터:
0 또는 1 사용 국가, 대륙, 아대륙
정렬 옵션: -조회수
-redViews
-추정 수익
-예상RedPartnerRevenue
-예상분초시청
-예상 RedMinutesWatched
-구독자 증가수
-구독자 감소수

주별 인기 동영상(결과 200개 이하)

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

목차
크기:
필수 동영상
선택사항 creatorContentType
측정항목:
1개 이상 사용 views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration을 다시 표시합니다.
필터:
필수 province
선택사항 subscribedStatus
정렬 옵션: -조회수
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

구독하거나 구독하지 않은 시청자를 위한 상위 동영상(결과 200개 이하)

이 보고서에는 구독하거나 구독하지 않은 시청자를 위한 채널의 상위 동영상이 표시됩니다. 보고서를 필터링하여 국가, 대륙, 아대륙별로 상위 동영상을 나열할 수 있습니다. 이전 보고서를 사용하면 구독 또는 구독하지 않은 시청자에 대해 미국의 특정 주에 있는 인기 동영상을 검색할 수 있지만 이 보고서보다 적은 수의 측정항목을 지원합니다.

목차
크기:
필수 동영상
선택사항 creatorContentType
측정항목:
1개 이상 사용 조회수 0회
필터:
선택사항 subscribedStatus
0 또는 1 사용 국가, 대륙, 아대륙
정렬 옵션: -조회수
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

YouTube 제품별 인기 동영상(결과 200개 이하)

이 보고서는 채널의 상위 동영상을 표시하고 재생 세부정보 및 지역 필터를 지원합니다. 이 보고서는 이전 보고서와 비슷하지만, 더 적은 수의 측정항목을 지원하고 youtubeProduct 필터에 대한 지원을 추가합니다.

목차
크기:
필수 동영상
선택사항 creatorContentType
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 이상을 사용하세요. subscribedStatus, youtubeProduct
정렬 옵션: -조회수
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

재생 세부정보 필터가 포함된 인기 동영상(결과 200개 이하)

이 보고서는 전체 재생 세부정보 측정기준(liveOrOnDemand, subscribedStatus, youtubeProduct)으로 필터링하여 채널의 인기 동영상을 표시합니다. 이전 보고서와 달리 이 보고서는 liveOrOnDemand 필터를 지원하며 averageViewPercentage 측정항목을 지원하지 않습니다.

목차
크기:
필수 동영상
선택사항 creatorContentType
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
필터:
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 이상을 사용하세요. liveOrOnDemand, subscribedStatus, youtubeProduct
정렬 옵션: -조회수
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

재생목록 보고서

기본 통계

이 보고서는 채널 재생목록과의 사용자 상호작용과 관련된 통계를 제공합니다. 특정 재생목록 또는 국가의 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:
[없음]
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

시간 기준

이 보고서는 채널 재생목록과의 사용자 상호작용과 관련된 통계를 제공합니다. 특정 재생목록 또는 국가의 데이터만 반환하도록 보고서를 필터링할 수 있습니다.

목차
크기:
정확히 1개 사용 ,
0 이상을 사용하세요. subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

사용자 지역

국가별 재생목록 활동

이 보고서는 채널 재생목록과의 사용자 상호작용과 관련된 통계를 제공합니다. 보고서를 필터링하여 특정 재생목록, 재생목록 그룹 또는 국가의 데이터만 반환할 수 있습니다.

목차
크기:
필수 country
0 이상을 사용하세요. subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

지역별 재생목록 활동

이 보고서는 미국 주와 컬럼비아 특별구에 대한 재생목록 활동 통계를 제공합니다. 이 보고서의 경우 filters 매개변수 값에 country==US를 포함합니다.

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

재생 위치

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

목차
크기:
필수 insightPlaybackLocationType
0 이상을 사용하세요. day, subscribedStatus
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
선택사항 subscribedStatus

재생 위치 세부정보(결과 25개 이하)

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

이 보고서는 채널 재생목록의 조회수 또는 시청 시간이 가장 많이 발생한 내장 동영상 플레이어를 식별합니다.

목차
크기:
필수 insightPlaybackLocationDetail
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1;insightPlaybackLocationType==EMBEDDED
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
선택사항 subscribedStatus
정렬 옵션: -조회수
-estimatedMinutesWatched
-재생목록 시작

트래픽 소스

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

목차
크기:
필수 insightTrafficSourceType
0 이상을 사용하세요. day, subscribedStatus
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
선택사항 subscribedStatus

트래픽 소스 세부정보(결과 25개 이하)

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

이 보고서는 채널 재생목록의 조회수를 가장 많이 발생시킨 리퍼러를 기준으로 시청 통계를 집계합니다. 리퍼러는 트래픽 소스 유형별로 분류되며 insightTrafficSourceDetail 측정기준의 정의는 보고서를 사용할 수 있는 트래픽 소스를 식별합니다.

예를 들어 insightTrafficSourceType 필터를 ADVERTISING로 설정하면 채널 재생목록의 가장 많은 조회수 또는 시청 시간을 생성한 광고 유형이 보고서에 나열됩니다.

목차
크기:
필수 insightTrafficSourceDetail
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1;insightTrafficSourceType
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
선택사항 subscribedStatus
정렬 옵션: -조회수
-estimatedMinutesWatched
-재생목록 시작

참고: 이 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스는 추가 세부정보가 없으므로 이 보고서를 지원하지 않습니다. 이 보고서를 지원하는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.

기기 유형 및 운영체제

기기 유형

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

목차
크기:
필수 기기 유형
0 이상을 사용하세요. , subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. operatingSystem, subscribedStatus, youtubeProduct

운영체제

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

목차
크기:
필수 운영체제
0 이상을 사용하세요. , subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. deviceType, subscribedStatus, youtubeProduct

운영체제 및 기기 유형

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

목차
크기:
필수 deviceType, operatingSystem
0 이상을 사용하세요. , subscribedStatus, youtubeProduct
측정항목:
1개 이상 사용 조회수, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
0 이상을 사용하세요. subscribedStatus, youtubeProduct

시청자 인구통계

목차
크기:
1개 이상 사용 ageGroup, 성별
0 이상을 사용하세요. subscribedStatus
측정항목:
필수 viewerPercentage
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 또는 1 사용 재생목록, 그룹
선택사항 subscribedStatus
참고: 이 보고서의 viewerPercentage 값은 재생 세부정보 측정기준 (subscribedStatusyoutubeProduct)의 다양한 값 또는 값의 조합에 대해 정규화되지 않습니다.

예를 들어 subscribedStatus 측정기준을 사용하는 보고서에서는 viewerPercentage 데이터를 구독한 조회수에 대해 최대 100%를 더한 만큼 추가하고 userPercentage 10}{/1{/1{/1{/id 데이터를 각 비율의 뷰어 비율로 표시합니다. 보고서의 모든 viewerPercentage 필드의 총 값은 200%입니다.

필터를 사용하여 보고서에 재생 세부정보 측정기준에 대한 하나의 값(또는 값의 조합)에 대한 viewerPercentage 데이터만 포함하도록 할 수 있습니다.

상위 재생목록

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

이 보고서는 지정된 필터링 및 정렬 기준에 따라 채널의 인기 재생목록을 표시합니다.

목차
크기:
필수 재생목록
측정항목:
1개 이상 사용 조회수, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
필터:
필수 isCurated==1
0 또는 1 사용 국가, 시/도, 대륙, 아대륙
0 이상을 사용하세요. 재생목록, subscribeStatusStatus, youtubeProduct
정렬 옵션: -조회수
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-재생목록 시작

광고 실적 보고서

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

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

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

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

광고 유형별 광고 실적

목차
크기:
필수 adType
선택사항
측정항목:
1개 이상 사용 총수익, adImpressions, cpm
필터:
0 또는 1 사용 동영상, 그룹
0 또는 1 사용 국가, 대륙, 아대륙