Dimensions

이 문서에서는 YouTube Analytics API가 지원하는 측정기준을 정의합니다. 이 API는 실시간 타겟팅 쿼리를 지원하여 맞춤 YouTube 분석 보고서를 생성합니다.

측정기준은 사용자 활동이 발생한 날짜 또는 사용자가 위치한 국가와 같이 데이터를 집계하는 데 사용되는 일반적인 기준입니다.

각 쿼리 보고서는 지원하는 측정기준을 식별합니다. 예를 들어 시간별 사용자 활동을 검색할 때 데이터가 보고될 기간(일 또는 월)을 선택합니다. 보고서의 각 데이터 행에는 측정기준 값의 고유한 조합이 있습니다.

쿼리 보고서를 가져오려면 YouTube 분석 API의 reports.query 메서드를 호출합니다. 요청에서 dimensions 매개변수를 사용하여 YouTube가 보고서의 측정항목 값을 계산하는 데 사용할 측정기준을 지정합니다.

핵심 측정기준

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

다음 목록은 API의 핵심 측정기준을 나타냅니다.

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

필터

모든 쿼리 보고서에서 필터를 지원합니다. 필터는 검색된 데이터 세트에 있어야 하는 측정기준 값을 식별합니다. 따라서 API 응답이 특정 값 또는 값 집합과 일치하는 데이터만 포함하도록 제한합니다. 예를 들어 모든 국가의 사용자 활동 측정항목을 검색하는 대신 필터를 사용하여 특정 국가의 데이터만 검색할 수 있습니다.

쿼리 보고서를 검색하기 위한 요청에서 선택사항인 filters 요청 매개변수는 데이터를 필터링할 측정기준 값을 지정합니다. 예를 들어 유럽의 사용자 활동 측정항목을 검색하려면 filters 매개변수 값을 continent==150로 설정합니다.

중요: 콘텐츠 소유자 보고서를 검색하기 위한 API 요청은 보고 항목 측정기준 중 하나를 사용하거나 지원되는 claimedStatus 및 uploaderType 측정기준 조합을 사용하여 데이터를 필터링해야 합니다.

측정기준

다음 섹션에서는 YouTube Analytics API의 쿼리 보고서에 사용되는 측정기준을 정의합니다. 달리 명시되지 않는 한 이러한 측정기준은 채널 및 콘텐츠 소유자 보고서 모두에서 사용됩니다. 필터로만 사용할 수 있는 측정기준도 식별됩니다.

리소스

이러한 측정기준은 채널 및 콘텐츠 소유자가 YouTube에서 관리하는 리소스에 해당합니다.

참고: API를 사용하면 video, playlist, channel 측정기준을 필터로 사용할 때 여러 개의 값을 지정할 수 있습니다. 이렇게 하려면 filters 매개변수 값을 API 응답을 필터링할 동영상, 재생목록 또는 채널 ID의 쉼표로 구분된 목록으로 설정합니다. 매개변수 값은 최대 500개의 ID를 지정할 수 있습니다.

동영상 (핵심 측정기준)
YouTube 동영상의 ID입니다. YouTube Data API에서는 video 리소스의 id 속성 값입니다. This is a core dimension and is subject to the Deprecation Policy.
재생목록
YouTube 재생목록의 ID입니다. YouTube Data API에서 이는 playlist 리소스의 id 속성 값입니다.
채널 (핵심 측정기준) (콘텐츠 소유자 보고서에만 사용됨)
YouTube 채널의 ID입니다. YouTube Data API에서는 channel 리소스의 id 속성 값입니다. This is a core dimension and is subject to the Deprecation Policy.

channel 측정기준은 일반적으로 여러 채널의 데이터를 집계하는 콘텐츠 소유자 보고서에서 자주 사용됩니다.
그룹 (필터만 해당)
YouTube 분석 그룹의 ID입니다. YouTube 분석 API의 groups.list 메서드를 사용하여 이 값을 검색할 수 있습니다. group 필터를 사용하면 API 응답에 해당 그룹의 모든 동영상, 재생목록 또는 채널에 대한 데이터가 포함됩니다.

예

다음 샘플 요청은 보고 항목 측정기준 또는 필터를 사용합니다.

  • 채널 예

    • 기본 통계
      • 상위 10개 – 채널의 가장 많이 본 동영상
      • 상위 10개 – 채널에서 조회수가 가장 많은 동영상의 특수효과 클릭률
      • 특정 재생목록의 통계
      • 인기 급상승 10위 – 채널에서 가장 많이 시청된 재생목록
    • 지역
      • 상위 10개 – 특정 국가에서 최다 조회 동영상
      • 인기 급상승 – 유럽에서 가장 많이 본 동영상

  • 콘텐츠 소유자 예시

    • 기본 통계
      • 인기 10개 - 콘텐츠 소유자의 조회수가 가장 많은 동영상
      • 인기 급상승 - 콘텐츠 소유자의 조회수가 가장 많은 동영상
      • 인기 급상승 - 콘텐츠 소유자 채널에서 가장 많이 본 동영상
      • 상위 10개 – 채널에서 조회수가 가장 많은 동영상의 특수효과 클릭률
      • 인기 급상승 – 콘텐츠 소유자의 재생목록 중 가장 많이 시청된 재생목록
    • 지역
      • 인기 급상승 - 유럽에서 콘텐츠 소유자의 동영상 중 가장 많이 시청된 동영상
      • 인기 급상승 – 미국에서 가장 많이 시작한 재생목록 10개

