Dimensions

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

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

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

쿼리 보고서를 가져오려면 YouTube Analytics 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 Analytics API의 groups.list 메서드를 사용하여 이 값을 검색할 수 있습니다. group 필터를 사용하면 API 응답에 해당 그룹의 모든 동영상, 재생목록 또는 채널의 데이터가 포함됩니다.

예

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

  • 채널 예

    • 기본 통계 <ph type="x-smartling-placeholder">
        </ph>
      • 상위 10개 – 채널의 가장 많이 본 동영상
      • 상위 10개 – 채널에서 가장 많이 조회된 동영상의 특수효과 클릭률
      • 특정 재생목록의 통계
      • 상위 10개 – 채널에서 가장 많이 시청한 재생목록
    • 지역 <ph type="x-smartling-placeholder">
        </ph>
      • 상위 10개 – 특정 국가에서 최다 조회 동영상
      • 상위 10개 – 유럽에서 가장 많이 조회된 동영상

  • 콘텐츠 소유자의 예

    • 기본 통계 <ph type="x-smartling-placeholder">
        </ph>
      • 상위 10개 - 콘텐츠 소유자의 최다 조회 동영상
      • 상위 10개 - 콘텐츠 소유자의 가장 많이 시청한 동영상
      • 상위 10개 - 콘텐츠 소유자 채널의 최다 조회 동영상
      • 상위 10개 – 채널에서 가장 많이 조회된 동영상의 특수효과 클릭률
      • 상위 10개 – 콘텐츠 소유자가 가장 많이 시청한 재생목록
    • 지역 <ph type="x-smartling-placeholder">
        </ph>
      • 상위 10개 - 콘텐츠 소유자가 유럽에서 가장 많이 시청한 동영상
      • 상위 10개 – 미국에서 가장 많이 시작된 재생목록

지역

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

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

참고: 미국령 외 지역에도 자체 ISO 3166-1 국가 코드가 있으므로 이 측정기준은 미국 외 지역을 식별하는 ISO 3166-2 값을 지원하지 않습니다. 미국 이외의 다른 국가는 지원되지 않습니다.

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

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

예

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

  • 채널 예

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

  • 콘텐츠 소유자의 예

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

기간

이러한 측정기준은 보고서가 특정 기간(예: 하루, 한 주, 한 달)을 기준으로 데이터를 집계해야 함을 나타냅니다. startDate 및 endDate 요청 매개변수는 보고서에 데이터가 포함되는 기간을 지정합니다. 보고서는 검색어가 생성된 시점에 요청에 지정된 모든 측정항목을 사용할 수 있는 마지막 날까지의 데이터를 실제로 반환합니다. 보고서에서 날짜는 YYYY-MM-DD 형식으로 표시됩니다.

중요: 모든 날짜는 태평양 표준시로 오전 12시(UTC-7 또는 UTC-8)에 시작하여 지정된 연도, 월, 오전 11시 59분(태평양 표준시)에 끝나는 기간을 나타냅니다. 따라서 일광 절약 시간제에 맞춰 시계가 앞으로 조정된 날짜는 23시간을 나타내며, 역방향으로 조정된 날짜는 25시간을 나타냅니다.

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

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

참고: API 쿼리에서 month 측정기준을 사용하는 경우 start-date 및 end-date 매개변수 모두 그달의 첫째 날로 설정되어야 합니다. This is a core dimension and is subject to the Deprecation Policy.

예

다음은 임시 측정기준 또는 필터를 사용하는 샘플 요청입니다.

  • 채널 예

    • 시간 기반 <ph type="x-smartling-placeholder">
        </ph>
      • 채널 동영상의 일별 시청 시간 측정항목
      • 채널 동영상의 일별 특수효과 측정항목
      • 채널의 일일 재생목록 조회수
    • 재생 위치: 여러 재생 위치에서 발생한 일일 조회수 및 시청 시간
    • 트래픽 소스: 다양한 트래픽 소스의 일일 조회수 및 시청 시간
    • 기기/OS <ph type="x-smartling-placeholder">
        </ph>
      • Android 운영체제의 일별 기기 유형 측정항목
      • 모바일 기기의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목

  • 콘텐츠 소유자의 예

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

재생 위치

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

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 애플리케이션(예: YouTube Android 앱)에서 발생한 조회수를 나타냅니다.

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

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

예

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

  • 채널 예

    • 재생 위치 <ph type="x-smartling-placeholder">
        </ph>
      • 다른 재생 위치의 조회수 및 시청 시간
      • 재생 위치별 일일 조회수 및 시청 시간
      • 상위 10개 – 삽입된 동영상에 대한 조회수가 가장 많이 발생한 타사 사이트
      • 재생 위치별 재생목록 조회수 및 시청 시간
      • 재생 위치에 따른 일일 재생목록 조회수 및 시청 시간

  • 콘텐츠 소유자의 예

    • 재생 위치 <ph type="x-smartling-placeholder">
        </ph>
      • 다른 재생 위치의 조회수 및 시청 시간
      • 재생 위치별 일일 조회수 및 시청 시간
      • 상위 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 - 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 – 조회수를 늘리는 동영상입니다.

