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 요청은 보고 항목 측정기준 중 하나를 사용하거나 claimedStatusuploaderType 측정기준의 지원되는 조합을 사용하여 데이터를 필터링해야 합니다.

크기

다음 섹션에서는 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 응답에 해당 그룹의 모든 동영상, 재생목록 또는 채널에 대한 데이터가 포함됩니다.

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

  • 채널 예

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

  • 콘텐츠 소유자의 예

    • 기본 통계
      • 상위 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
보고서 행의 측정항목과 연결된 미국의 주 또는 지역입니다. 측정기준 값은 US-MI (미시간) 또는 US-TX (텍사스) 등 미국의 주 또는 워싱턴 D.C를 식별하는 ISO 3166-2 코드입니다. 주 코드 US-ZZ은 YouTube에서 관련된 미국의 주를 식별할 수 없는 측정항목을 보고하는 데 사용됩니다. API 요청의 dimensions 매개변수 값에 province이 포함된 경우 filters 매개변수 값에 country==US를 포함하여 데이터를 미국으로 제한해야 합니다.

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

city
보고서 행의 측정항목과 관련된 예상 도시입니다. 이 측정기준에 대한 데이터는 2022년 1월 1일부터 사용할 수 있습니다.
대륙 (필터만)
유엔 (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개 – 특정 국가에서 최다 조회 동영상
      • 상위 10개 – 유럽에서 가장 많이 본 동영상

  • 콘텐츠 소유자의 예

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

기간

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

중요: 모든 날짜는 태평양 표준시 (UTC-7 또는 UTC-8) 오전 12시에 시작해 태평양 표준시로 지정된 일, 월, 연도의 오후 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-dateend-date 매개변수 모두 해당 월의 첫 번째 날로 설정해야 합니다. 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 애플리케이션(예: YouTube Android 앱)에서 발생한 조회수를 나타냅니다.

  • 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
이 측정기준은 데이터 행의 사용자 활동 측정항목이 동영상 또는 재생목록의 채널을 구독한 시청자와 연결되어 있는지를 나타냅니다. 가능한 값은 SUBSCRIBEDUNSUBSCRIBED입니다.

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

다음 표에는 측정기준 값이 나와 있습니다.
CORE 전문 YouTube 애플리케이션 (YouTube Gaming, YouTube Kids 또는 YouTube Music)에서 발생하지 않은 사용자 활동입니다. 예외: 2021년 3월 1일 전에 YouTube Music에서 발생한 사용자 활동은 CORE에 포함됩니다.
GAMING YouTube 게임에서 사용자 활동이 발생했습니다.
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 – 트래픽의 리퍼러가 식별되지 않았습니다. 이 카테고리는 모바일 앱의 트래픽뿐 아니라 동영상에 대한 직접 트래픽도 포함합니다.
  • 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 고객센터에서 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.
성별 (핵심 측정기준)
이 측정기준은 보고서 데이터와 연결된 로그인한 사용자의 성별을 식별합니다. 유효한 값은 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
디그 DIGG
Dropbox DROPBOX
Embed 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
메네아메 MENEAME
mixi MIXI
Motorola 메시지 MOTOROLA_MESSAGING
MySpace MYSPACE
네이버 NAVER
Nearby Share NEARBY_SHARE
NUjij NUJIJ
오드노클라스니키 (Одноклассники) ODNOKLASSNIKI
기타 OTHER
Pinterest PINTEREST
라쿠텐 (設備名場) RAKUTEN
레딧 REDDIT
Skype SKYPE
스카이락 SKYBLOG
소니 컨디션 SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
투엔티 TUENTI
tumblr. TUMBLR
트위터 TWITTER
알 수 없음 UNKNOWN
Verizon 메시지 VERIZON_MMS
Viber VIBER
VKontakte (лонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
비코프 WYKOP
Yahoo! 일본 YAHOO
가이드 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일 이후부터 유효합니다.

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

광고 실적

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 – 분류할 수 없는 광고 유형입니다.

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

  • 채널 예

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

  • 콘텐츠 소유자의 예

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

재생목록

isCurated (필터만)
이 필터는 요청이 재생목록의 컨텍스트에서 발생한 동영상 조회수에 대한 데이터를 검색하고 있음을 나타냅니다. 이 필터는 모든 재생목록 보고서에 필요하며 값을 1로 설정해야 합니다.

재생목록 보고서를 검색하는 모든 샘플 요청isCurated 필터를 사용합니다.

콘텐츠 소유자 측정기준

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

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

아래 표에는 filters 매개변수에서 사용되는 claimedStatusuploaderType 측정기준에 대해 지원되는 조합이 나와 있습니다.

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

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