지역

이 측정기준은 사용자 활동, 광고 실적 또는 예상 수익 측정항목과 연결된 지역을 식별합니다.

국가 (핵심 측정기준)
보고서 행의 측정항목과 연결된 국가입니다. 측정기준 값은 US, CN (중국), FR (프랑스)와 같은 두 글자 ISO-3166-1 국가 코드입니다. 국가 코드 ZZ는 YouTube에서 연결된 국가를 식별할 수 없는 측정항목을 보고하는 데 사용됩니다. This is a core dimension and is subject to the Deprecation Policy.
province
보고서 행의 측정항목과 연결된 미국 주 또는 지역입니다. 측정기준 값은 미국 주 또는 워싱턴 D.C. 를 식별하는 ISO 3166-2 코드입니다(예: US-MI(미시간) 또는 US-TX(텍사스)). 주 코드 US-ZZ는 YouTube에서 연결된 미국 주를 식별할 수 없는 측정항목을 보고하는 데 사용됩니다. API 요청의 dimensions 매개변수 값에 province가 포함된 경우 요청은 filters 매개변수 값에 country==US를 포함하여 데이터를 미국으로 제한해야 합니다.

참고: 이 측정기준은 미국 외곽 지역을 식별하는 ISO 3166-2 값을 지원하지 않습니다. 해당 지역에는 자체 ISO 3166-1 국가 코드가 있기 때문입니다. 또한 미국 이외 국가의 하위 행정 구역은 지원되지 않습니다.

dma
Nielsen에서 데이터 행에 설명된 시청 이벤트와 연결된 지정 시장 지역 (DMA)을 식별하는 데 사용하는 3자리 식별자입니다.
city
보고서 행의 측정항목과 연결된 예상 도시입니다. 이 측정기준의 데이터는 2022년 1월 1일부터 사용할 수 있습니다.
continent (필터만 해당)
유엔 (UN) 통계 지역 코드입니다. API는 다음 값을 지원합니다.
값
002 아프리카
019 아메리카 (북미, 라틴 아메리카, 남미, 카리브해)
142 아시아
150 유럽
009 오세아니아
이 측정기준은 데이터를 필터링하는 데만 사용할 수 있습니다. 이 측정기준을 사용하려면 filters 매개변수의 값을 continent==REGION_CODE로 설정하여 표에서 REGION_CODE 값을 지정합니다.
subContinent (필터만 해당)
지리적 하위 지역을 식별하는 UN 통계 지역 코드입니다. UN 통계 부서에는 하위 지역과 각 지역과 연결된 국가가 나열되어 있습니다.

이 측정기준은 데이터를 필터링하는 데만 사용할 수 있습니다. 이 측정기준을 사용하려면 filters 매개변수의 값을 subContinent==REGION_CODE로 설정하고 UN 목록에서 REGION_CODE 값을 지정합니다.

예

다음 샘플 요청은 지역 측정기준 또는 필터를 사용합니다.

  • 채널 예

    • 기본 통계: 채널의 국가별 조회수 등
    • 지역
      • 채널 동영상의 국가별 시청 시간 측정항목
      • 채널 동영상의 국가별 특수효과 통게
      • 미국 주 및 워싱턴 D.C.의 도별 측정항목
      • 채널 재생목록의 국가별 시청 시간 측정항목
      • 인기 급상승 – 미국에서 가장 많이 시작한 재생목록 10개
    • 재생 위치: 다양한 재생 위치의 일일 조회수 및 시청 시간
    • 트래픽 소스: 국가의 다양한 트래픽 소스에서 발생한 조회수 및 시청 시간
    • 인구통계: 캘리포니아의 시청자 인구통계 (연령대 및 성별)
    • 인기 동영상
      • 상위 10개 – 특정 국가에서 최다 조회 동영상
      • 인기 급상승 – 유럽에서 가장 많이 본 동영상

  • 콘텐츠 소유자 예시

    • 기본 통계: 직접 업로드한 모든 동영상의 국가별 조회수 등
    • 지역
      • 직접 업로드한 콘텐츠에 대한 국가별 시청 시간 측정항목
      • 직접 업로드한 콘텐츠에 대한 국가별 특수효과 측정항목
      • 미국 주 및 워싱턴 D.C.의 도별 측정항목
      • 콘텐츠 소유자의 재생목록에 대한 국가별 시청 시간 측정항목
      • 인기 급상승 – 미국에서 가장 많이 시작한 재생목록 10개
    • 재생 위치: 다양한 재생 위치의 일일 조회수 및 시청 시간
    • 인구통계: 캘리포니아의 시청자 인구통계 (연령대 및 성별)
    • 인기 동영상: 인기 급상승 – 콘텐츠 소유자의 유럽 내 조회수 기준 인기 동영상 10개
    • 수익/광고 실적: 국가별 수익 및 광고 실적 측정항목

기간

이러한 측정기준은 보고서에서 일, 주, 월과 같은 기간을 기준으로 데이터를 집계해야 함을 나타냅니다. startDate 및 endDate 요청 매개변수는 보고서에 데이터가 포함되는 기간을 지정합니다. 보고서는 실제로 쿼리가 실행될 때 요청에 지정된 모든 측정항목을 사용할 수 있는 마지막 날짜까지의 데이터를 반환합니다. 보고서에서는 날짜가 YYYY-MM-DD 형식으로 표시됩니다.

