영화, 음악, TV
다음 표에서는 영화, 음악, TV 파트너의 YouTube Reporting API 시스템 관리 보고서에 표시되는 필드를 정의합니다.
| 필드 | |
|---|---|
active_claims |
활성 소유권 주장 수입니다. |
active_reference_id |
관련된 활성 참조의 YouTube 생성 ID입니다. |
activity_month |
보고서를 작성한 월입니다. |
adjustment_type |
행이 정상적인 수익 데이터를 나타내는지 또는 이전에 보고된 수익의 조정인지 나타냅니다.
|
administer_publish_rights |
음반사가 음반 제작 권리를 관리하는지 여부를 나타냅니다. 즉, 음반사가 작곡가, 작곡가, 음반 제작사 또는 음악작품을 소유한 다른 당사자의 로열티 지급금을 수집하고 관리하는지 여부를 나타냅니다. 가능한 값은 True 및 False입니다.
|
adsense_earnings_month |
애드센스 보고서를 쿼리할 수입 달 |
album |
음원이 실려 있는 앨범입니다. 값의 최대 길이는 255바이트입니다. |
approx_daily_views |
저작물의 평균 일일 조회수입니다. |
artist |
보고서 행에 식별된 저작물과 연결된 아티스트의 이름입니다. 값의 최대 길이는 255바이트입니다. |
asset_channel_id |
저작물 (asset_id)에서 소유권을 주장하는 파트너 업로드 동영상을 소유한 채널입니다. 입력란 값은 채널을 고유하게 식별하는 YouTube 채널 ID입니다. YouTube Data API의 channels.list 메서드를 사용하여 채널에 대한 추가 데이터를 가져올 수 있습니다.
|
asset_custom_id |
저작물을 고유하게 식별하는 데 사용되는 저작물 메타데이터 필드(선택사항)로, 대체로 내부 코드임. 다른 파트너에게는 내 맞춤 ID가 표시되지 않습니다. |
asset_id |
행의 데이터와 연결된 저작물을 고유하게 식별하는 YouTube 저작물 ID입니다. YouTube Content ID API의 assets.list 메서드를 사용하여 저작물에 관한 추가 데이터를 가져오거나 studio.youtube.com 저작물 페이지에서 저작물을 조회할 수 있습니다.
|
asset_labels |
저작물과 연결된 저작물 라벨 저작물 라벨을 사용하면 저작물을 맞춤 카테고리로 그룹화할 수 있습니다. 그런 다음 라벨을 사용하여 저작물을 검색하고, 저작물 그룹을 업데이트하고, 라벨이 지정된 저작물의 캠페인을 만들고, YouTube 분석을 필터링하는 등의 작업을 할 수 있습니다. |
asset_metadata_type |
참조의 저작물 유형(예: Web 또는 영화)
|
asset_owners |
참조의 현재 저작물 소유자입니다. |
asset_policy_block |
소유자 정책이 Block인 지역 값은 지역의 두 자리 국가 또는 지역 코드입니다.
|
asset_policy_id |
소유자 정책의 고유 식별자입니다. 현재 이 값은 API에서만 사용할 수 있습니다. 이 정보는 스튜디오 콘텐츠 관리자에는 표시되지 않습니다. |
asset_policy_monetize |
소유자 정책이 Monetize인 지역 값은 지역의 2자리 국가 또는 지역 코드입니다.
|
asset_policy_track |
소유자 정책이 Track인 지역 값은 지역의 2자리 국가 또는 지역 코드입니다.
|
asset_title |
저작물의 제목입니다. |
asset_type |
저작물의 유형입니다. 가능한 값은 다음과 같습니다.
|
audio_royalties |
YouTube 오디오 등급 수익에서 인식된 파트너 수익입니다. 오디오 광고 순수익의 파트너 오디오 지분과 오디오 재생당 파트너 수익 최솟값 중 더 큰 값에 기반합니다. |
audio_share |
총 오디오 등급 재생에 대한 파트너 오디오 등급 재생 비율입니다. |
category |
동영상 보기 페이지에 표시되는 동영상 장르입니다. 값은 YouTube 동영상 카테고리 ID입니다. YouTube Data API의 videoCategories.list 메서드를 사용하여 동영상 카테고리 ID와 카테고리 이름의 매핑을 가져올 수 있습니다.
|
channel_display_name |
동영상을 업로드한 채널의 표시 이름 |
channel_id |
행의 데이터와 연결된 동영상을 소유한 채널 (video_id)입니다. 이 필드 값은 채널을 고유하게 식별하는 YouTube 채널 ID입니다. YouTube Data API의 channels.list 메서드를 사용하여 채널에 대한 추가 데이터를 가져올 수 있습니다.
|
claiming_asset_type |
소유권 주장의 저작물 유형입니다. |
claim_created_date |
소유권 주장을 만든 날짜입니다. |
claim_id |
행의 소유권 주장과 연결된 저작물을 고유하게 식별하는 YouTube 소유권 주장 ID입니다. YouTube Content ID API의 claims.list 메서드를 사용하여 저작물에 관한 추가 데이터를 가져오거나 studio.youtube.com 신고 페이지에서 저작물을 조회할 수 있습니다.
|
claim_origin |
동영상에 대한 소유권 주장을 생성한 방법 가능한 필드 값은 다음과 같습니다.
|
claim_policy_block |
적용된 소유권 주장 정책이 Block인 지역 값은 2자리 국가/지역 코드입니다.
|
claim_policy_id |
적용된 정책의 고유 식별자입니다. 현재 이 값은 API에서만 사용할 수 있습니다. 이 정보는 스튜디오 콘텐츠 관리자에는 표시되지 않습니다. |
claim_policy_monetize |
적용된 소유권 주장 정책이 Monetize인 지역 값은 2자리 국가/지역 코드입니다.
|
claim_policy_track |
적용된 소유권 주장 정책이 Track인 지역 값은 2자리 국가/지역 코드입니다.
|
claim_status |
소유권 주장 상태가 ACTIVE, INACTIVE 또는 PENDING인지 지정합니다.
|
claim_status_detail |
소유권 주장 상태에 대한 세부정보(예: CLOSED_MANUALLY)
|
claim_type |
소유권 주장이 제기된 콘텐츠의 오디오, 동영상 또는 시청각 부분에 적용되는지 여부를 나타냅니다. 이 필드에서 유효한 값은 다음과 같습니다.
|
claim_quality |
소유권 주장이 제기된 동영상의 출처 가능한 필드 값은 다음과 같습니다.
참고: 이 입력란은 YouTube 크리에이터 스튜디오의 보고서 메뉴에서 다운로드할 수 있는 보고서에서는 |
claimed_by_another_owner |
다른 콘텐츠 소유자가 동영상에 대한 퍼스트 파티 또는 서드 파티 소유권 주장을 제기했는지 여부를 나타냅니다. |
claimed_by_this_owner |
보고서를 생성하는 콘텐츠 소유자가 동영상에 대해 활성 상태의 퍼스트 파티 또는 서드 파티 소유권 주장을 제기했는지 여부를 나타냅니다. |
comments_allowed |
동영상에 댓글이 사용 설정되어 있는지 여부를 나타냅니다. |
composition_right_type |
소유권 주장과 연결된 음악 작품 권리 유형을 지정합니다. 이 입력란에 사용할 수 있는 유효한 값은 다음과 같습니다.
|
conflicting_country_code |
다른 파트너와 소유권 분쟁이 발생한 지역의 ISO 국가 코드 |
conflicting_owner |
소유권 분쟁이 발생한 다른 파트너의 파트너 ID |
content_type |
소유권 주장이 제기된 동영상의 출처 가능한 값은 다음과 같습니다.
|
constituent_asset_id |
병합 전 저작물의 이전 ID입니다. |
constituent_asset_ids |
병합 전 저작물의 이전 ID입니다. |
country |
활동이 발생한 국가를 식별합니다. |
country_code |
활동이 발생한 국가의 국가 코드를 식별합니다. 값은 ISO 3166-1 alpha-2 국가 코드입니다. |
currency |
행이 나타내는 통화를 나타냅니다. |
currency_code |
행이 나타내는 통화 코드를 나타냅니다. |
custom_id |
메타데이터 제공업체가 저작물을 식별하는 데 사용하는 고유한 값입니다. 값은 저작물에 대해 만든 고유 ID 또는 ISRC와 같은 표준 식별자일 수 있습니다. 값의 최대 길이는 64바이트이며 영숫자 문자, 하이픈 (-), 밑줄 (_), 마침표 (.) 또는 'at' 기호 (@), 슬래시 (/)를 포함할 수 있습니다. |
date |
활동이 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
date_created |
참조가 만들어진 날짜 및 시간(UTC) |
date_id |
활동이 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
day |
활동이 발생한 날짜입니다. |
director |
저작물과 연결된 감독입니다. |
directors |
저작물에 연결된 감독입니다. |
display_ads_enabled |
동영상에 서드 파티 광고가 표시되는지 여부를 나타냅니다. |
effective_policy |
콘텐츠 소유자의 소유권 지역에서 동영상에 적용되는 사용 정책입니다. |
eidr |
영화 또는 TV 에피소드에 할당된 EIDR (Entertainment Identifier Registry)입니다. 값에는 EIDR 등록을 위한 표준 프리픽스가 포함되며, 그 뒤로 슬래시, 20자리 16진수 문자열 및 영숫자(0~9/A~Z)인 1자리 확인 문자가 이어집니다. |
embedding_allowed |
동영상을 서드 파티 웹사이트에 퍼갈 수 있는지 여부를 나타냅니다. |
end_date |
종료일 및 시간 |
episode_number |
동영상과 연결된 에피소드 번호입니다. |
episode_title |
TV 프로그램 또는 영화 에피소드의 제목입니다. |
excluded_perc |
전체 제외 및 길이를 기준으로 참조가 제외되는 비율입니다. |
exclusions |
참조의 제외된 비율과 제외 유형 (예: 참조 중복, 수동 제외, 잘못된 세그먼트)
사용할 수 있는 제외 유형은 다음과 같습니다.
|
grid |
GRid(글로벌 발표곡 식별자), 저작물을 고유하게 식별하는 데 사용되는 메타데이터 필드(선택사항) 필드의 값은 정확히 18자리 영숫자 문자여야 합니다. |
has_multiple_claims |
동영상에 소유권 주장이 2개 이상 제기되었는지 여부를 나타냅니다. 동영상에 소유권 주장이 하나인 경우 false이고 두 개 이상인 경우 true입니다.참고: 이 필드는 YouTube 스튜디오의 보고서 메뉴에서 다운로드할 수 있는 보고서에서 Multiple Claims?라고 합니다.
|
hfa |
HFA (Harry Fox Agency)에서 음악작품을 고유하게 식별하기 위해 발급한 6자리 코드입니다. |
hfa_song_code |
HFA (Harry Fox Agency)에서 음악작품을 고유하게 식별하기 위해 발급한 6자리 코드입니다. |
inactive_reference_id |
관련된 비활성 참조의 YouTube 생성 ID입니다. |
is_made_for_kids_effective_setting |
동영상의 '아동용' 설정 여부 |
is_made_for_kids_modifiable |
사용자가 '아동용' 설정을 수정할 수 있는지 여부를 나타냅니다. |
is_made_for_kids_user_selection |
동영상이 '아동용'으로 사용자 지정되었는지 여부를 나타냅니다. |
is_merged |
저작물 병합으로 인해 생성된 저작물인지 여부를 나타냅니다. |
is_shorts_eligible |
동영상이 Shorts에 적합한지 여부를 나타냅니다. |
isrc |
관련 저작물의 ISRC (International Standard Recording Code) 필드의 값은 정확히 12자리 영숫자 문자여야 합니다. |
iswc |
음악작품 저작물의 ISWC (International Standard Musical Work Code)입니다. 필드의 값은 문자 (T) 뒤로 10자리 숫자가 이어지는 형식으로 정확히 11자리여야 합니다. |
label |
음원을 발표한 음반사입니다. 값의 최대 길이는 255바이트입니다. |
length_sec |
참조 길이(초)입니다. |
local_currency |
수익이 지급되는 현지 통화 유형입니다. |
longest_match |
소유권 주장에서 가장 길게 일치하는 부분 |
long_nonskippable_video_ads_enabled |
동영상 중에 건너뛸 수 없는 긴 서드 파티 광고를 재생할 수 있는지 나타냅니다. 인스트림 동영상 광고는 콘텐츠 동영상 재생 중에 표시됩니다. |
match_policy |
저작물에 적용된 동영상 일치 관련 정책 |
matching_duration |
소유권 주장의 전체 일치 길이 |
metadata_origination |
저작물 메타데이터의 소스입니다. |
monetized_views |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 오디오 전용 및 시청각 스트림의 총 개수입니다. 이 값은 음악 파트너에게만 해당됩니다. |
monetized_views_art_track_audio |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 아트 트랙의 오디오 전용 스트림 수입니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_art_track_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 아트 트랙의 시청각 스트림 수입니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_audio |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 총 오디오 전용 스트림입니다. 값은 monetized_views_art_track_audio, monetized_views_partner_owned_audio, monetized_views_ugc_audio 필드의 합계입니다. 이 필드는 음악 파트너에게만 지원됩니다.
|
monetized_views_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 총 시청각 스트림입니다. 값은 monetized_views_art_track_audiovisual, monetized_views_partner_owned_audiovisual, monetized_views_ugc_audiovisual 필드의 합계입니다. 이 필드는 음악 파트너에게만 지원됩니다.
|
monetized_views_partner_owned_audio |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 파트너 제공 공식 뮤직비디오 콘텐츠의 오디오 전용 스트림 수입니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_partner_owned_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 파트너 제공 공식 뮤직비디오 콘텐츠의 시청각 스트림 수입니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_total_sub_service |
YouTube Premium 구독 서비스에서 모든 YouTube 음악 파트너의 소유권 주장 콘텐츠에 대한 모든 오디오 전용 및 시청각 수익 창출 조회수의 합계입니다. 이 값은 음악 파트너만 사용할 수 있습니다. |
monetized_views_ugc_audio |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 사용자 제작 콘텐츠 (UGC)의 오디오 전용 스트림 수입니다. UGC는 수익 공유를 위해 파트너가 제공한 라이선스 콘텐츠와 동일하게 취급되지 않는 사용자가 업로드한 동영상을 의미합니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_ugc_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 사용자 제작 콘텐츠 (UGC)의 시청각 스트림 수입니다. UGC는 수익 공유를 위해 파트너가 제공한 라이선스 콘텐츠와 동일하게 취급되지 않는 사용자가 업로드한 동영상을 의미합니다. 이 필드는 음악 파트너에게만 지원됩니다. |
monetized_views_ugc_master_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠와 관련된 시청각 마스터 녹음 스트림의 총 개수입니다. 이 값은 음악 파트너에게만 해당됩니다. |
monetized_views_ugc_cover_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠로 인해 발생한 사용자 제작 커버 동영상 스트림의 총 개수입니다. 이 값은 음악 파트너에게만 해당됩니다. |
monetized_views_ugc_cover_shared_audio_visual |
YouTube Premium 구독 서비스에서 내 콘텐츠로 인해 발생한 3자 수익 공유가 적용된 사용자 제작 커버 동영상의 총 개수입니다. 이 값은 음악 파트너에게만 해당됩니다. |
monetized_watchtime |
내 음악 외 동영상으로 발생한 총 YouTube Premium 구독 시청 시간(단위: 초)입니다. |
month |
활동이 발생한 월입니다. |
midrolls_enabled |
동영상에 미드롤 광고를 재생할 수 있는지 여부를 나타냅니다. 미드롤은 다른 동영상이나 이벤트 중에 표시되는 동영상 광고입니다. 예를 들어 미드롤 동영상 광고는 장편 영화 중에 간격을 두고 표시될 수 있습니다. 미드롤 광고는 라이선스가 있는 콘텐츠에만 게재할 수 있습니다. |
multiple_claims |
동영상에 소유권 주장이 2개 이상 제기되었는지 여부를 나타냅니다. 동영상에 소유권 주장이 하나인 경우 false이고 두 개 이상인 경우 true입니다.참고: YouTube 스튜디오의 보고서 메뉴에서 다운로드할 수 있는 보고서에서는 이 필드가 Multiple Claims?라고 합니다.
|
music_claim_type |
소유권 주장이 제기된 콘텐츠의 오디오, 동영상 또는 시청각 부분에 적용되는지 여부를 나타냅니다. 이 입력란에 사용할 수 있는 유효한 값은 다음과 같습니다.
|
music_share |
국가 및 가격정보당 음악 활동 비율 |
net_partner_revenue |
파트너의 순수익입니다. |
net_partner_revenue_post_revshare |
수익 공유 분할이 적용된 후 파트너의 순수익입니다. |
revshare_rate_type |
수익에 적용된 수익 공유 비율 유형입니다. |
nonskippable_video_ads_enabled |
동영상에 건너뛸 수 없는 서드 파티 광고가 재생되는지 여부를 나타냅니다. 인스트림 동영상 광고는 콘텐츠 동영상 재생 중에 표시됩니다. |
notes |
지연된 조정 지급액의 경우 전월의 지급액을 나타냅니다. |
offweb_syndicatable |
동영상을 브라우저 외부에 표시할 수 있는지를 나타냅니다. |
overlay_ads_enabled |
동영상에 오버레이 광고가 재생되는지를 나타냅니다. 오버레이는 10초 후에 동영상 상단에 표시되는 디스플레이 광고입니다. |
other_owners_claiming |
동영상에 소유권 주장이 제기된 다른 콘텐츠 소유자의 이름 |
other_ownership_origination |
다른 소유자의 소유권 발생 소스입니다. |
owned_views |
콘텐츠에 대해 설정한 정책이 수익 창출 또는 추적인 소유한 콘텐츠의 총 조회수입니다. 음악이 아닌 콘텐츠의 YouTube 광고 보고서 및 YouTube Premium 구독 보고서에는 모두 데이터와 연결된 정책이 monetize인지 track인지를 나타내는 policy 필드가 포함되어 있습니다.
|
owned_subscription_views |
콘텐츠 정책에 따라 수익 창출 또는 추적이 적용되는 소유한 콘텐츠의 YouTube Premium 구독 조회수 총계입니다. |
ownership |
특정 지역의 저작물 소유자 |
ownership_last_updated |
소유권이 마지막으로 업데이트된 날짜 및 시간입니다. |
ownership_origination |
소유권 발생 소스입니다. |
ownership_percentage |
내가 소유한 작품의 비율입니다. |
partner_audio_ad_revshare |
수익 공유 비율을 반영한 파트너의 비례 YouTube 오디오 등급 수익 지분입니다. 더 큰 값 계산 시 사용합니다. |
partner_audio_ad_revshare_rate |
파트너 광고 수익 공유 비율입니다. |
partner_playbacks |
내 콘텐츠와 관련된 YouTube 오디오 등급 서비스의 재생 |
partner_revenue |
수익 공유 분할이 적용된 후 광고에서 발생한 수익(USD)입니다. 이 필드는 YouTube 광고 보고서에 표시됩니다. youtube_revenue_split 필드에는 수익 공유 분할이 적용되기 전의 총수익이 포함됩니다.
|
partner_revenue_art_track |
시청각 모드에서 재생된 아트 트랙 콘텐츠의 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_audio |
오디오 전용 모드에서 재생된 콘텐츠의 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_local |
수익 공유 분할이 적용된 후 광고에서 발생한 현지 통화로 표시된 수익입니다. 이 필드는 YouTube 광고 보고서에 표시됩니다. youtube_revenue_split 필드에는 수익 공유 분할이 적용되기 전의 총수익이 포함됩니다.
|
partner_revenue_usd |
수익 공유 분할이 적용된 후 광고에서 발생한 수익입니다. 이 필드는 YouTube 광고 보고서에 표시됩니다. youtube_revenue_split 필드에는 수익 공유 분할이 적용되기 전의 총수익이 포함됩니다.
|
partner_revenue_auction |
입찰 판매 애드센스 광고에서 발생한 수익입니다. |
partner_revenue_per_play_min |
재생당 최솟값을 기준으로 계산된 수익입니다. 국가 단위로 집계할 때 더 큰 값을 계산하는 데 사용됩니다. |
partner_revenue_per_sub_min |
구독자당 최소값을 기준으로 계산된 국가별 수익으로, 더 큰 값을 계산하는 데 사용됩니다. |
partner_revenue_pro_rata |
수익 공유 비율을 고려한 비례 YouTube Premium 구독 수익 공유 |
partner_revenue_pro_rata_audio |
오디오 전용 모드에서 재생된 콘텐츠의 비례 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_pro_rata_audio_per_sub_min |
오디오 전용으로 재생된 콘텐츠의 비례 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_pro_rata_audio_visual |
시청각 모드에서 재생된 콘텐츠의 비례 YouTube Premium 구독 수익 공유 |
partner_revenue_pro_rata_partner_owned |
시청각 모드에서 재생된 파트너 업로드 콘텐츠의 비례 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_pro_rata_ugc |
시청각 모드에서 재생된 UGC 콘텐츠의 비례 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_pro_rata_art_track |
시청각 모드에서 재생된 아트 트랙 콘텐츠의 비례 YouTube Premium 구독 수익 공유입니다. |
partner_revenue_partner_sold_partner_served |
자체 외부 광고 서버에서 판매 및 게재한 광고에서 발생한 수익입니다. |
partner_revenue_partner_sold_youtube_served |
수익 공유 분할이 적용된 후 DoubleClick for Publishers (DFP)를 통해 판매된 광고에서 발생한 수익입니다. |
partner_revenue_reserved |
수익 공유 분할이 적용된 후 DoubleClick (DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고에서 발생한 수익입니다. |
partner_revenue_ugc |
사용자 제작 콘텐츠로 창출한 수익 |
payment_period |
결제가 이루어진 기간입니다. |
per_play_minimum |
특정 국가의 재생당 최소 요율입니다. |
per_play_minimum_currency |
오디오 재생당 최솟값에 적용된 통화입니다. |
per_play_minimum_partner_revenue |
재생당 최솟값을 기준으로 계산된 수익입니다. 더 큰 값 계산 시 사용합니다. |
per_sub_min_rate |
구독자당 최소값을 기준으로 계산된 국가별 수익으로, 더 큰 값을 계산하는 데 사용됩니다. |
per_subs_min_rate |
특정 국가의 가입자당 최소 비율입니다. |
policy |
동영상에 적용된 정책 값은 monetize 또는 track입니다.
|
pool_participating_rate |
동적 풀에 참여하는 모든 파트너의 광고 지원 (AVOD) 시장 점유율을 업계 주요 기관과 비교한 값입니다. |
postrolls_enabled |
동영상에 포스트롤 광고를 재생할 수 있는지 여부를 나타냅니다. 포스트롤 광고는 시청자가 시청 중인 동영상 또는 라이브 스트림이 끝난 후에 재생됩니다. |
prerolls_enabled |
동영상에 프리롤 광고를 재생할 수 있는지 여부를 나타냅니다. 프리롤 광고는 시청자가 시청 중인 동영상 또는 라이브 스트림 전에 재생됩니다. 프리롤 광고가 두 개 이상 재생되는 경우도 있습니다. |
provider |
참조를 제공한 콘텐츠 소유자의 이름입니다. |
ratings_allowed |
동영상에 평가가 사용 설정되어 있는지를 나타냅니다. |
record_label |
저작물의 메타데이터에서 가져온 음반사 이름. 음악 파트너에게만 해당됩니다. |
reference_id |
소유권 주장과 관련된 참조의 YouTube 생성 ID. 이 필드는 파트너가 업로드한 소유권 주장인 경우 비어 있습니다. |
reference_type |
참조 유형 또는 채널(예: Audio, Visual, AudioVisual)입니다.
|
reference_video_id |
참조의 YouTube 생성 동영상 ID. 소유권 주장이 YouTube 동영상에서 만들어진 참조와 관련된 경우에만 적용됩니다. |
release_date |
저작물의 메타데이터에서 가져온 개봉일/방영일. TV 또는 영화 파트너에게만 해당됩니다. |
revenue_source |
수익의 소스를 나타냅니다. 가능한 값은 다음과 같습니다.
|
revenue_type |
행이 나타내는 수익 유형을 나타냅니다. |
right_type |
소유권 주장과 연결된 음악 작품 권리 유형을 지정합니다. 이 입력란에 사용할 수 있는 유효한 값은 다음과 같습니다.
|
season |
TV 에피소드와 연결된 시즌 번호입니다. 이 필드의 최대 길이는 5바이트입니다. |
shorts_flat_fee_revenue_usd |
Shorts의 정액 요금 수익(USD)입니다. |
shorts_monthly_pool_usd |
Shorts 풀의 월별 수익(USD)입니다. |
shorts_partner_revenue_usd |
Shorts 동영상으로 발생한 파트너 수익(미국 달러)입니다. |
shorts_usages_marketshare |
Shorts 사용의 시장 점유율입니다. |
skippable_video_ads_enabled |
동영상에 건너뛸 수 있는 동영상 광고가 사용 설정되어 있는지를 나타냅니다. 건너뛸 수 있는 인스트림 광고는 YouTube와 Google 동영상 파트너 웹사이트 및 앱에 게시된 다른 동영상 전후 또는 중간에 재생됩니다. 5초 후 시청자가 광고를 건너뛰고 동영상을 계속 볼 수 있는 옵션이 제공됩니다. |
source_of_fingerprint |
특정 참조 파일의 지문 파일 소스입니다. |
sponsored_cards_enabled |
동영상에 스폰서 카드가 사용 설정되어 있는지를 나타냅니다. 스폰서 제품 정보 카드를 사용하면 시청자가 동영상에서 본 제품을 쇼핑할 수 있습니다. |
start_date |
시작 날짜 및 시간 |
status |
저작물의 상태를 나타냅니다. 가능한 값은 active 또는 inactive입니다.
|
studio |
저작물과 연결된 스튜디오입니다. |
subscribers |
구독자 수입니다. |
tax_withholding_rate |
원천징수 보고서에 적용되는 원천징수세율입니다. |
tax_withheld_amount |
원천징수 보고서에 표시된 원천징수 금액입니다. |
third_party_ads_enabled |
동영상에 서드 파티 광고가 사용 설정되어 있는지 여부를 나타냅니다. |
third_party_video_id |
파트너가 광고 타겟팅 목적으로 동영상을 식별하는 데 사용하는 파트너 제공 동영상 ID입니다. |
time_published |
동영상이 YouTube에 게시된 날짜와 시간으로 MM/DD/YYYY HH:MM:SS 형식입니다. 공개된 적이 없는 동영상 (예: 비공개 또는 일부 공개 동영상)의 경우 이 입력란이 비어 있습니다.
|
time_uploaded |
동영상이 YouTube에 업로드된 날짜 및 시간입니다(MM/DD/YYYY HH:MM:SS 형식).
|
tms |
영화 또는 TV 에피소드를 고유하게 식별하는 12~14자리 TMS (Tribune Media Systems) ID 값입니다. |
total_playbacks |
YouTube 오디오 등급 서비스의 총 재생입니다. |
total_revenue_by_source |
광고 또는 정기 결제 수익과 같은 소스별 총수익입니다. |
total_views |
총 조회수입니다. |
unlaunched_territories_adjustment |
출시되지 않은 지역의 Shorts 풀 조정 |
upc |
세계상품코드(UPC), 저작물을 고유하게 식별하는 데 사용되는 메타데이터 입력란(선택사항) |
uploader |
동영상을 업로드한 콘텐츠 소유자의 이름입니다. |
upload_source |
YouTube에 동영상을 업로드하는 데 사용된 방법입니다. |
us_sourced_revenue |
미국에서 발생한 수익 금액입니다. |
usd_local_rate |
달러(미국)에서 현지 통화로 전환할 때 사용되는 환율입니다. 이 값은 보고서 기간 중 일일 거래의 평균 환율을 나타냅니다. |
username |
YouTube 콘텐츠 소유자의 이름입니다. |
video_channel_id |
소유권 주장이 제기된 동영상을 게시한 채널의 YouTube 생성 채널 ID |
video_duration |
동영상 길이입니다. |
video_duration_sec |
동영상 길이(초) |
video_id |
행의 데이터와 연결된 소유권 주장이 제기된 동영상입니다. 필드 값은 동영상을 고유하게 식별하는 YouTube 동영상 ID입니다. YouTube Data API의 videos.list 메서드를 사용하여 동영상에 관한 추가 데이터를 가져올 수 있습니다.
|
video_length |
동영상 길이(초) |
video_privacy_status |
동영상의 공개 범위(공개, 비공개, 일부 공개)를 나타냅니다. |
video_title |
행의 데이터와 연결된 동영상의 제목입니다. |
video_upload_date |
소유권 주장이 제기된 동영상이 게시된 날짜 |
video_url |
YouTube 동영상의 URL입니다. |
views |
동영상의 조회수입니다. |
writers |
세로선으로 구분된 작품 작곡가 목록입니다. |
youtube_revenue_split |
음악 음반사, 영화, TV 파트너의 경우: 콘텐츠에서 발생한 총 YouTube 광고 수익입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다.
음악 음반 제작사: 콘텐츠에서 발생한 총 YouTube 광고 수익으로, 저작물 소유권을 고려하지만 수익 공유 비율에 따라 분할되기 전의 금액입니다. |
youtube_revenue_split_auction |
음반사, 영화, TV 파트너의 경우: 수익 공유 분할을 적용하기 전 입찰 판매 애드센스 광고에서 발생한 총수익입니다. 음악 음반 제작사: 입찰 판매된 애드센스 광고에서 발생한 총수익으로, 저작물 소유권을 고려하지만 수익 공유 분할을 적용하기 전입니다. |
youtube_revenue_split_partner_sold_partner_served |
음반사, 영화, TV 파트너의 경우: 파트너가 판매하고 파트너가 게재한 광고에서 발생한 총수익입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다.
음악 음반 제작사: 파트너가 판매하고 파트너가 게재한 광고에서 발생한 총수익으로, 저작물 소유권을 고려합니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다. |
youtube_revenue_split_partner_sold_youtube_served |
음반사, 영화, TV 파트너의 경우: DoubleClick for Publishers (DFP)의 총수익입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다.
음악 음반 제작사: 저작물 소유권을 고려한 DFP (DoubleClick for Publishers)의 총수익입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다. |
youtube_revenue_split_reserved |
음악 음반사, 영화, TV 파트너의 경우: DoubleClick (DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고에서 발생한 총수익입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다.
음악 음반 제작사: DoubleClick(DCLK) 및 기타 YouTube 판매 소스를 통한 예약 판매 광고에서 발생한 총수익(애셋 소유권 고려)입니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다. |
Primetime
다음 표에서는 Primetime 프로그램 파트너의 YouTube Reporting API 시스템 관리 보고서에 표시되는 필드를 정의합니다.
| 필드 | |
|---|---|
AgeGroup |
보고서의 시청자 연령대입니다. 특정 연령대의 회원이 시청한 이벤트가 50회 이상 있어야 해당 연령대가 표시됩니다. 가능한 필드 값은 다음과 같습니다.
|
AverageViewDuration |
모든 시청 이벤트에서 프로그램이 시청된 평균 시간(초)입니다. |
AverageViewPercent |
모든 시청 이벤트에서 시청된 프로그램의 평균 비율입니다. |
CallSign |
해당하는 경우 프로그램이 방송된 방송국의 호출 부호를 식별합니다. |
ConcurrentViewers |
MinutesSinceStart 필드 값으로 식별되는 에피소드의 특정 분을 시청한 총 시청 이벤트 수입니다.
|
ContentId |
메타데이터 제공업체가 저작물을 식별하는 데 사용하고 YouTube에 제공한 고유한 값입니다. 이 값을 사용하여 저작물을 자체 콘텐츠 관리 시스템과 조정할 수 있습니다. 이 값은 저작물에 대해 만든 고유 ID 또는 TMS ID와 같은 표준 식별자일 수 있습니다. 값의 최대 길이는 64바이트이며 영숫자 문자, 하이픈 (-), 밑줄 (_), 마침표 (.) 또는 'at' 기호 (@) 또는 슬래시 (/)를 포함할 수 있습니다. |
ContentLength |
프로그램 길이(초)입니다. 동적 광고 삽입 (DAI)이 있는 VOD 프로그램의 경우 광고 재생 시간은 포함되지 않습니다. |
ContentType |
시청자가 콘텐츠를 시청한 방식입니다. 가능한 필드 값은 다음과 같습니다.
|
Date |
프로그램 조회가 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
DeviceType |
시청자가 콘텐츠를 시청한 기기의 유형입니다. 특정 기기 유형이 표시되려면 해당 기기 유형에 대한 조회 이벤트가 50개 이상 있어야 합니다. 가능한 필드 값은 다음과 같습니다.
|
DmaId |
Nielsen에서 데이터 행에 설명된 시청 이벤트와 연결된 지정 시장 지역 (DMA)을 식별하는 데 사용하는 3자리 식별자입니다. |
EpisodeNumber |
해당하는 경우 지정된 시즌 내 프로그램의 순차 에피소드 번호를 식별합니다.
시즌은 SeasonNumber 필드로 식별됩니다. 예를 들어 프로그램의 두 번째 시즌 첫 번째 에피소드의 경우 이 값은 1입니다.
|
Gender |
보고서에 포함된 시청자의 성별입니다. 특정 성별의 시청자가 50회 이상 시청해야 해당 성별이 표시됩니다. 가능한 필드 값은 다음과 같습니다.
|
MinutesSinceStart |
시청 이벤트가 시작된 프로그램 시작 시간부터 경과된 분입니다. 이 수치에는 동적 광고 삽입 (DAI)을 사용하는 주문형 (VOD) 프로그램의 경우를 제외하고 프로그램 시간과 광고 시간이 모두 포함됩니다. DAI가 있는 VOD 프로그램의 경우 프로그램 시간만 포함됩니다. |
Network |
콘텐츠를 발표했거나 콘텐츠가 방송된 방송국 또는 방송 네트워크입니다. |
PeakConcurrentViewers |
특정 프로그램의 특정 분에 발생한 최대 동시 시청 이벤트 수입니다. |
Platform |
시청자가 콘텐츠를 시청한 방식입니다. 가능한 필드 값은 다음과 같습니다.
|
ProgramTitle |
에피소드, 영화 또는 이벤트의 제목 또는 이름입니다. |
ProgramType |
시청자가 시청한 프로그램 유형입니다. 가능한 필드 값은 다음과 같습니다.
|
PublishDateTime |
프로그램의 방송 날짜 또는 발표 날짜입니다. 값은 YYYY-MM-DD 형식입니다.
|
SeasonNumber |
프로그램과 연결된 시즌 번호입니다. 이 필드의 최대 길이는 5바이트입니다. |
SeriesTitle |
보고서 행의 데이터와 연결된 계열의 제목입니다. 예를 들어 TV 프로그램의 경우 이 값은 프로그램의 이름을 지정하고 ProgramTitle 필드는 에피소드의 제목을 지정합니다.
|
TmsId |
프로그램을 고유하게 식별하는 12~14자리 Tribune Media Systems (TMS) ID 값입니다. |
TotalWatchTime |
모든 시청 이벤트에서 프로그램이 시청된 총 시간(초)입니다. |
ViewersComplete |
특정 분 동안 시청자가 동영상 시청을 중단한 라이브, DVR, VOD 시청 이벤트의 총 개수입니다. 이 값은 MinutesSinceStart 필드 값으로 식별됩니다. MinutesSinceStart 값이 전체 프로그램(ContentLength)보다 짧은 값을 나타내는 경우 시청자가 프로그램이 끝나기 전에 시청을 중단한 것입니다.
|
ViewersResume |
시청자가 동영상의 첫 번째 분 (0분) 이외의 시점에서 DVR 프로그램 또는 VOD 프로그램을 시작한 총 시청 이벤트 수입니다. |
ViewersStart |
다음 중 하나가 true인 조회 이벤트의 총 개수입니다.
|
Views |
모든 시청 이벤트에서 프로그램이 시청된 총 횟수입니다. |