예

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

  • 채널 예

    • 트래픽 소스 <ph type="x-smartling-placeholder">
        </ph>
      • 한 국가 내 다른 트래픽 소스의 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 조회수 및 시청 시간
      • 상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어
      • 상위 10개 – 동영상에 가장 많은 트래픽을 생성하는 Google 검색어
      • 국가 내 다양한 트래픽 소스의 재생목록 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 재생목록 조회수 및 시청 시간

  • 콘텐츠 소유자의 예

    • 트래픽 소스 <ph type="x-smartling-placeholder">
        </ph>
      • 다른 트래픽 소스의 조회수 및 시청 시간
      • 다양한 트래픽 소스의 일일 조회수 및 시청 시간
      • 상위 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 <ph type="x-smartling-placeholder">
        </ph>
      • Android 운영체제의 일별 기기 유형 측정항목
      • 모바일 기기의 일별 운영체제 측정항목
      • 일별 운영체제 및 기기 유형 측정항목
      • Android 운영체제의 재생목록 조회수에 대한 일별 기기 유형 측정항목
      • 휴대기기의 재생목록 조회수에 대한 일별 운영체제 측정항목

  • 콘텐츠 소유자의 예

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

인구통계

인구통계 측정기준은 시청자의 연령대 및 성별 분포를 파악하는 데 도움이 됩니다. YouTube 고객센터에는 YouTube Analytics 보고서의 인구통계 데이터에 대한 추가 정보가 포함되어 있습니다.

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.

예

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

  • 채널 예

    • 인구통계 <ph type="x-smartling-placeholder">
        </ph>
      • 캘리포니아의 시청자 인구통계 (연령대 및 성별)
      • 캘리포니아의 재생목록 시청자 인구통계 (연령대 및 성별)

  • 콘텐츠 소유자의 예

    • 인구통계 <ph type="x-smartling-placeholder">
        </ph>
      • 캘리포니아의 시청자 인구통계 (연령대 및 성별)
      • 캘리포니아의 재생목록 시청자 인구통계 (연령대 및 성별)

참여 및 콘텐츠 공유

sharingService (핵심 측정기준)
이 측정기준은 동영상을 공유하는 데 사용된 서비스를 식별합니다. '공유' 버튼을 클릭합니다. 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 메신저 BBM
Blogger BLOGGER
클립보드로 복사 COPY_PASTE
사이클월드 CYWORLD
디그 DIGG
Dropbox DROPBOX
삽입 EMBED
이메일 MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook 페이지 FACEBOOK_PAGES
포트카 FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
SMS 사용하기 GO_SMS
GroupMe GROUPME
행아웃 HANGOUTS
hi5 HI5
HTC 문자 메시지 HTC_MMS
Google 받은편지함 INBOX
iOS 시스템 활동 대화상자 IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO 스토리 KAKAO_STORY
카카오 (카카오톡) KAKAO
Kik KIK
LGE 이메일 LGE_EMAIL
선 LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola 메시지 MOTOROLA_MESSAGING
Myspace MYSPACE
네이버 NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (네дноклассники) ODNOKLASSNIKI
기타 OTHER
Pinterest PINTEREST
라쿠텐 (楽市場) RAKUTEN
레딧 REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
텀블러 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에서 이 광고 유형을 분류할 수 없습니다.

예

다음 샘플 보고서는 광고 실적 또는 수익 측정항목을 검색합니다.

  • 채널 예

    • 수익/광고 <ph type="x-smartling-placeholder">
        </ph>
      • 채널 수익 및 광고 실적 측정항목
      • 일일 수익 및 광고 실적 측정항목
      • 국가별 수익 및 광고 실적 측정항목
      • 상위 10개 – 가장 높은 수익을 올린 동영상
      • 다른 광고 유형의 광고 실적 측정항목

  • 콘텐츠 소유자의 예

    • 수익/광고 <ph type="x-smartling-placeholder">
        </ph>
      • 소유권 주장이 제기된 콘텐츠의 수익 및 광고 실적 측정항목
      • 일일 수익 및 광고 실적 측정항목
      • 국가별 수익 및 광고 실적 측정항목
      • 상위 10개 – 가장 높은 수익을 올린 동영상
      • 다른 광고 유형의 광고 실적 측정항목

재생목록

isCurated (필터만)
이 필터는 설정할 수 있습니다.

예

재생목록 보고서를 가져오는 모든 샘플 요청은 isCurated 필터를 사용합니다.

콘텐츠 소유자 측정기준

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

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

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

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

예

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