중요: 모든 날짜는 태평양 표준시 (UTC-7 또는 UTC-8) 기준 오전 12시부터 지정된 일, 월, 년의 태평양 표준시 기준 오후 11시 59분까지의 기간을 나타냅니다. 따라서 일광 절약 시간으로 시계가 조정되는 날짜는 23시간 기간을 나타내고 시계가 뒤로 조정되는 날짜는 25시간 기간을 나타냅니다.

월 측정기준은 지정된 월 및 연도의 첫 번째 날 태평양 표준시 (UTC-7 또는 UTC-8) 오전 12시부터 시작되는 기간을 나타냅니다.

일 (핵심 측정기준)
이 측정기준을 사용하면 보고서의 데이터가 매일 집계되며 각 행에는 하루의 데이터가 포함됩니다. 다른 측정기준을 사용하여 데이터를 더 세부적으로 분류할 수 있습니다. 예를 들어 트래픽 소스 보고서는 사용자가 동영상에 도달하는 방식을 기반으로 일일 시청 통계를 집계할 수 있습니다. This is a core dimension and is subject to the Deprecation Policy.
월 (핵심 측정기준)
보고서의 데이터는 월별로 집계됩니다. 일일 보고서에서처럼 다른 필터를 사용하여 데이터를 보다 상세하게 분류할 수 있습니다. 보고서에서는 날짜가 YYYY-MM 형식으로 표시됩니다.

참고: API 쿼리에서 month 측정기준을 사용하는 경우 start-date 및 end-date 매개변수를 모두 매월 1일로 설정해야 합니다. This is a core dimension and is subject to the Deprecation Policy.

예

다음 샘플 요청은 시간적 측정기준 또는 필터를 사용합니다.

  • 채널 예

    • 시간 기반
      • 채널 동영상의 일별 시청 시간 측정항목
      • 채널 동영상의 일별 특수효과 측정항목
      • 채널의 일일 재생목록 조회수
    • 재생 위치: 다양한 재생 위치의 일일 조회수 및 시청 시간
    • 트래픽 소스: 다양한 트래픽 소스의 일일 조회수 및 시청 시간
    • 기기/OS
      • Android 운영체제의 일별 기기 유형 측정항목
      • 모바일 기기의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목

  • 콘텐츠 소유자 예시

    • 시간 기반
      • 직접 업로드한 콘텐츠에 대한 일별 시청 시간 측정항목
      • 소유권이 주장된 콘텐츠에 대한 특수효과 측정항목
      • 콘텐츠 소유자의 일일 재생목록 조회수
    • 재생 위치: 다양한 재생 위치의 일일 조회수 및 시청 시간
    • 트래픽 소스: 다양한 트래픽 소스의 일일 조회수 및 시청 시간
    • 기기/OS
      • 소유권이 주장된 동영상의 일별 기기 유형 측정항목
      • 모바일 기기에서 본 소유권이 주장된 동영상의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목
    • 수익/광고 실적: 일일 수익 및 광고 실적 측정항목

재생 위치

이러한 측정기준은 사용자 활동이 발생한 페이지 또는 애플리케이션에 대한 통계를 제공합니다.

insightPlaybackLocationType
보고서의 데이터는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형을 기준으로 집계됩니다. 이 측정기준에 가능한 값은 다음과 같습니다.

  • BROWSE – YouTube 홈페이지 또는 홈 화면, 사용자의 구독 피드 또는 다른 YouTube 탐색 기능에서 발생한 조회수를 나타내는 데이터입니다.

  • CHANNEL – 채널 페이지에서 발생한 조회수를 나타내는 데이터입니다.

  • EMBEDDED – <iframe> 또는 <object> 삽입을 사용하여 동영상이 삽입된 다른 웹사이트 또는 애플리케이션에서 발생한 조회수를 나타냅니다.

  • EXTERNAL_APP – <iframe> 또는 <object> 삽입 외의 방법을 사용하여 동영상이 재생된 서드 파티 애플리케이션에서 발생한 조회수를 나타냅니다. 예를 들어 YouTube Android Player API를 사용하는 애플리케이션의 재생은 이 값을 사용하여 분류됩니다.

  • MOBILE – YouTube 모바일 웹사이트 또는 휴대기기를 포함한 승인된 YouTube API 클라이언트에서 발생한 조회수를 나타내는 데이터입니다.

    2013년 9월 10일부터 재생이 더 이상 YouTube 분석 보고서에서 MOBILE 재생으로 분류되지 않습니다. 기존 데이터가 해당 카테고리에 속하므로 값이 보고서에 계속 표시될 수 있습니다. 그러나 이 날짜 이후에는 모바일 재생이 재생이 발생하는 애플리케이션 유형에 따라 WATCH, EMBEDDED 또는 EXTERNAL_APP 재생으로 분류됩니다.

  • SEARCH – YouTube 검색 결과 페이지에서 직접 발생한 조회수를 나타내는 데이터입니다.

  • WATCH – 동영상의 YouTube 보기 페이지 또는 YouTube Android 앱과 같은 공식 YouTube 애플리케이션에서 발생한 조회수를 나타내는 데이터입니다.

  • YT_OTHER – 데이터가 달리 분류되지 않은 조회수를 나타냅니다.

