이 페이지는 Cloud Translation API를 통해 번역되었습니다.

샘플 API 요청

이 페이지에서는 샘플 YouTube Analytics API 요청을 보여줍니다. 각 예에서는 검색되는 보고서를 간략하게 설명한 다음 해당하는 dimensions, metrics, filters, sort 매개변수 값을 보여줍니다. (채널 보고서 및 콘텐츠 소유자 보고서 문서는 API에서 지원하는 보고서를 식별합니다.)

각 예는 Google API 탐색기에 연결되고 표시된 값으로 채워집니다. 또한 이 예시에서는 기본 시작일 및 종료일 (YYYY-MM-DD)을 2023-09-01 및 2024-03-31로 사용합니다.

API Explorer에 연결한 후에도 보고서를 검색할 채널 또는 콘텐츠 소유자를 지정해야 합니다. API 탐색기는 클릭한 쿼리에 따라 ids 매개변수 값을 channel==MINE 또는 contentOwner==CONTENT_OWNER_ID로 채웁니다. 채널 보고서의 경우 MINE를 인증된 사용자의 채널 ID로 변경할 수 있습니다. 콘텐츠 소유자 보고서의 경우 CONTENT_OWNER_ID를 콘텐츠 소유자 ID로 바꿔야 합니다.

또한 지정된 채널 또는 콘텐츠 소유자로 인증을 받아야 API 탐색기가 OAuth 2.0를 사용하여 API 요청을 승인할 수 있습니다.

여러 측정기준/측정항목으로 요청 정렬하기
채널 보고서
콘텐츠 소유자 보고서

여러 측정기준/측정항목을 기준으로 정렬 요청

API는 여러 측정기준 또는 측정항목을 사용하여 응답 데이터를 정렬할 수 있는 기능을 지원합니다. 예를 들어 아래 요청은 특정 채널의 동영상에 대한 일일 트래픽 소스 데이터를 검색합니다. 결과 집합의 각 행은 특정일에 특정 유형의 트래픽 소스 (예: EXT_URL)에서 발생한 조회수 및 예상 시청 시간을 나타냅니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

응답 결과는 시간순으로 정렬됩니다. 각 날짜의 결과 집합 내에서 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. 따라서 결과 집합의 첫 번째 행에는 요청한 기간의 첫째 날에 조회수가 가장 많이 발생한 트래픽 소스의 데이터가 포함됩니다. 둘째 행은 첫째 날에 그 다음으로 조회수가 많은 트래픽 소스의 데이터를 포함합니다.

채널 보고서

기본 통계

동영상 보고서

채널의 총 조회수, 예상 시청 시간 등

이 쿼리는 채널 콘텐츠의 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

채널의 국가별 조회수 등

이 쿼리는 채널 동영상에 대한 특정 국가의 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

상위 10개 – 채널의 가장 많이 본 동영상

이 쿼리는 지정된 기간 동안 예상 시청 시간(분)으로 측정한 채널에서 가장 많이 본 동영상 상위 10개를 검색합니다. 결과는 예상 감상 시간(분)을 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

상위 10개 – 채널에서 가장 많이 본 동영상의 특수효과 클릭률

이 요청은 채널에서 최다 조회 동영상 상위 10개에 대한 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬되어 가장 많이 본 동영상이 첫 번째로 나열됩니다.

참고: 이 보고서에서는 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

재생목록 보고서

채널의 총 재생목록 조회수

이 요청은 인증된 사용자 채널의 재생목록에 대해 총 재생목록 시작 수, 예상 시청 시간(분), 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목) 및 재생목록 시작당 조회수를 검색합니다.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

특정 재생목록에 대한 통계

이 요청은 특정 재생목록의 총 재생목록 시작 수, 예상 시청 시간(분), 조회수(집계 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목) 및 재생목록 시작당 조회수를 검색합니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 PLAYLIST_ID 문자열을 인증된 사용자 채널에 있는 재생목록의 재생목록 ID로 바꿔야 합니다.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

여러 재생목록에 대한 집계 통계를 검색하려면 PLAYLIST_ID 문자열을 인증된 사용자 채널에 있는 재생목록에 대한 최대 500개의 재생목록 ID가 쉼표로 구분된 목록으로 바꾸면 됩니다.

