영화, 음악, 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 |
저작물의 평균 일일 조회수입니다. |
approx_daily_engaged_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 인 지역. 값은 지역의 두 글자 국가 또는 지역 코드입니다.
|
asset_policy_track |
소유자 정책이 Track 인 지역. 값은 지역의 두 글자 국가 또는 지역 코드입니다.
|
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 인 지역. 값은 두 자리 국가/지역 코드입니다.
|
claim_policy_id |
적용된 정책의 고유 식별자입니다. 현재 이 값은 API에서만 사용할 수 있습니다. 이 정보는 스튜디오 콘텐츠 관리자에는 표시되지 않습니다. |
claim_policy_monetize |
적용된 소유권 주장 정책이 Monetize 인 지역. 값은 두 자리 국가/지역 코드입니다.
|
claim_policy_track |
적용된 소유권 주장 정책이 Track 인 지역. 값은 두 자리 국가/지역 코드입니다.
|
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입니다. |
conflicting_owner_artist |
충돌하는 소유자의 저작물에 포함된 아티스트입니다. |
conflicting_owner_asset_title |
충돌하는 소유자의 저작물 제목입니다. |
conflicting_owner_isrc |
분쟁 중인 소유자의 저작물 ISRC입니다. |
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바이트이며 영숫자 문자, 하이픈(-), 밑줄(_), 마침표(.), @ 기호 또는 슬래시(/)를 사용할 수 있습니다. |
date |
활동이 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
date_created |
참조가 생성된 날짜 및 시간(UTC)입니다. |
date_id |
활동이 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
day |
활동이 발생한 날짜입니다. |
director |
저작물과 연결된 감독입니다. |
directors |
저작물에 연결된 감독입니다. |
display_ads_enabled |
동영상에 서드 파티 광고가 표시되는지 여부를 나타냅니다. |
display_isrc |
저작물에 표시되는 ISRC입니다. |
effective_policy |
콘텐츠 소유자가 소유권을 가진 지역에서 동영상에 적용되는 사용 정책입니다. |
eidr |
영화 또는 TV 에피소드에 할당된 EIDR (Entertainment Identifier Registry)입니다. 값에는 EIDR 등록을 위한 표준 프리픽스가 포함되며, 그 뒤로 슬래시, 20자리 16진수 문자열 및 영숫자(0~9/A~Z)인 1자리 확인 문자가 이어집니다. |
embedding_allowed |
동영상을 서드 파티 웹사이트에 삽입할 수 있는지 여부를 나타냅니다. |
end_date |
종료 날짜 및 시간입니다. |
engaged_views |
광고 지원 사용자가 생성한 총 유효 조회수입니다. |
engaged_views_in_conflict |
콘텐츠의 참여도 높은 조회수입니다. |
episode_number |
동영상과 연결된 에피소드 번호입니다. |
episode_title |
TV 또는 영화 에피소드의 제목입니다. |
excluded_perc |
전체 제외 및 길이를 기준으로 참조가 제외되는 비율입니다. |
exclusions |
참조의 제외된 비율과 제외 유형 (예: 참조 중복, 수동 제외, 잘못된 세그먼트)
사용할 수 있는 제외 유형:
|
grid |
GRid(Global Release Identifier), 저작물을 고유하게 식별하는 데 사용되는 메타데이터 필드(선택사항) 필드의 값은 정확히 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)입니다. 필드의 값은 문자 (T) 뒤로 10자리 숫자가 이어지는 형식으로 정확히 11자리입니다. |
label |
음원을 출시한 음반사입니다. 값의 최대 길이는 255바이트입니다. |
lifetime_engaged_views_in_conflict |
정책을 위반하는 콘텐츠의 전체 참여 조회수입니다. |
lifetime_views_in_conflict |
분쟁이 있는 콘텐츠의 전체 조회수입니다. |
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_isrc |
다른 파트너가 저작물에 대해 제공한 ISRC입니다. |
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 |
수익 공유 분할이 적용된 후 광고에서 발생한 수익(미국 달러)입니다. 이 필드는 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의 정액 요금 수익(미국 달러)입니다. |
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 |
동영상에 스폰서 카드가 사용 설정되어 있는지 여부를 나타냅니다. 스폰서 제품 정보 카드를 사용하면 시청자가 동영상에 표시된 제품을 구매할 수 있습니다. |
sr_approx_daily_engaged_views |
음원의 대략적인 일일 유효 조회수입니다. |
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자리 Tribune Media Systems (TMS) 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_matching_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 판매 소스를 통한 예약 판매 광고에서 발생한 총수익으로, 애셋 소유권이 반영됩니다. 이 금액은 이후 수익 공유 비율에 따라 분할됩니다. |
your_isrc |
저작물에 대해 제공한 ISRC입니다. |
Primetime
다음 표에서는 Primetime 프로그램 파트너를 위해 YouTube Reporting API 시스템 관리 보고서에 표시되는 필드를 정의합니다.
필드 | |
---|---|
AgeGroup |
보고서에 포함된 시청자의 연령대입니다. 특정 연령대 그룹이 표시되려면 해당 그룹의 구성원이 50회 이상 시청해야 합니다. 가능한 필드 값은 다음과 같습니다.
|
AverageViewDuration |
모든 시청 이벤트에서 프로그램의 평균 시청 시간(초)입니다. |
AverageViewPercent |
모든 시청 이벤트에서 시청한 프로그램의 평균 비율입니다. |
CallSign |
해당하는 경우 프로그램이 방송된 방송국의 호출 부호를 식별합니다. |
ConcurrentViewers |
MinutesSinceStart 필드 값으로 식별되는 에피소드의 특정 분이 시청된 시청 이벤트의 총수입니다.
|
ContentId |
메타데이터 제공자가 저작물을 식별하는 데 사용하고 YouTube에 제공한 고유한 값입니다. 이 값을 사용하여 저작물을 자체 콘텐츠 관리 시스템과 조정할 수 있습니다. 값은 저작물에 대해 만든 고유 ID 또는 TMS ID와 같은 표준 식별자일 수 있습니다. 값의 최대 길이는 64바이트이며 영숫자 문자, 하이픈(-), 밑줄(_), 마침표(.), @ 기호 또는 슬래시(/)를 사용할 수 있습니다. |
ContentLength |
프로그램의 길이(초)입니다. 동적 광고 삽입 (DAI)이 있는 VOD 프로그램의 경우 광고 재생 시간은 포함되지 않습니다. |
ContentType |
시청자가 콘텐츠를 시청한 방식입니다. 가능한 필드 값은 다음과 같습니다.
|
Date |
프로그램 조회수가 발생한 날짜입니다. 값은 YYYYMMDD 형식입니다.
|
DeviceType |
시청자가 콘텐츠를 시청한 기기의 유형입니다. 특정 기기 유형이 나열되려면 해당 기기 유형에 대한 시청 이벤트가 50개 이상 있어야 합니다. 가능한 필드 값은 다음과 같습니다.
|
DmaId |
데이터 행에 설명된 시청 이벤트와 연결된 지정 시장 지역 (DMA)을 식별하는 데 Nielsen이 사용하는 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 |
시청자가 동영상의 첫 1분 (0분) 이외의 시점에서 DVR 프로그램 또는 VOD 프로그램을 시작한 시청 이벤트의 총수입니다. |
ViewersStart |
다음 중 하나라도 해당하는 조회 이벤트의 총수입니다.
|
Views |
모든 시청 이벤트에서 프로그램이 조회된 총횟수입니다. |