insightPlaybackLocationDetail
데이터는 플레이어가 있는 페이지를 기준으로 집계됩니다. 이 보고서는 삽입된 플레이어에서 발생한 조회수에 대해서만 지원되며, 지정된 동영상에서 가장 많은 조회수를 발생시킨 삽입된 플레이어를 식별합니다. 따라서, 이 보고서에서는 최상위 내장 플레이어와 연결된 URL 또는 애플리케이션을 식별하여 재생 위치 보고서보다 더 자세하게 볼 수 있습니다.

예

다음은 재생 위치 측정기준을 사용하는 샘플 요청입니다.

  • 채널 예

    • 재생 위치
      • 다른 재생 위치의 조회수 및 시청 시간
      • 다양한 재생 위치의 일일 조회수 및 시청 시간
      • 상위 10개 – 삽입된 동영상에 대한 조회수가 가장 많이 발생한 타사 사이트
      • 재생 위치별 재생목록 조회수 및 시청 시간
      • 다양한 재생 위치의 일일 재생목록 조회수 및 시청 시간

  • 콘텐츠 소유자 예시

    • 재생 위치
      • 다른 재생 위치의 조회수 및 시청 시간
      • 다양한 재생 위치의 일일 조회수 및 시청 시간
      • 상위 10개 – 삽입된 동영상에 대한 조회수가 가장 많이 발생한 타사 사이트
      • 재생 위치별 재생목록 조회수 및 시청 시간
      • 다양한 재생 위치의 일일 재생목록 조회수 및 시청 시간

재생 세부정보

creatorContentType
이 측정기준은 데이터 행의 사용자 활동 측정항목과 연결된 콘텐츠 유형을 식별합니다. 이 측정기준에 대한 데이터는 2019년 1월 1일부터 사용할 수 있습니다.

다음 표에는 측정기준 값이 나와 있습니다.
값
LIVE_STREAM 시청한 콘텐츠는 YouTube 라이브 스트림이었습니다.
SHORTS 시청한 콘텐츠는 YouTube Shorts 동영상이었습니다.
STORY 시청한 콘텐츠는 YouTube 스토리였습니다.
VIDEO_ON_DEMAND 조회된 콘텐츠가 다른 측정기준 값에 해당하지 않는 YouTube 동영상이었습니다.
UNSPECIFIED 조회된 콘텐츠의 콘텐츠 유형을 알 수 없습니다.
liveOrOnDemand
이 측정기준은 데이터 행의 사용자 활동 측정항목이 라이브 방송 조회와 연결되어 있는지 여부를 나타냅니다. 이 측정기준에 대한 데이터는 2014년 4월 1일부터 사용할 수 있습니다.

다음 표에는 측정기준 값이 나와 있습니다.
값
LIVE 행의 데이터는 라이브 방송 중에 발생한 사용자 활동을 설명합니다.
ON_DEMAND 행의 데이터는 라이브 방송 중에 발생하지 않은 사용자 활동을 나타냅니다.
subscribedStatus
이 측정기준은 데이터 행의 사용자 활동 측정항목이 동영상 또는 재생목록의 채널을 구독한 시청자와 연결되어 있는지 나타냅니다. 가능한 값은 SUBSCRIBED, UNSUBSCRIBED입니다.

측정기준 값은 사용자 활동이 발생한 시점의 값으로 정확합니다. 예를 들어 사용자가 채널을 구독하지 않은 상태에서 채널의 동영상 중 하나를 시청한 후 같은 날 채널을 구독하고 다른 동영상을 시청했다고 가정해 보겠습니다. 채널 보고서에 따르면 조회수 1개에는 subscribedStatus 값이 SUBSCRIBED이고 조회수 1개에는 subscribedStatus 값이 UNSUBSCRIBED입니다.
youtubeProduct
이 측정기준은 사용자 활동이 발생한 YouTube 서비스를 식별합니다. 이 측정기준의 데이터는 2015년 7월 18일부터 사용할 수 있습니다.

다음 표에는 측정기준 값이 나와 있습니다.
값
CORE 전문 YouTube 애플리케이션 (YouTube Gaming, YouTube Kids, YouTube Music) 중 하나에서 발생하지 않은 사용자 활동입니다. 예외: 2021년 3월 1일 이전에 YouTube Music에서 발생한 사용자 활동은 CORE에 포함됩니다.
GAMING YouTube Gaming에서 사용자 활동이 발생했습니다.
KIDS YouTube Kids에서 발생한 사용자 활동입니다.
MUSIC 2021년 3월 1일 이후에 YouTube Music에서 사용자 활동이 발생했습니다. 2021년 3월 1일 이전의 데이터는 CORE에 포함됩니다. 실시간 데이터는 기록되지 않습니다.
UNKNOWN 2015년 7월 18일 이전에 발생한 사용자 활동

트래픽 소스