상위 10개 – 채널에서 가장 많이 시청한 재생목록

이 쿼리는 지정된 기간 동안 재생목록 조회수로 측정한 채널에서 가장 많이 시청한 재생목록 10개를 검색합니다. 또한 각 재생목록의 시청자가 재생을 시작한 횟수, 재생목록이 시작된 후 시청자가 재생목록의 동영상을 시청한 평균 시간과 같은 기타 재생목록 측정항목도 검색합니다. 결과는 재생목록 조회수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 playlist 측정기준을 사용하므로 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수도 10 이하의 정수 값으로 설정해야 합니다.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

시간 기반

동영상 보고서

채널 동영상의 일별 시청 시간 측정항목

이 쿼리는 채널 동영상의 일일 조회수, 시청 시간 측정항목, 신규 구독자 수를 검색합니다. 이 보고서는 요청한 기간의 각 날짜에 대해 데이터 한 행을 반환합니다. 행은 시간순으로 정렬됩니다.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

채널 동영상의 일별 특수효과 측정항목

이 요청은 채널 콘텐츠의 일일 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

재생목록 보고서

채널의 일일 재생목록 조회수

이 요청은 인증된 사용자 채널의 일일 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작 시간, 예상 시청 시간(분), 재생목록 시작당 조회수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

지역

동영상 보고서

채널 동영상의 국가별 시청 시간 측정항목

이 쿼리는 채널 동영상에 대한 국가별 조회수, 시청 시간 측정항목, 구독 수치를 검색합니다. 이 보고서는 채널의 동영상을 시청한 각 국가에 대한 데이터 한 행을 반환합니다. 시청한 시간(분)의 내림차순으로 행이 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

채널 동영상의 국가별 특수효과 통게

이 요청은 채널 동영상에 대한 국가별 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 결과는 특수효과 클릭률을 기준으로 내림차순으로 정렬되어 가장 높은 특수효과 클릭률이 첫 번째로 나열됩니다.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

미국 주와 워싱턴 D.C.의 지역별 측정항목

이 요청은 채널 동영상의 조회수, 예상 시청 시간(분), 평균 시청 지속 시간을 시/도별로 세분화하여 검색합니다. 데이터에는 미국 주와 워싱턴 D.C가 포함됩니다. 결과는 각 주의 ISO 3166-2 코드를 기준으로 알파벳순으로 정렬됩니다.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

상위 10개 – 특정 국가에서 최다 조회 동영상

이 쿼리는 지정된 국가에서 지정된 기간 동안 조회수로 측정된 채널의 최다 조회 동영상 상위 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

총 조회수 기준 미국의 상위 10개 도시

이 쿼리는 지정된 기간 동안 채널 콘텐츠의 조회수가 가장 많은 미국 10개 도시의 목록을 검색합니다. 해당 필터에 다른 유효한 값을 선택하면 다른 국가의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하면 서유럽 또는 동남아시아와 같은 아대륙에 대한 데이터를 가져오도록 쿼리를 수정할 수 있습니다. 다른 필터도 지원됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

각 콘텐츠 유형의 총 조회수별 상위 10개 미국 도시

이 쿼리는 지원되는 각 creatorContentType에 대해 지정된 기간 동안 채널 콘텐츠의 조회수가 가장 많은 미국 10개 도시 목록을 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

총 시청 시간 기준 상위 10개 미국 도시

이 쿼리는 지정된 기간 동안 채널 콘텐츠의 총 일일 시청 시간이 가장 긴 미국의 도시 중 상위 10일의 목록을 검색합니다. 쿼리 결과는 총 시청 시간, 시청 시간이 발생한 날짜, 콘텐츠 조회가 예상되는 도시를 식별합니다. 결과는 총 시청 시간을 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

상위 10개 – 유럽에서 가장 많이 본 동영상

이 쿼리는 지정된 기간 동안 조회수로 측정된 유럽에서 채널의 최다 조회 동영상 상위 10개를 검색합니다. 이 쿼리는 다른 대륙에 대해 유효한 값을 선택하여 해당 필터에 대한 데이터를 요청하도록 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하면 서유럽 또는 동남아시아와 같은 아대륙에 대한 데이터를 가져오도록 쿼리를 수정할 수 있습니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

