참고:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
이 페이지에는 콘텐츠 소유자가 YouTube Analytics API를 사용하여 검색할 수 있는 보고서가 나와 있습니다. 콘텐츠 소유자 보고서에는 지정된 YouTube 콘텐츠 소유자와 연결된 채널의 측정항목이 포함됩니다. 측정항목은 사용자 활동, 광고 실적 또는 예상 수익을 개별적으로 측정한 것입니다.
동영상 보고서에는 콘텐츠 소유자 채널에 있는 동영상의 사용자 활동, 광고 실적 및 예상 수익 측정항목이 포함됩니다.
재생목록 보고서는 재생목록과 관련된 동영상 조회수와 구체적으로 관련된 통계를 제공합니다. 재생목록 보고서는 동영상 보고서와 동일한 측정기준 및 필터를 많이 사용합니다.
광고 실적 보고서에는 수익 및 광고 실적과 관련된 측정항목이 포함되어 있습니다. 광고 유형은 adType 측정기준을 사용하여 동영상 재생 중에 실행된 광고 유형에 따라 측정항목을 그룹화합니다. 광고 실적 보고서 섹션에서는 API에서 지원하는 두 가지 유형의 광고 실적 측정항목을 설명합니다.
보고서 검색하기
콘텐츠 소유자 보고서를 가져오려면 API의 reports.query 메서드를 호출하고 API 요청의 ids 매개변수 값을 contentOwner==OWNER_NAME로 설정하세요. 여기서 OWNER_NAME는 콘텐츠 소유자의 ID를 지정합니다. 가치를 잘 모르는 경우 파트너 관리자에게 문의하세요.
승인
모든 YouTube Analytics API 요청은 승인된 상태여야 합니다. 승인 가이드에서는 OAuth 2.0 프로토콜을 사용하여 승인 토큰을 검색하는 방법을 설명합니다.
지원되는 보고서를 설명하는 표에서는 각 보고서에 사용할 수 있는 필터를 확인할 수 있습니다. 설명에서 괄호로 표시된 필터는 선택사항입니다. 예를 들어 보고서에서 필터링 옵션으로 video(,country)를 나열한 경우 특정 동영상의 데이터만 포함하거나 특정 국가의 특정 동영상 데이터만 포함하도록 보고서를 필터링할 수 있습니다.
또한 API는 video, playlist, channel 필터에 여러 값을 지정할 수 있는 기능도 지원합니다. 이러한 필터 중 하나에 여러 값을 지정하는 경우 요청에 지정하는 측정기준 목록에 해당 필터를 추가할 수도 있습니다. 이는 필터가 특정 보고서에서 지원되는 측정기준으로 등록되지 않은 경우에도 마찬가지입니다.
특정 값 또는 값 집합의 API 결과를 필터링하는 방법에 대한 자세한 설명은 filters 매개변수 정의를 참고하세요.
보고서 표 이해
이 섹션에서는 API에서 지원하는 보고서를 정의하는 표에 사용되는 형식과 용어를 설명합니다. 아래 표에는 시간 측정기준 및 averageViewPercentage 측정항목을 사용하여 재생 세부정보 동영상 보고서에 지원되는 측정기준, 측정항목, 필터가 나와 있습니다.
표에는 측정기준 2행, 측정항목 행 1개, 필터 관련 행이 3개 있습니다. 측정기준과 필터의 경우 표에 나와 있는 사용 규칙을 준수하는 한 각 행의 값을 API 요청으로 결합할 수 있습니다. 예를 들어 이 보고서의 유효한 dimensions 매개변수 값에는 다음이 포함됩니다.
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
하지만 매개변수 값 day,month은 시간 기반 측정기준 2개를 사용하지만 요청은 0 또는 1을 사용할 수 있으므로 유효하지 않습니다. 이 경우 매개변수 값 subscribedStatus,youtubeProduct가 실제로 보고서를 반환하지만 측정항목은 일, 주, 월 등으로 집계되지 않습니다. 이 보고서는 문서에 별도로 설명되어 있습니다.
보고서 테이블 용어
표에서는 다음 용어를 사용하여 측정기준이 필수인지 선택사항인지 나타냅니다.
다음 용어는 필수 값을 의미합니다.
필수: 값을 포함해야 합니다.
정확히 1개 사용: 그룹의 값 1개를 포함해야 합니다.
1개 이상 사용: 그룹의 일부 또는 모든 값을 포함할 수 있지만 하나 이상 포함해야 합니다.
다음 용어는 값이 선택사항임을 의미합니다.
선택사항: 값을 포함할 수 있습니다.
0 또는 1 사용: 그룹의 값 1개를 포함할 수 있습니다.
0 이상 사용: 그룹의 일부 또는 모든 값을 포함할 수 있습니다.
중요: 콘텐츠 소유자 동영상 보고서를 가져오기 위한 모든 API 요청은 video 측정기준, channel 측정기준, group 측정기준 또는 claimedStatus와 uploaderType 측정기준의 지원되는 조합을 사용하여 데이터를 필터링해야 합니다. 일부 보고서는 이러한 옵션 중 일부를 지원하지 않습니다. 지원되는 조합은 다음과 같으며 uploaderType 측정기준의 정의에도 표시됩니다.
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
동영상 보고서
기본 통계
기본 통계 (구독자 수 포함)
이 보고서는 모든 콘텐츠 소유자의 채널에서 발생한 사용자 작업과 관련된 통계를 제공합니다. 특정 동영상 또는 국가에 대한 데이터만 반환하도록 보고서를 필터링할 수 있습니다. 또한 콘텐츠 소유자나 제3자가 업로드한 소유권 주장이 제기된 콘텐츠를 비롯해 소유권 주장이 제기된 콘텐츠에 대한 통계만 검색하는 데 사용할 수도 있습니다.
이러한 보고서에서 시간 측정기준(일 또는 월)은 선택사항입니다. 하지만 startDate 및 endDate 요청 매개변수를 사용하여 보고서에 포함할 기간을 지정해야 하기 때문입니다. 측정기준이 있으면 이 측정기준은 보고서의 데이터를 일, 월 등을 기준으로 집계한다는 뜻입니다.
참고: 이 보고서에서는 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 대부분의 다른 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.
이 보고서는 콘텐츠 소유자의 콘텐츠에 대한 조회수가 가장 많이 발생한 리퍼러를 기준으로 조회 통계를 집계합니다. 리퍼러는 트래픽 소스 유형별로 분류되며 insightTrafficSourceDetail 측정기준의 정의는 보고서를 사용할 수 있는 트래픽 소스를 식별합니다. 예를 들어 insightTrafficSourceType 필터를 ADVERTISING로 설정하면 콘텐츠 소유자의 콘텐츠에 대해 가장 많은 조회수 또는 시청 시간이 발생한 광고 유형이 보고서에 표시됩니다.
참고: 이 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스는 추가 세부정보가 없으므로 이 보고서를 지원하지 않습니다. 이 보고서를 지원하는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.
기기 유형 및 운영체제
기기 유형
이 보고서는 시청자가 내 콘텐츠를 볼 때 사용한 기기의 유형에 따라 조회 통계를 집계합니다. 예를 들어 태블릿 또는 게임 콘솔에서 발생한 조회수를 식별합니다.
이 보고서는 동영상의 잠재고객 보유 능력을 측정합니다. elapsedVideoTimeRatio 측정기준은 해당 측정항목 값에 대해 경과된 동영상의 양을 측정합니다. audienceWatchRatio 및 relativeRetentionPerformance 측정항목은 동영상이 시청자의 관심을 얼마나 잘 끄는지 보여주는 두 가지 측정항목을 제공합니다. 첫 번째는 절댓값이고 두 번째는 절댓값이고 두 번째는 동영상이 비슷한 길이의 다른 YouTube 동영상과 비교하여 어떤 실적을 나타내는지 보여줍니다.
참고: 시청 지속 시간 보고서에서는 video 필터에 쉼표로 구분된 값 목록을 지정할 수 없습니다. 값은 단일 동영상 ID를 지정해야 합니다.
참고: 이 보고서의 경우 maxResults 매개변수를 200 이하의 정수 값으로 설정해야 합니다. 2013년 1월 1일 이전의 데이터는 상위 10개 동영상에 대해서만 제공됩니다. 대부분의 다른 보고서와 달리 이 보고서의 경우 sort 요청 매개변수의 값도 지정해야 합니다.
전체, 국가별, 대륙별 또는 아대륙별 많이 본 동영상(결과 200개 이하)
이 보고서는 지정된 필터링 및 정렬 기준에 따라 콘텐츠 소유자의 인기 동영상을 보여줍니다.
이 보고서는 구독 또는 구독하지 않은 시청자의 인기 동영상을 보여줍니다. 보고서를 필터링하여 국가, 대륙 또는 subContinent별 인기 동영상을 나열할 수 있습니다. 이전 보고서에서는 구독 또는 구독하지 않은 시청자에게서 미국 특정 주의 인기 동영상을 검색할 수 있지만 이 보고서보다 더 적은 측정항목을 지원합니다.
재생목록 보고서에는 채널 소유자의 재생목록에 있는 동영상과 관련된 사용자 활동과 관련된 측정항목이 포함됩니다. 이 보고서의 두 가지 버전이 제공됩니다. 사용 가능한 각 보고서에 대한 각 버전에 대한 설명이 다음 섹션에 나와 있습니다.
각 섹션의 Recommended 탭에는 해당 보고서를 검색하기 위한 선호 API 요청 형식이 설명되어 있습니다. 추천 보고서는 집계된 동영상 측정항목과 재생목록 내 측정항목을 모두 포함하는 확장된 측정항목 집합을 지원합니다. 이 요청 형식은 isCurated 측정기준을 사용하지 않습니다.
각 섹션의 isCurated 사용 탭에서는 isCurated 측정기준이 필요한 이전 API 요청 형식을 설명합니다. 이 보고서는 재생목록 측정항목만 지원합니다. isCurated 측정기준은 모든 보고서에서 지원 중단되었습니다. 아래 경고 참고사항에는 지원 중단 일정에 대한 설명이 나와 있습니다.
다음 경고 메모에서는 두 보고서 버전 간의 변경사항에 대해 자세히 설명합니다.
집계된 동영상 측정항목
이러한 측정항목은 재생목록을 소유한 채널에서 소유한 재생목록의 모든 동영상에 대해 집계된 사용자 활동 및 노출수 측정항목을 제공합니다. 다른 채널에서 소유한 동영상의 측정항목은 집계에서 계산되지 않습니다. 따라서 채널에서 다른 채널에서 소유한 동영상만 포함된 재생목록을 만드는 경우 이러한 재생목록의 보고서는 이러한 측정항목의 값을 제공하지 않습니다.
YouTube가 지원하는 집계된 동영상 측정항목 목록은 지원되는 재생목록 측정항목 섹션을 참조하세요.
재생목록 내 측정항목
이러한 측정항목은 재생목록 페이지라는 관점에서의 사용자 활동 및 참여도를 반영합니다. 이러한 측정항목에는 소유한 채널과 관계없이 재생목록에 있는 모든 동영상의 조회수가 포함되지만 재생목록 맥락에서 발생한 조회수만 계산합니다.
참고: 이 보고서에서는 maxResults 매개변수를 25 이하의 정수 값으로 설정해야 합니다. 대부분의 다른 보고서와 달리 이 보고서에서는 sort 요청 매개변수의 값도 지정해야 합니다.
이 보고서는 콘텐츠 소유자의 재생목록에 대한 조회수가 가장 많이 발생한 리퍼러를 기준으로 조회 통계를 집계합니다. 리퍼러는 트래픽 소스 유형별로 분류되며 insightTrafficSourceDetail 측정기준의 정의는 보고서를 사용할 수 있는 트래픽 소스를 식별합니다. 예를 들어 insightTrafficSourceType 필터를 ADVERTISING로 설정하면 콘텐츠 소유자의 재생목록에서 가장 많은 조회수 또는 시청 시간이 발생한 광고 유형이 보고서에 표시됩니다.
참고: 이 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스는 추가 세부정보가 없으므로 이 보고서를 지원하지 않습니다. 이 보고서를 지원하는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.
기기 유형 및 운영체제
재생목록용 기기 유형
이 보고서는 시청자가 재생목록 콘텐츠를 시청할 때 사용한 기기 유형을 기준으로 조회 통계를 집계합니다. 예를 들어 휴대기기 또는 게임 콘솔에서 발생한 조회수를 식별합니다.