insightTrafficSourceType
보고서의 데이터는 사용자가 동영상에 도달한 방식을 설명하는 리퍼러 유형을 기준으로 집계됩니다. 이 측정기준에 가능한 값은 다음과 같습니다.
  • ADVERTISING – 시청자가 광고를 통해 동영상으로 유입되었습니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드에서 광고 유형을 식별합니다.
  • ANNOTATION – 시청자가 다른 동영상의 주석을 클릭하여 이 동영상에 도달했습니다.
  • CAMPAIGN_CARD – 콘텐츠 소유자가 조회된 콘텐츠를 홍보하는 데 사용한 소유권 주장이 제기된 사용자 업로드 동영상에서 발생한 조회수입니다. 이 트래픽 소스는 콘텐츠 소유자 보고서에만 지원됩니다.
  • END_SCREEN – 다른 동영상의 최종 화면에서 추천된 조회수입니다.
  • EXT_URL – 다른 웹사이트의 링크에서 발생한 동영상 조회입니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드가 웹페이지를 식별합니다. 이 트래픽 소스에는 Google 검색 결과의 추천이 포함됩니다.
  • HASHTAGS – VOD 해시태그 페이지 또는 Shorts 해시태그 피벗 페이지에서 발생한 조회수입니다.
  • LIVE_REDIRECT - 동영상 조회수가 라이브 리디렉션에서 발생했습니다.
  • NO_LINK_EMBEDDED – 동영상이 조회될 때 다른 웹사이트에 삽입되었습니다.
  • NO_LINK_OTHER – YouTube에서 트래픽의 추천 사이트를 식별하지 못했습니다. 이 카테고리는 모바일 앱의 트래픽뿐 아니라 동영상에 대한 직접 트래픽도 포함합니다.
  • NOTIFICATION – YouTube의 이메일 또는 알림에서 추천된 동영상 조회수입니다.
  • PLAYLIST – 동영상이 재생목록의 일부로 재생되는 동안 동영상 조회가 발생했습니다. 재생목록 페이지에서 발생한 트래픽이 여기에 포함됩니다.
  • PRODUCT_PAGE - 제품 페이지에서 추천된 동영상 조회수입니다.
  • PROMOTED – YouTube '스포트라이트 동영상' 페이지와 같은 무료 YouTube 프로모션에서 발생한 동영상 조회입니다.
  • RELATED_VIDEO – 다른 동영상 보기 페이지의 관련 동영상 목록에서 추천된 동영상 조회수입니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드에 해당 동영상의 동영상 ID가 지정됩니다.
  • SHORTS – 시청자가 Shorts 시청 환경에서 이전 동영상에서 세로로 스와이프하여 추천되었습니다.
  • SOUND_PAGE – Shorts 사운드 피벗 페이지에서 발생한 조회수입니다.
  • SUBSCRIBER – YouTube 홈페이지의 피드 또는 YouTube 구독 기능에서 발생한 동영상 조회입니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드는 조회수가 발생한 홈페이지 피드 항목 또는 기타 페이지를 지정합니다.
  • YT_CHANNEL – 채널 페이지에서 동영상 조회가 발생했습니다. 이 트래픽 소스를 기준으로 필터링하는 경우 insightTrafficSourceDetail 필드는 해당 채널의 채널 ID를 지정합니다.
  • YT_OTHER_PAGE – YouTube 페이지에 표시된 검색 결과 또는 관련 동영상 링크가 아닌 링크에서 동영상 조회가 발생했습니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드가 페이지를 식별합니다.
  • YT_SEARCH – YouTube 검색 결과에서 발생한 동영상 조회수입니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드에 검색어가 지정됩니다.
  • VIDEO_REMIXES – Shorts 플레이어의 리믹스 동영상 링크에서 동영상 조회수가 발생했습니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드에 시청자가 추천된 동영상이 지정됩니다.
insightTrafficSourceDetail
보고서의 데이터는 지정된 동영상과 지정된 트래픽 소스 유형에서 가장 많은 조회수를 발생시킨 리퍼러를 기준으로 집계됩니다. 다음 목록에는 이 보고서를 사용할 수 있는 트래픽 소스가 나와 있습니다. 이 목록은 각 트래픽 소스에 대해 insightTrafficSourceDetail 측정기준이 제공하는 정보를 식별합니다.
  • ADVERTISING – 조회로 이어진 광고 유형입니다. 가능한 값은 다음과 같습니다.
    • 클릭 투 플레이 참여 광고
    • 참여 광고
    • Google 검색 광고
    • 홈페이지 동영상 광고
    • 예약된 건너뛸 수 있는 인스트림 광고
    • TrueView 검색 광고 및 디스플레이 광고
    • TrueView 인스트림 광고
    • 지정된 카테고리가 없는 YouTube 광고
    • 동영상 컬렉션 미리보기
  • CAMPAIGN_CARD – 시청자를 보고서에 명시된 동영상으로 안내한 소유권 주장이 제기된 동영상입니다.
  • END_SCREEN – 시청자가 신고에 명시된 동영상으로 이동하게 된 동영상입니다.
  • EXT_URL – 시청자를 동영상으로 안내한 웹사이트입니다.
  • HASHTAGS – 조회로 이어진 해시태그입니다.
  • NOTIFICATION – 트래픽을 안내한 이메일 또는 알림입니다.
  • RELATED_VIDEO – 시청자를 보고서에 포함된 동영상으로 안내한 관련 동영상입니다.
  • SOUND_PAGE – 조회로 이어진 동영상입니다.
  • SUBSCRIBER – 시청자를 보고서에 포함된 동영상으로 유도한 홈페이지 피드 항목 또는 YouTube 구독 기능입니다. 유효한 값은 다음과 같습니다.
    • activity – 업로드 및 소셜 채널 활동이 아닌 활동(예: 좋아요, 즐겨찾기, 게시판 게시물, 재생목록 추가)으로 인해 발생한 홈페이지 구독 피드의 항목 조회수입니다.
    • blogged – 인기 블로그의 링크로 인해 홈페이지 구독 피드의 항목에서 발생한 조회수입니다.
    • mychannel – '좋아요', '시청 기록', '나중에 볼 동영상'과 같이 홈페이지에 표시된 다른 피드의 항목에서 발생한 조회수입니다.
    • podcasts: 팟캐스트 도착 페이지의 항목에서 발생한 조회수입니다.
    • sdig – 구독 업데이트 이메일에서 발생한 조회수입니다.
    • uploaded – 홈페이지 구독 피드의 uploaded 항목에서 발생한 조회수입니다.
    • / – YouTube 홈페이지에서 발생한 기타 조회수입니다.
    • /my_subscriptions – YouTube의 사용자 내 구독 페이지에서 발생한 조회수입니다.
  • YT_CHANNEL – 시청자가 동영상을 시청한 채널 페이지입니다.
  • YT_OTHER_PAGE – 시청자가 동영상으로 유도된 YouTube 페이지입니다.
  • YT_SEARCH – 시청자를 동영상으로 유도한 검색어입니다.
  • VIDEO_REMIXES – 조회로 이어진 동영상입니다.