재생목록 보고서

채널 재생목록에 대한 국가별 시청 시간 측정항목

이 쿼리는 채널 재생목록에 대한 국가별 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목) 및 시청 시간 측정항목을 검색합니다. 이 보고서는 채널의 재생목록을 시청한 각 국가에 대한 데이터 한 행을 반환합니다. 시청한 시간(분)의 내림차순으로 행이 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

상위 10개 – 미국에서 가장 많이 시작된 재생목록

이 쿼리는 지정된 기간 동안 미국 시청자가 가장 자주 시청하기 시작한 재생목록 10개를 검색합니다. 결과는 재생목록 시작 횟수를 기준으로 내림차순으로 정렬됩니다.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

재생 위치

동영상 보고서

다른 재생 위치의 조회수 및 시청 시간

이 쿼리는 특정 채널의 동영상에 대한 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션 유형을 기준으로 집계되며 조회수를 기준으로 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

여러 재생 위치의 일일 조회수 및 시청 시간

이 쿼리는 특정 채널의 동영상에 대한 미국 내 일별 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션의 각 유형에 대해 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

상위 10개 –삽입된 동영상에 대한 조회수가 가장 많은 타사 사이트

이 쿼리는 특정 동영상이나 동영상 그룹의 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 삽입된 제3자 사이트를 기준으로 분류됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상에 대한 하나 이상의 동영상 ID의 쉼표로 구분된 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

재생목록 보고서

여러 재생 위치의 재생목록 조회수 및 시청 시간

이 쿼리는 특정 채널의 재생목록에 대한 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목), 예상 시청 시간, 재생목록 시작 횟수를 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션 유형을 기준으로 집계되며 재생목록 시작을 기준으로 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

여러 재생 위치에서 발생한 일일 재생목록 조회수 및 시청 시간

이 쿼리는 특정 채널 재생목록에 대한 미국 내 일일 재생목록 시작 횟수, 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목) 및 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 페이지 또는 애플리케이션의 각 유형에 대해 일별로 그룹화됩니다. 결과는 시간순으로 정렬됩니다.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

재생 세부정보

동영상 보고서

콘텐츠 유형별 좋아요 및 싫어요

이 쿼리는 채널의 각 콘텐츠 유형에 대한 좋아요 및 싫어요 수를 검색합니다.

dimensions=creatorContentType
metrics=likes,dislikes

트래픽 소스

동영상 보고서

한 국가 내 다른 트래픽 소스의 조회수 및 시청 시간

이 요청은 지정된 국가의 채널 동영상에 대한 조회수 및 예상 시청 시간을 검색합니다. 이 측정항목은 사용자가 동영상을 어떤 경로로 보게 되는지 알려주는 트래픽 소스에서 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

다양한 트래픽 소스의 일일 조회수 및 시청 시간

이 요청은 채널 동영상의 일별 조회수 및 일일 예상 시청 시간을 검색합니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 시간순으로 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어

이 쿼리는 하나 이상의 특정 동영상에 대해 YouTube 검색결과에서 가장 많은 조회수를 발생시킨 검색어 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 쉼표로 구분된 최대 500개의 동영상 ID 목록으로 바꿔야 합니다.

예를 들어 단일 동영상에 대해 검색어를 실행하거나 VIDEO_ID를 대체하여 해당 동영상에서 가장 많은 트래픽을 생성하는 검색어를 찾을 수 있습니다. 또한 특정 재생목록의 모든 동영상을 나열하여 재생목록에 있는 동영상에 대해 가장 많은 트래픽을 생성하는 검색어를 파악할 수도 있습니다.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

상위 10개 – 동영상에 대해 가장 많은 트래픽을 생성하는 외부 웹사이트

이 쿼리는 특정 동영상 또는 동영상 그룹에 대한 조회수가 가장 많이 발생한 외부 웹사이트 10개를 검색합니다. 결과는 예상 시청 시간을 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 쉼표로 구분된 최대 500개의 동영상 ID 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

재생목록 보고서

국가 내 다양한 트래픽 소스의 재생목록 조회수 및 시청 시간