예

다음은 트래픽 소스 측정기준을 사용하는 샘플 요청입니다.

  • 채널 예

    • 트래픽 소스
      • 한 국가 내 다른 트래픽 소스의 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 조회수 및 시청 시간
      • 상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어
      • 인기 검색어 10개 – 동영상에 가장 많은 트래픽을 유도하는 Google 검색어
      • 국가의 여러 트래픽 소스에서 발생한 재생목록 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 재생목록 조회수 및 시청 시간

  • 콘텐츠 소유자 예시

    • 트래픽 소스
      • 다른 트래픽 소스의 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 조회수 및 시청 시간
      • 상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어
      • 인기 검색어 10개 – 동영상에 가장 많은 트래픽을 유도하는 Google 검색어
      • 국가의 여러 트래픽 소스에서 발생한 재생목록 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 재생목록 조회수 및 시청 시간

기기

deviceType
이 측정기준은 뷰가 발생한 기기의 물리적 폼 팩터를 식별합니다. 다음 목록에는 API가 데이터를 반환하는 기기 유형이 나와 있습니다. deviceType 측정기준을 필터로 사용하여 운영체제 보고서에 특정 유형의 기기 데이터만 포함되도록 제한할 수도 있습니다.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
이 측정기준은 조회가 발생한 기기의 소프트웨어 시스템을 식별합니다. 다음 목록에는 API가 데이터를 반환하는 운영체제가 나와 있습니다. operatingSystem를 필터로 사용하여 기기 유형 보고서에 특정 운영체제의 데이터만 포함되도록 제한할 수도 있습니다.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

예

다음은 기기 측정기준을 사용하는 샘플 요청입니다.

  • 채널 예

    • 기기/OS
      • Android 운영체제의 일별 기기 유형 측정항목
      • 모바일 기기의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목
      • Android 운영체제의 재생목록 조회수에 대한 일일 기기 유형 측정항목
      • 휴대기기의 재생목록 조회수에 대한 일일 운영체제 측정항목

  • 콘텐츠 소유자 예시

    • 기기/OS
      • 소유권이 주장된 동영상의 일별 기기 유형 측정항목
      • 모바일 기기에서 본 소유권이 주장된 동영상의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목
      • Android 운영체제의 재생목록 조회수에 대한 일일 기기 유형 측정항목
      • 휴대기기의 재생목록 조회수에 대한 일일 운영체제 측정항목

인구통계

인구통계 측정기준을 사용하면 시청자의 연령대 및 성별 분포를 파악할 수 있습니다. YouTube Analytics 보고서의 인구통계 데이터에 대한 자세한 내용은 YouTube 고객센터를 참고하세요.

ageGroup (핵심 측정기준)
이 측정기준은 보고서 데이터와 연결된 로그인 사용자의 연령대를 나타냅니다. API는 다음과 같은 연령대를 사용합니다.
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
gender (핵심 측정기준)
이 측정기준은 보고서 데이터와 연결된 로그인 사용자의 성별을 식별합니다. 유효한 값은 female, male, user_specified입니다. This is a core dimension and is subject to the Deprecation Policy.

예

다음은 인구통계 측정기준을 사용하는 샘플 요청입니다.

  • 채널 예

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

  • 콘텐츠 소유자 예시

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

참여도 및 콘텐츠 공유

sharingService (핵심 측정기준)
이 측정기준은 동영상을 공유하는 데 사용된 서비스를 식별합니다. '공유' 버튼을 사용하여 YouTube 또는 YouTube 플레이어를 통해 동영상을 공유할 수 있습니다. This is a core dimension and is subject to the Deprecation Policy.

다음 표에는 유효한 측정기준 값이 나와 있습니다.
공유 서비스 API 값
Ameba AMEBA
Android 이메일 ANDROID_EMAIL
Android 메신저 ANDROID_MESSENGER
Android 메시지 ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
클립보드로 복사 COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
삽입 EMBED
이메일 MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook 페이지 FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
행아웃 HANGOUTS
hi5 HI5
HTC 문자 메시지 HTC_MMS
Google Inbox INBOX
iOS 시스템 활동 대화상자 IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
카카오 (카카오톡) KAKAO
Kik KIK
LGE 이메일 LGE_EMAIL
선 LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
네이버 NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
기타 OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
레딧 REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
메시지 입력 TEXT_MESSAGE
Tuenti TUENTI
tumblr TUMBLR
Twitter TWITTER
알 수 없음 UNKNOWN
Verizon 메시지 VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! 일본 YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

자세한 내용은 도움말 문서를 참고하세요.

예

다음은 소셜 측정기준을 사용하는 샘플 요청입니다.

  • 채널 예

    • 소셜: 동영상이 공유된 서비스별로 집계된 공유 측정항목

  • 콘텐츠 소유자 예시

    • 소셜: 동영상이 공유된 서비스별로 집계된 공유 측정항목

시청 지속 시간

elapsedVideoTimeRatio
이 측정기준은 동영상의 경과 시간과 동영상 길이의 비율을 지정합니다. 유지율 측정기준 및 측정항목은 시간 경과에 따른 시청 지속 시간을 측정하는 데 사용되며 elapsedVideoTimeRatio 측정기준은 시간 측정입니다. 예를 들어 값이 0.4이면 해당 보고서 데이터에 동영상의 40%가 경과한 후의 유지 시간 데이터가 표시됩니다.

API는 각 동영상에 대해 비율 값이 0.01에서 1.0 사이인 데이터 포인트 100개를 반환합니다. 동영상 재생 중에 데이터가 측정되는 시간은 각 동영상에 대해 동일한 간격으로 배치됩니다. 즉, 2분 길이의 동영상의 경우 데이터 포인트 간 간격은 1.2초입니다. 하지만 2시간 길이의 동영상의 경우 데이터 포인트 간 간격은 72초입니다. 측정기준의 값은 간격의 끝값을 나타냅니다(해당 값 제외).
audienceType (필터만)
측정기준 값은 보고서 데이터와 연결된 트래픽 유형을 식별합니다. 지원되는 값은 ORGANIC, AD_INSTREAM, AD_INDISPLAY입니다. 이러한 트래픽 소스 유형에 대한 설명은 YouTube 고객센터를 참고하세요.

audienceType 필터의 데이터는 2013년 9월 25일부터 사용할 수 있습니다. API는 필터를 사용하여 이전 날짜의 데이터를 검색하려는 쿼리의 데이터를 반환하지 않습니다. 필터를 사용하지 않는 쿼리는 2008년 7월 1일 이후의 날짜에 작동합니다.

예

다음 샘플 요청은 시청 지속 시간 측정기준을 사용합니다.

실시간 스트리밍

livestreamPosition
이 측정기준은 라이브 동영상 스트림 중 특정 분을 지정합니다. 보고서 측정항목은 해당 시점에 라이브 스트림을 시청한 사용자 수를 나타냅니다.

멤버십 취소

membershipsCancellationSurveyReason
보고 기간 동안 지정된 채널의 채널 멤버십을 취소한 YouTube 사용자가 작성한 설문조사 수입니다. 다음 표에는 유효한 측정기준 값이 나와 있습니다.
API 값 설명
UNKNOWN 사용자가 설문조사를 완료하지 않았습니다.
DISLIKE_PERKS 사용자가 멤버십 혜택을 마음에 들어 하지 않았습니다.
PERKS_NOT_DELIVERED 약속된 멤버십 혜택이 제공되지 않았다고 말했습니다.
CANNOT_ACCESS_PERKS 사용자가 혜택에 액세스할 수 없습니다.
NO_LONGER_INTERESTED 사용자가 더 이상 채널 멤버십에 관심이 없습니다.
FEEL_UNAPPRECIATED 사용자가 채널 회원으로서 인정받지 못한다고 느꼈습니다.
FINANCIAL_REASONS 사용자가 금전적인 이유로 취소했습니다.
JOIN_LIMITED_TIME 사용자가 한시적으로 가입하려고 했습니다.
OTHER 사용자가 다른 이유로 취소했습니다.

광고 실적