이 요청은 지정된 국가의 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목), 재생목록 시작 횟수, 예상 시청 시간을 검색합니다. 측정항목은 사용자가 재생목록에 도달한 방식을 설명하는 트래픽 소스별로 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

다양한 트래픽 소스에서 발생한 일일 재생목록 조회수 및 시청 시간

이 요청은 채널의 일일 재생목록 조회수 (재생목록 내 측정항목), 재생목록 시작 횟수, 예상 시청 시간을 검색합니다. 또한 총 조회수 (집계된 동영상 측정항목)도 검색합니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 시간순으로 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

기기/OS

동영상 보고서

Android 운영체제의 일별 기기 유형 측정항목

이 쿼리는 특정 채널의 동영상에 대한 Android 기기의 일일 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 기기의 각 유형에 대해 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

모바일 기기의 일별 운영체제 측정항목

이 쿼리는 특정 채널의 동영상에 대한 휴대기기에서 일일 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 각 운영체제의 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

일별 운영체제 및 기기 유형 측정항목

이 쿼리는 채널의 일일 조회수 및 예상 시청 시간을 검색합니다. 통계는 운영체제 및 기기 유형별로 분류되어 있습니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

재생목록 보고서

Android 운영체제의 재생목록 조회수에 대한 일별 기기 유형 측정항목

이 쿼리는 특정 채널의 재생목록에 대한 Android 기기에서 일일 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목) 및 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 각 기기 유형의 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

휴대기기의 재생목록 조회수에 대한 일일 운영체제 측정항목

이 쿼리는 특정 채널의 재생목록에 대해 휴대기기에서 일일 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목) 및 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 각 운영체제의 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

인구통계

동영상 보고서

캘리포니아의 시청자 인구통계 (연령대 및 성별)

이 보고서는 캘리포니아에서 채널의 동영상을 시청한 시청자의 연령대 및 성별에 대한 통계를 검색합니다. 결과는 성별을 기준으로 정렬된 다음 연령대를 기준으로 정렬됩니다. 이 쿼리는 filters 매개변수 값을 조정하여 전 세계 모든 뷰어 또는 국가, 대륙, 아대륙 또는 다른 미국의 모든 뷰어에 대해 동일한 통계를 검색하도록 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

재생목록 보고서

캘리포니아의 재생목록 시청자 인구통계 (연령대 및 성별)

이 보고서는 캘리포니아에 거주하며 채널의 재생목록을 시청한 시청자의 연령대 및 성별에 대한 통계를 검색합니다. 결과는 성별을 기준으로 정렬된 다음 연령대를 기준으로 정렬됩니다. 이 쿼리는 filters 매개변수 값을 조정하여 전 세계 모든 뷰어 또는 국가, 대륙, 아대륙 또는 다른 미국의 모든 뷰어에 대해 동일한 통계를 검색하도록 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

동영상이 공유된 서비스에서 집계한 공유 측정항목

이 요청은 사용자가 Share 버튼을 사용하여 채널의 동영상을 공유한 횟수를 검색합니다. 결과는 공유 서비스(Google+, Twitter 등)에서 집계되며 공유 횟수를 내림차순으로 정렬합니다.

dimensions=sharingService
metrics=shares
sort=-shares

시청 지속 시간

동영상의 시청 지속 시간 측정항목

이 보고서는 동영상의 잠재고객 보유 능력을 측정합니다. 보고서는 한 번에 하나의 동영상에 대해서만 검색할 수 있습니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상 중 하나의 동영상 ID로 바꿔야 합니다. 시청 지속 시간 보고서에서는 video 필터에 여러 값을 지정하는 기능을 지원하지 않습니다.

이 예에서 보고서는 audienceType 필터를 사용하여 동영상 검색 또는 추천 동영상 클릭과 같은 직접적인 사용자 작업의 결과인 자연 조회수 관련 데이터만 포함하도록 응답을 제한합니다. 따라서 보고서에는 TrueView 인스트림 광고 또는 TrueView 디스플레이 광고에서 발생한 조회수 데이터가 포함되지 않습니다. 필터를 삭제하면 모든 잠재고객 유형에서 동영상의 시청 지속 시간 데이터를 가져올 수 있습니다.