adType
adType 측정기준은 광고 실적 보고서에 사용되며 동영상 재생 중에 게재된 광고 유형을 기반으로 요청된 측정항목을 집계합니다. 다음 목록에는 가능한 측정기준 값이 설명되어 있습니다. YouTube 광고 형식에 대한 자세한 내용은 YouTube 고객센터를 참고하세요.

  • auctionBumperInstream – 입찰을 통해 게재되며 최대 6초 길이의 건너뛸 수 없는 동영상 광고로, 이 광고를 시청해야 동영상을 볼 수 있습니다.

  • auctionDisplay – 동영상 플레이어 하단에 오버레이로, 동영상 보기 페이지에 300x250 광고 단위로, 또는 둘 다의 조합으로 표시되는 리치 미디어 또는 이미지 광고입니다. 오버레이가 실행되면 일정 시간 표시된 후 자동으로 닫히며 사용자도 오버레이를 닫을 수 있습니다. 오버레이와 배너가 같이 표시되면 각 광고는 개별 노출수로 계산됩니다.

  • auctionInstream – 기본 동영상 전, 중, 후에 게재되는 건너뛸 수 없는 동영상 광고입니다.

  • auctionTrueviewInslate – 시청자가 동영상 앞에 표시된 여러 동영상 광고 중 하나를 선택합니다. See the TrueView documentation for more information.

  • auctionTrueviewInstream – 기본 동영상 전이나 도중에 게재되는 건너뛸 수 있는 동영상 광고입니다. 자세한 내용은 TrueView 문서를 참고하세요.

  • auctionUnknown – 애드워즈 입찰을 통해 구매되었지만 다른 광고 유형 중 하나로 분류되지 않은 광고입니다.

  • reservedBumperInstream – 건너뛸 수 없는 동영상 광고로, 예약 판매되며 최대 6초 길이이며 동영상을 시청하기 전에 시청해야 합니다.

  • reservedClickToPlay – 사용자가 클릭해야 재생이 시작되는 동영상 광고입니다. 클릭재생 광고 단위가 표시될 때마다 광고 노출이 기록되며, 이때 사용자가 재생을 시작했는지 여부는 중요하지 않습니다. 이 광고는 예약 방식으로 판매됩니다.

  • reservedDisplay – 동영상 플레이어 하단에 오버레이로, 동영상 보기 페이지에 300x250 광고 단위로, 또는 둘 다의 조합으로 표시되는 리치 미디어 또는 이미지 광고입니다. 오버레이가 실행되면 일정 시간 표시된 후 자동으로 닫히며 사용자도 오버레이를 닫을 수 있습니다. 오버레이와 배너가 같이 표시되면 각 광고는 개별 노출수로 계산됩니다.

  • reservedInstream – 기본 동영상 전, 중, 후에 삽입되는 건너뛸 수 없는 동영상 광고입니다.

  • reservedInstreamSelect

  • reservedMasthead – 동영상 및 그래픽 요소를 포함할 수 있는 대형 광고로 홈페이지에 표시됩니다.

  • reservedUnknown – 예약된 방식으로 판매되었으며 다른 광고 유형 중 하나로 분류할 수 없는 광고입니다.

  • unknown – YouTube에서 이 광고 유형을 분류할 수 없습니다.

예

다음 샘플 보고서는 광고 실적 또는 수익 측정항목을 가져옵니다.

  • 채널 예

    • 수익/광고
      • 채널 수익 및 광고 실적 측정항목
      • 일일 수익 및 광고 실적 측정항목
      • 국가별 수익 및 광고 실적 측정항목
      • 상위 10개 – 수익이 가장 높은 동영상
      • 다른 광고 유형의 광고 실적 측정항목

  • 콘텐츠 소유자 예시

    • 수익/광고
      • 소유권 주장이 제기된 콘텐츠의 수익 및 광고 실적 측정항목
      • 일일 수익 및 광고 실적 측정항목
      • 국가별 수익 및 광고 실적 측정항목
      • 상위 10개 – 수익이 가장 높은 동영상
      • 다른 광고 유형의 광고 실적 측정항목

콘텐츠 소유자 측정기준

다음 측정기준은 콘텐츠 소유자 보고서에만 지원됩니다.

중요: 콘텐츠 소유자 보고서를 검색하기 위한 API 요청은 다음 측정기준 중 하나를 사용하여 데이터를 필터링해야 합니다.
  • video
  • channel
  • 아래에 정의된 claimedStatus 및 uploaderType 측정기준의 지원되는 조합입니다.
claimedStatus(콘텐츠 소유자 보고서에서만 사용됨)
이 측정기준을 사용하면 API 응답에 소유권 주장이 제기된 콘텐츠의 측정항목만 포함되어야 한다고 지정할 수 있습니다. 이 측정기준에 유효한 값은 claimed뿐입니다. filters 매개변수가 쿼리를 claimedStatus==claimed로 제한하면 API는 소유권 주장이 제기된 콘텐츠의 데이터만 가져옵니다. uploaderType 측정기준 정의의 표에는 이 측정기준을 사용하는 방법에 관한 자세한 내용이 나와 있습니다.
uploaderType(핵심 측정기준) (콘텐츠 소유자 보고서에만 사용됨)
이 측정기준을 사용하면 API 응답에 지정된 콘텐츠 소유자가 업로드한 콘텐츠 또는 서드 파티가 업로드한 콘텐츠(예: 사용자 업로드 동영상)의 측정항목을 포함해야 하는지 여부를 지정할 수 있습니다. 유효한 값은 self, thirdParty입니다. 핵심 측정기준이며 지원 중단 정책이 적용됩니다.

아래 표에는 filters 매개변수에서 모두 사용되는 claimedStatus 및 uploaderType 측정기준의 지원되는 조합이 나와 있습니다.

claimedStatus 값 uploaderType 값 설명
[설정한 언어 없음] self 콘텐츠 소유자가 업로드한 소유권이 주장된 콘텐츠 및 소유권이 주장되지 않은 콘텐츠의 YouTube 분석 데이터를 검색합니다.
소유권 주장됨 [설정한 언어 없음] 콘텐츠 소유자 또는 타사에서 업로드한 소유권이 주장된 콘텐츠의 데이터를 검색합니다.
소유권 주장됨 self 콘텐츠 소유자가 업로드한 소유권이 주장된 콘텐츠의 데이터를 검색합니다.
소유권 주장됨 thirdParty 타사에서 업로드한 소유권이 주장된 콘텐츠의 데이터를 검색합니다.

예

콘텐츠 소유자 보고서의 샘플 API 요청 중 상당수는 지원되는 claimedStatus 및 uploaderType 측정기준 조합을 사용하여 데이터를 필터링합니다.