audienceType 필터의 데이터는 2013년 9월 25일부터 사용할 수 있습니다. API는 필터를 사용하여 이전 날짜의 데이터를 검색하는 쿼리에 대해서는 데이터를 반환하지 않습니다. 필터를 사용하지 않는 쿼리는 2008년 7월 1일 이후의 모든 데이터에 적용됩니다.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

수익/광고

채널 수익 및 광고 실적 측정항목

이 요청은 채널의 수익 및 광고 실적 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

일일 수익 및 광고 실적 측정항목

이 요청은 채널의 일일 수익 및 광고 실적 측정항목을 검색합니다.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

국가별 수익 및 광고 실적 측정항목

이 요청은 채널의 국가별 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬됩니다. 즉, 파트너의 순수익이 가장 높은 국가가 첫 번째로 나열됩니다.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

상위 10개 – 가장 수익이 높은 동영상

이 요청은 채널에서 수익이 가장 높은 동영상 10개에 대한 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬되어 추정 수익이 가장 높은 동영상이 첫 번째 동영상으로 표시됩니다.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

다른 광고 유형의 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대한 광고 실적 측정항목을 검색합니다. 결과는 광고 유형별로 그룹화되므로, 여러 광고 유형의 수익과 CPM 값을 비교할 수 있습니다.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

콘텐츠 소유자 보고서

기본 통계

동영상 보고서

소유권 주장이 제기된 모든 콘텐츠의 총 조회수, 예상 시청 시간 등

이 쿼리는 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대해 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

직접 업로드한 모든 동영상의 국가별 조회수 등

이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 특정 국가에 대한 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

소유권이 주장된 모든 제3자 콘텐츠의 총 조회수 등

이 쿼리는 콘텐츠 소유자가 소유권을 주장했지만 업로드하지 않은 동영상의 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

직접 업로드한 모든 콘텐츠에 대한 총 조회수 등

이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

소유권이 주장된 직접 업로드한 모든 콘텐츠에 대한 총 조회수 등

이 쿼리는 콘텐츠 소유자가 업로드하고 소유권을 주장한 동영상의 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

상위 10개 – 콘텐츠 소유자의 최다 조회 동영상

이 쿼리는 콘텐츠 소유자가 업로드한 특정 기간의 조회수로 측정한 최다 조회 동영상 상위 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

상위 10개 – 콘텐츠 소유자의 가장 많이 본 동영상

이 쿼리는 지정된 기간 동안 예상 시청 시간(분)으로 측정하여 콘텐츠 소유자가 업로드한 가장 많이 본 동영상 상위 10개를 검색합니다. 결과는 예상 감상 시간(분)을 기준으로 내림차순으로 정렬됩니다.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

상위 10개 – 콘텐츠 소유자 채널의 최다 조회 동영상

이 쿼리는 콘텐츠 소유자가 관리하는 특정 채널 또는 채널 그룹에서 최다 조회 동영상 상위 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

상위 10개 – 채널에서 가장 많이 본 동영상의 특수효과 클릭률

이 요청은 지정된 채널 또는 채널 그룹에서 최다 조회 동영상 10개에 대한 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬되어 가장 많이 본 동영상이 첫 번째로 나열됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

재생목록 보고서

콘텐츠 소유자 채널의 재생목록 조회수

이 요청은 콘텐츠 소유자 채널의 재생목록에 대해 총 재생목록 시작 수, 재생목록 예상 시청 시간(분), 재생목록 조회수, 재생목록 시작당 조회수를 검색합니다. playlistViews 측정항목은 재생목록과 관련된 동영상 조회수만 계산합니다. 요청된 모든 측정항목은 재생목록 내 측정항목이므로 요청에 playlist 또는 group 필터도 포함하지 않아도 됩니다.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

특정 재생목록에 대한 통계

이 요청은 특정 재생목록의 총 재생목록 시작 수, 예상 시청 시간(분), 조회수(집계 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목) 및 재생목록 시작당 조회수를 검색합니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 PLAYLIST_ID 문자열을 콘텐츠 소유자 채널 중 하나에 있는 재생목록의 재생목록 ID로 바꿔야 합니다.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

여러 재생목록에 대한 집계 통계를 검색하려면 PLAYLIST_ID 문자열을 콘텐츠 소유자 채널의 재생목록에 대한 최대 500개의 재생목록 ID가 쉼표로 구분된 목록으로 바꾸면 됩니다.

시간 기반

동영상 보고서

직접 업로드한 콘텐츠에 대한 일별 시청 시간 측정항목

이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 조회수, 수익 창출 재생 횟수, 노출수뿐만 아니라 일별 시청 시간 측정항목을 검색합니다. 이 보고서는 요청한 데이터 범위에서 하루에 데이터 한 행을 반환하며 행은 시간순으로 정렬됩니다.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

소유권이 주장된 콘텐츠에 대한 특수효과 측정항목

이 요청은 콘텐츠 소유자가 소유권을 주장한 콘텐츠에 대한 일별 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

재생목록 보고서

콘텐츠 소유자의 일일 재생목록 조회수

이 요청은 콘텐츠 소유자의 재생목록에 있는 동영상과의 일일 사용자 상호작용에 대한 측정항목을 검색합니다. 보고서에서 가져온 측정항목은 playlistViews, playlistStarts, playlistEstimatedMinutesWatched, viewsPerPlaylistStart입니다. 이러한 측정항목은 모두 재생목록 측정항목입니다. 요청된 모든 측정항목은 재생목록 내 측정항목이므로 요청에 playlist 또는 group 필터도 포함하지 않아도 됩니다.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

지역

동영상 보고서

직접 업로드한 콘텐츠에 대한 국가별 시청 시간 측정항목

이 쿼리는 각 국가의 조회수, 시청 시간 측정항목, 예상 광고 수익을 검색합니다. 콘텐츠 소유자가 업로드한 동영상에 해당하는 측정항목입니다. 이 보고서는 동영상이 시청된 각 국가에 대한 데이터 한 행을 반환하며 행은 시청한 시간(분)을 기준으로 내림차순으로 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

직접 업로드한 콘텐츠에 대한 국가별 특수효과 측정항목

이 요청은 콘텐츠 소유자가 업로드한 동영상에 대한 국가별 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 결과는 특수효과 클릭률을 기준으로 내림차순으로 정렬되어 가장 높은 특수효과 클릭률이 첫 번째로 나열됩니다.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

미국 주와 워싱턴 D.C.의 지역별 측정항목

이 요청은 콘텐츠 소유자가 소유권을 주장한 동영상의 조회수, 예상 시청 시간(분), 평균 시청 지속 시간을 지역별로 세분화하여 검색합니다. 데이터에는 미국 주와 워싱턴 D.C가 포함됩니다. 결과는 각 주의 ISO 3166-2 코드를 기준으로 알파벳순으로 정렬됩니다.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

총 조회수 기준 미국의 상위 10개 도시

이 쿼리는 지정된 기간 동안 콘텐츠 소유자의 소유권 주장이 제기된 동영상에서 가장 많은 조회수를 기록한 미국의 10개 도시 목록을 검색합니다. 해당 필터에 다른 유효한 값을 선택하면 다른 국가의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하면 서유럽 또는 동남아시아와 같은 아대륙에 대한 데이터를 가져오도록 쿼리를 수정할 수 있습니다. 다른 필터도 지원됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

각 콘텐츠 유형의 총 조회수별 상위 10개 미국 도시

이 쿼리는 지원되는 각 creatorContentType에 대해 지정된 기간 동안 콘텐츠 소유자의 소유권이 주장된 콘텐츠가 가장 많이 조회된 미국의 10개 도시 목록을 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

총 시청 시간 기준 상위 10개 미국 도시

이 쿼리는 콘텐츠 소유자가 소유권을 주장한 콘텐츠의 총 일일 시청 시간이 가장 긴 미국의 도시 중 지정된 기간 동안 상위 10일의 목록을 검색합니다. 쿼리 결과는 총 시청 시간, 시청 시간이 발생한 날짜, 콘텐츠 조회가 예상되는 도시를 식별합니다. 결과는 총 시청 시간을 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

상위 10개 – 유럽에서 가장 많이 시청한 동영상

이 쿼리는 지정된 기간 동안 조회수로 측정한 콘텐츠 소유자의 소유권 주장이 제기된 동영상 중 유럽에서 가장 많이 본 동영상 상위 10개를 검색합니다. 이 쿼리는 다른 대륙에 대해 유효한 값을 선택하여 해당 필터에 대한 데이터를 요청하도록 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하면 서유럽 또는 동남아시아와 같은 아대륙에 대한 데이터를 가져오도록 쿼리를 수정할 수 있습니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

재생목록 보고서

콘텐츠 소유자 재생목록에 대한 국가별 시청 시간 측정항목

이 쿼리는 콘텐츠 소유자 채널의 모든 재생목록에 대한 국가별 재생목록 조회수 및 재생목록 시청 시간 측정항목을 검색합니다. 이 보고서는 재생목록을 시청한 각 국가에 관한 데이터 한 행을 반환합니다. 시청한 시간(분)의 내림차순으로 행이 정렬됩니다.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

상위 10개 – 미국에서 가장 많이 시작된 재생목록

이 쿼리는 지정된 기간 동안 미국 시청자가 가장 자주 시청하기 시작한 콘텐츠 소유자의 채널에서 10개의 재생목록을 검색합니다. 결과는 재생목록 시작 횟수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서는 playlist 측정기준을 사용하므로 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수도 10 이하의 정수 값으로 설정해야 합니다.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

재생 세부정보

동영상 보고서

콘텐츠 유형별 좋아요 및 싫어요

이 쿼리는 특정 채널 또는 채널 그룹에서 각 콘텐츠 유형에 대한 좋아요 및 싫어요 수를 검색합니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

재생 위치

동영상 보고서

다른 재생 위치의 조회수 및 시청 시간

이 쿼리는 특정 채널 또는 채널 그룹에 업로드된 동영상의 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션 유형을 기준으로 집계되며 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

여러 재생 위치의 일일 조회수 및 시청 시간

이 쿼리는 특정 채널 또는 채널 그룹에 업로드된 동영상의 미국 내 일별 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션의 각 유형에 대해 일별로 그룹화됩니다. 역시간순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

상위 10개 –삽입된 동영상에 대한 조회수가 가장 많은 타사 사이트

이 쿼리는 특정 동영상이나 동영상 그룹의 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 삽입된 제3자 사이트를 기준으로 분류됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 쉼표로 구분된 최대 500개의 동영상 ID 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

재생목록 보고서

여러 재생 위치의 재생목록 조회수 및 시청 시간

이 쿼리는 콘텐츠 소유자 채널에 있는 모든 재생목록의 재생목록 조회수, 재생목록 예상 시청 시간, 재생목록 시작 횟수를 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션 유형을 기준으로 집계되며 재생목록 시작을 기준으로 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

여러 재생 위치의 재생목록 조회수 및 시청 시간

이 쿼리는 콘텐츠 소유자 채널의 모든 재생목록에 대해 미국에서 일일 재생목록 시작 횟수, 재생목록 조회수, 재생목록 예상 시청 시간을 검색합니다. 결과는 재생목록 조회가 발생한 페이지 또는 애플리케이션 유형별로 반환됩니다.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

트래픽 소스

동영상 보고서

다른 트래픽 소스의 조회수 및 시청 시간

이 요청은 콘텐츠 소유자의 동영상에 대한 조회수 및 예상 시청 시간을 검색합니다. 이 측정항목은 사용자가 동영상을 어떤 경로로 보게 되는지 알려주는 트래픽 소스에서 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

다양한 트래픽 소스의 일일 조회수 및 시청 시간

이 요청은 콘텐츠 소유자의 동영상에 대한 일별 조회수 및 일일 예상 시청 시간을 검색합니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 역시간순으로 최근 항목부터 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

참고: 다음 두 가지 샘플 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스에는 추가 세부정보가 없으므로 해당 소스에 대한 보고서를 사용할 수 없습니다. 이러한 유형의 보고서를 사용할 수 있는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.

상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어

이 쿼리는 특정 동영상이나 동영상 그룹에 대해 YouTube 검색결과에서 가장 많은 조회수를 발생시킨 검색어 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 쉼표로 구분된 최대 500개의 동영상 ID 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

상위 10개 – 동영상에 대해 가장 많은 트래픽을 생성하는 외부 웹사이트

이 쿼리는 특정 동영상 또는 동영상 그룹에 대한 Google 검색결과에서 가장 많은 조회수를 기록한 10개의 외부 웹사이트를 검색합니다. 결과는 예상 시청 시간을 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 쉼표로 구분된 최대 500개의 동영상 ID 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

재생목록 보고서

국가 내 다양한 트래픽 소스의 재생목록 조회수 및 시청 시간

이 요청은 지정된 국가의 재생목록 조회수, 재생목록 시작 횟수, 재생목록 예상 시청 시간을 검색합니다. 측정항목은 사용자가 재생목록에 도달한 방식을 설명하는 트래픽 소스별로 집계됩니다.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

다양한 트래픽 소스의 재생목록 조회수 및 시청 시간

이 요청은 콘텐츠 소유자 채널 중 하나 이상에 있는 재생목록의 재생목록 조회수, 재생목록 시작 횟수, 재생목록 예상 시청 시간을 검색합니다. 측정항목은 트래픽 소스별로 집계됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

기기/OS

동영상 보고서

소유권이 주장된 동영상의 일별 기기 유형 측정항목

이 쿼리는 특정 콘텐츠 소유자가 소유권을 주장한 동영상의 기기 유형별 일일 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 기기의 각 유형에 대해 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

모바일 기기에서 본 소유권이 주장된 동영상의 일별 운영체제 측정항목

이 쿼리는 지정된 콘텐츠 소유자가 소유권을 주장한 동영상이 휴대기기에서 발생한 조회수의 일별 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 각 운영체제의 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

일별 운영체제 및 기기 유형 측정항목

이 쿼리는 특정 콘텐츠 소유자가 소유권을 주장한 동영상의 일별 조회수 및 예상 시청 시간을 검색합니다. 통계는 운영체제 및 기기 유형별로 분류되어 있습니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

재생목록 보고서

Android 운영체제에서 재생목록 조회수에 대한 기기 유형 측정항목

이 쿼리는 하나 이상의 콘텐츠 소유자 채널에 있는 재생목록에 대해 Android 기기에서 재생목록 조회수 및 재생목록 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 각 기기 유형에 대해 반환됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 쉼표로 구분된 채널 ID(최대 500개)의 목록으로 바꿔야 합니다.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

휴대기기의 재생목록 조회수에 대한 운영체제 측정항목

이 쿼리는 콘텐츠 소유자 채널에 있는 재생목록에 대해 휴대기기에서 재생목록 조회수 및 재생목록 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 각 운영체제에 대해 반환됩니다.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

인구통계

동영상 보고서

캘리포니아의 시청자 인구통계 (연령대 및 성별)

이 보고서는 콘텐츠 소유자의 소유권이 주장된 콘텐츠를 시청한 캘리포니아 시청자의 연령대 및 성별에 대한 통계를 가져옵니다. 결과는 성별을 기준으로 정렬된 다음 연령대를 기준으로 정렬됩니다. 이 쿼리는 filters 매개변수 값을 조정하여 전 세계 모든 뷰어 또는 국가, 대륙, 아대륙 또는 다른 미국의 모든 뷰어에 대해 동일한 통계를 검색하도록 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

동영상이 공유된 서비스에서 집계한 공유 측정항목

이 요청은 콘텐츠 소유자가 업로드한 동영상을 사용자가 Share 버튼을 사용하여 공유한 횟수를 검색합니다. 결과는 공유 서비스(Google+, Twitter 등)에서 집계되며 공유 횟수를 내림차순으로 정렬합니다.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

시청 지속 시간

동영상의 시청 지속 시간 측정항목

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

수익/광고

소유권 주장이 제기된 콘텐츠의 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠에 대한 수익 및 광고 실적 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

일일 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대한 일별 수익 및 광고 실적 측정항목을 검색합니다.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

국가별 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대한 국가별 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬됩니다. 즉, 파트너의 예상 수익이 가장 높은 국가가 첫 번째로 나열됩니다.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

상위 10개 – 가장 수익이 높은 동영상

이 요청은 콘텐츠 소유자가 소유권을 주장하고 수익이 가장 높은 동영상 10개의 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬되어 추정 수익이 가장 높은 동영상이 첫 번째 동영상으로 표시됩니다.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

다른 광고 유형의 광고 실적 측정항목

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType