System-Managed Reports - Fields

Фильмы, музыка и телевидение

В следующей таблице определены поля, которые отображаются в отчетах, управляемых системой YouTube Reporting API, для партнеров из кино, музыки и телевидения:

Поля
active_claims Количество активных заявок.
active_reference_id Идентификатор, сгенерированный YouTube для соответствующей активной ссылки.
activity_month Месяц составления отчета.
adjustment_type Указывает, представляет ли строка обычные данные о выручке или корректировку ранее заявленной выручки:
  • Если строка содержит обычные данные о доходах, значение поля равно None . Кроме того, данные в этой строке отображают информацию за месяц, связанный с отчетом.
  • Если строка представляет собой корректировку ранее представленных данных, поле содержит одно из значений из приведенного ниже списка. В этом случае строка может содержать данные за месяцы, отличные от месяца, связанного с отчетом. Например, отчет за ноябрь 2016 года может содержать корректировки, применимые к событиям октября 2016 года или другим предыдущим месяцам.

    Возможные типы корректировок:
    • Backpay — платеж, который был удержан из-за отсутствия информации о владельце.
    • Conflict Resolution — платеж, задержанный из-за конфликта прав собственности. Это также форма задолженности по платежам.
    • Dispute Resolution — платежи, связанные с урегулированным спором по поводу удержанной выручки до осуществления платежей в текущем месяце.
    • Dispute Conflict Resolution — выплата задолженности по заработной плате, возникшей в результате урегулирования спора и не удовлетворенной из-за конфликта прав собственности.
    • Spam Adjustment — платеж, связанный с исправлением спама. Это вычет, который AdSense сообщает как Invalid Activity - YouTube .
    • Revenue Correction — платеж, связанный с технической ошибкой или исправлением данных. Эта сумма может быть зачислена на счет или вычтена.
administer_publish_rights Указывает, занимается ли музыкальный лейбл управлением издательскими правами, то есть собирает и управляет выплатами авторских отчислений авторам песен, композиторам, издателям или другим сторонам, владеющим произведением. Возможные значения: True и False .
adsense_earnings_month Месяц, за который следует запрашивать отчет AdSense.
album Альбом, на котором находится звукозапись. Максимальная длина значения — 255 байт.
approx_daily_views Среднее количество просмотров объекта в день.
approx_daily_engaged_views Примерное количество ежедневных просмотров данного ресурса пользователями.
artist Имя художника, связанного с ресурсом, указанным в строке отчета. Максимальная длина значения — 255 байт.
asset_channel_id Канал, которому принадлежит загруженное партнёром видео, на которое претендует данный ресурс ( asset_id ). Значение поля — это идентификатор канала YouTube, который однозначно идентифицирует канал. Дополнительные данные о канале можно получить с помощью метода channels.list в API данных YouTube.
asset_custom_id Необязательное поле метаданных актива, используемое для уникальной идентификации актива, обычно это внутренний код. Другие партнеры не смогут просмотреть ваши пользовательские идентификаторы.
asset_id Идентификатор ресурса YouTube, который однозначно идентифицирует ресурс, связанный с данными в строке. Вы можете получить дополнительные данные о ресурсе, используя метод assets.list API идентификаторов контента YouTube, или найти ресурс на странице ресурсов studio.youtube.com .
asset_labels Метки активов , связанные с самим активом. Метки активов позволяют группировать активы в пользовательские категории. Затем эти метки можно использовать для поиска активов, обновления групп активов, создания кампаний для помеченных активов, фильтрации в YouTube Analytics и многого другого.
asset_metadata_type Тип ресурса для ссылки, например, Web или Movie .
asset_owners Для справки, здесь указаны текущие владельцы ресурсов. В версии 1.1 и более поздних версиях вместо кодов партнеров используются отображаемые имена владельцев контента (или внешние идентификаторы).
asset_policy_block Территории, в которых страховой полис владельца имеет Block . Значение — это двухбуквенный код страны или региона, обозначающий территорию.
asset_policy_id Уникальный идентификатор политики владельца. В настоящее время это значение доступно только через API. Эта информация не отображается в Studio Content Manager.
asset_policy_monetize Территории, где политика владельца предусматривает Monetize . Значение — это двухбуквенный код страны или региона для данной территории.
asset_policy_track Территории, где в страховом полисе владельца указано Track . Значение — это двухбуквенный код страны или региона для данной территории.
asset_title Право собственности на актив.
asset_type Тип актива. Возможные значения:
  • Art Track : обозначает аудиозапись на YouTube, к которой не прилагается платный музыкальный клип.
  • Composition : Представляет собой музыкальное произведение. Композиция содержит метаданные, такие как ISWC и имена авторов. Это единственный тип актива, который может иметь несколько владельцев на одной территории. Она может быть встроена в звукозапись.
  • Movie : обозначает полнометражный фильм. Фильм содержит метаданные, такие как ISAN/EIDR и имена режиссеров.
  • Music Video : представляет собой официальный музыкальный видеоклип к звуковой записи. Музыкальный клип содержит метаданные, такие как ISRC видео, название песни и имена исполнителей. Музыкальный клип включает в себя звуковую запись.
  • Sound Recording : представляет собой аудиозапись. Звукозапись содержит метаданные, такие как ISRC, исполнитель и альбом. Она включает в себя музыкальный материал и, в свою очередь, может быть встроена в музыкальный видеоклип.
  • Television episode : представляет собой эпизод из телешоу. Эпизод содержит метаданные, такие как номер сезона и номер эпизода.
  • Web : Представляет собой оригинальные видеоролики YouTube или другие типы видеоконтента, не охватываемые другими типами активов.
audio_royalties Ваш признанный доход от доходов от аудиоконтента YouTube. Расчет производится на основе большей из двух величин: доли партнера в чистой выручке от аудиорекламы и минимального партнерского дохода за воспроизведение аудиоконтента.
audio_share Соотношение количества воспроизведений аудиофайлов партнерских сервисов к общему количеству воспроизведений аудиофайлов партнерских сервисов.
category Жанр видео, отображаемый на странице просмотра. Значение представляет собой идентификатор категории видео на YouTube. Вы можете использовать метод videoCategories.list API данных YouTube для получения сопоставления идентификаторов категорий видео с названиями категорий.
channel_display_name Название канала, загрузившего видео.
channel_id Канал, которому принадлежит видео ( video_id ), связанное с данными в строке. Значение поля — это идентификатор канала YouTube, который однозначно идентифицирует канал. Дополнительные данные о канале можно получить с помощью метода channels.list в API данных YouTube.
claiming_asset_type Тип актива, являющегося предметом претензии.
claim_created_date Дата создания заявления.
claim_id Идентификатор претензии YouTube, который однозначно идентифицирует ресурс, связанный с претензией в строке. Вы можете получить дополнительные данные о ресурсе, используя метод claims.list API идентификаторов контента YouTube, или найти ресурс на странице претензий studio.youtube.com .
claim_origin Способ, которым было создано требование в отношении видео. Возможные значения поля:
  • Audio Match
  • Audio Swap
  • Batch Tool
  • CMS_UPLOAD
  • Content ID API
  • Descriptive Search
  • External
  • GameID Match
  • Google Dev ID
  • Hashcode
  • Melody Match
  • SFTP Upload
  • Video Match
  • Web Search
  • Web Upload
  • YouTube Admin
claim_policy_block Территории, где применяется страховой полис Block . Значение — это двухбуквенный код страны/региона.
claim_policy_id Уникальный идентификатор примененной политики. В настоящее время это значение доступно только через API. Эта информация не отображается в Studio Content Manager.
claim_policy_monetize Территории, где применяется политика выплаты Monetize . Значение — это двухбуквенный код страны/региона.
claim_policy_track Территории, где применяется страховой полис Track . Значение — это двухбуквенный код страны/региона.
claim_status Указывает, является ли статус заявки ACTIVE , INACTIVE или PENDING .
claim_status_detail Подробная информация о статусе заявки, например, CLOSED_MANUALLY .
claim_type Указывает, относится ли заявка к аудио-, видео- или аудиовизуальной части заявленного контента. Допустимые значения для этого поля:
  • Аудио
  • Аудиовизуальные
  • Визуальный
claim_quality Источник заявленного видео. Возможные значения поля:
  • Видео Partner-provided партнёром YouTube.
  • Premium UGC — видео было загружено третьей стороной, и защищенные авторским правом фрагменты соответствуют требованиям к длине и соразмерности, чтобы рассматриваться как лицензированный контент, предоставленный партнером, для распределения доходов.
  • UGC — это контент, созданный пользователями, то есть загруженный третьей стороной, но не соответствующий требованиям для того, чтобы рассматриваться как лицензированный контент, предоставленный партнером, для распределения доходов.

Примечание: В отчетах, загружаемых из меню «Отчеты» в YouTube Creator Studio, это поле называется Content Type .

claimed_by_another_owner Указывает, имеет ли другой владелец контента действующее право собственности на видео (как от первого лица, так и от третьего).
claimed_by_this_owner Указывает, имеет ли владелец контента, составивший отчет, действующее право собственности на видео как от первого лица, так и от третьего лица.
comments_allowed Указывает, включены ли комментарии к видео.
composition_right_type Указывает типы прав по мировому соглашению, связанных с иском. Допустимые значения для этого поля:
  • Механический
  • Производительность
  • Синхронизация
conflicting_country_code Коды стран ISO для территорий, на которые распространяются конфликты с кодами других партнеров.
conflicting_owner Идентификаторы партнеров, имеющих конфликтующие права собственности.
conflicting_owner_artist Художники, владеющие активами, являющимися предметом конфликта интересов.
conflicting_owner_asset_title Право собственности на актив от владельца, с которым возник конфликт интересов.
conflicting_owner_isrc Код ISRC актива от владельца, с которым возник конфликт интересов.
content_type Источник заявленного видео. Возможные значения:
  • Видео Partner-provided , — это видео, которое вы загружаете на свой собственный канал YouTube. Вы заявляете права на видео при загрузке и применяете к нему политику использования. Заявление прав на контент, загруженный партнёром, активирует возможности монетизации, сопоставление идентификаторов контента и создание отчётов.
  • Premium UGC — это видео, загруженное третьей стороной, содержащее защищенные авторским правом фрагменты, которые соответствуют требованиям к продолжительности и соразмерности и должны рассматриваться так же, как лицензированный контент, предоставленный партнером.
  • UGC — это видео, загруженное третьей стороной, содержащее контент, который принадлежит вам, как это определено по совпадению Content ID или по ручной заявке. Политика соответствия, связанная с этой заявкой, определяет, где и как видео доступно на YouTube.
constituent_asset_id Предыдущий идентификатор актива до слияния.
constituent_asset_ids Предыдущие идентификаторы активов до слияния.
country Указывает страну, в которой произошла данная деятельность.
country_code Указывает код страны, в которой осуществлялась деятельность. Значение представляет собой двухбуквенный код страны по стандарту ISO 3166-1 .
currency Указывает валюту, которую представляет данная строка.
currency_code Указывает код валюты, которую представляет данная строка.
custom_id Уникальное значение, которое вы, как поставщик метаданных, используете для идентификации актива. Это может быть уникальный идентификатор, созданный вами для актива, или стандартный идентификатор, например, ISRC. Значение имеет максимальную длину 64 байта и может содержать буквенно-цифровые символы, дефисы (-), подчеркивания (_), точки (.), символы "@" или косые черты (/).
date Дата совершения действия. Значение в формате YYYYMMDD .
date_created Дата и время создания ссылки в формате UTC.
date_id Дата совершения действия. Значение в формате YYYYMMDD .
day День, когда произошло это событие.
director Директор, связанный с данным активом.
directors Директора, связанные с данным активом.
display_ads_enabled Указывает, отображается ли в видеоролике реклама сторонних компаний.
display_isrc Для данного актива указан код ISRC.
effective_policy Правила использования, применяемые к видео на территориях, принадлежащих правообладателю контента.
eidr Идентификатор развлекательного контента (EIDR), присваиваемый фильму или телесериалу. Значение содержит стандартный префикс для реестра EIDR, за которым следует косая черта, 20-символьная шестнадцатеричная строка и буквенно-цифровой (0-9A-Z) контрольный символ.
embedding_allowed Указывает, можно ли встроить видео на сторонние веб-сайты.
end_date Дата и время окончания.
engaged_views Общее количество просмотров, сгенерированных пользователями, получившими поддержку от рекламы.
engaged_views_in_conflict Количество просмотров и откликов на контент, содержащий конфликтную информацию.
episode_number Номер эпизода, связанный с видео.
episode_title Название эпизода телесериала или фильма.
excluded_perc Процент исключенных фрагментов текста, рассчитанный на основе общего числа исключений и длины.
exclusions Указаны исключаемые части эталонного фрагмента и тип исключения (например, перекрытие эталонного фрагмента, ручное исключение, недопустимый сегмент). Доступные типы исключения:
  • O = Исключение вручную через Менеджер контента
  • P = Исключение вручную через API
  • I = Ручное исключение при доставке контента
  • C = Перекрытие опорных точек
  • S = Недопустимый сегмент
  • B = Постоянное исключение
grid Глобальный идентификатор релиза — необязательное поле метаданных, используемое для уникальной идентификации актива. Значение этого поля содержит ровно 18 буквенно-цифровых символов.
has_multiple_claims Указывает, есть ли на видео более одного утверждения. Значение равно false , если на видео есть одно утверждение, и true если их несколько.

Примечание: В отчетах, загружаемых из меню «Отчеты» в YouTube Creator Studio, это поле называется Multiple Claims? .
hfa Шестисимвольный код, выдаваемый агентством Harry Fox Agency (HFA) для уникальной идентификации композиции.
hfa_song_code Шестисимвольный код, выдаваемый агентством Harry Fox Agency (HFA) для уникальной идентификации композиции.
inactive_reference_id Идентификатор, сгенерированный YouTube для соответствующей неактивной ссылки.
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) соответствующего актива. Значение поля содержит ровно 12 буквенно-цифровых символов.
iswc Международный стандартный код музыкального произведения (ISWC) для данного произведения. Значение поля содержит ровно 11 символов в формате буква (T), за которой следуют 10 цифр.
label Звукозаписывающая компания, выпустившая звукозапись. Максимальная длина значения — 255 байт.
lifetime_engaged_views_in_conflict Пожизненное внимание к контенту, вызывающему конфликт.
lifetime_views_in_conflict Общее количество просмотров за все время существования конфликтного контента.
length_sec Длительность отсчета в секундах.
local_currency Вид местной валюты, в которой выплачиваются доходы.
longest_match Наиболее длинный совпадающий фрагмент заявки.
long_nonskippable_video_ads_enabled Устарело: это поле устарело и всегда заполняется значением No . Ранее указывалось, могут ли воспроизводиться длинные рекламные ролики сторонних разработчиков, которые нельзя пропустить, во время просмотра видео.
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 в рамках подписки YouTube Premium. Это значение доступно только музыкальным партнерам.
monetized_views_ugc_audio Количество аудиопотоков пользовательского контента (UGC), которые были отнесены к вашему контенту в рамках подписки YouTube Premium. Под UGC понимаются видеоролики, загруженные пользователями, которые не рассматриваются так же, как лицензированный контент, предоставленный партнерами для распределения доходов. Это поле поддерживается только для музыкальных партнеров.
monetized_views_ugc_audio_visual Количество аудиовизуальных просмотров пользовательского контента (UGC), которые были отнесены к вашему контенту в рамках подписки YouTube Premium. Под 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. Это значение актуально только для музыкальных партнеров.
monetized_watchtime Общее время просмотра ваших видеороликов, не относящихся к музыке, в секундах, в рамках подписки YouTube Premium.
month Месяц, в котором произошло данное событие.
midrolls_enabled Указывает, можно ли воспроизводить рекламные вставки в середине видео. Рекламные вставки — это видеореклама, которая появляется во время другого видео или события. Например, рекламная вставка может появляться с интервалами во время полнометражного фильма. Рекламные вставки в середине видео предназначены только для лицензированного контента.
multiple_claims Указывает, есть ли на видео более одного утверждения. Значение равно false , если на видео есть одно утверждение, и true если их несколько.

Примечание: В отчетах, загружаемых из меню «Отчеты» в YouTube Creator Studio, это поле называется 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 для не музыкального контента содержится поле policy , указывающее, была ли политика, связанная с данными, monetize или track .
owned_subscription_views Общее количество просмотров вашего контента, на который ведут вовлеченные пользователи YouTube Premium, для которых политика монетизации контента установлена ​​на «монетизация» или «отслеживание».
ownership Владелец актива на определенной территории.
ownership_last_updated Дата и время последнего обновления информации о владельце.
ownership_origination Источник происхождения права собственности.
ownership_percentage Процентное содержание композиции, которым вы владеете.
partner_audio_ad_revshare Ваша пропорциональная доля дохода в рамках тарифа YouTube Audio Tier с учетом коэффициента распределения доходов. Используется для расчета наибольшего из значений.
partner_audio_ad_revshare_rate Доля партнера в доходах от рекламы.
partner_playbacks Воспроизведения вашего контента в сервисе YouTube Audio Tier будут приписываться именно ему.
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 Ваш доход от рекламы AdSense, продаваемой на аукционе.
partner_revenue_per_play_min Доход рассчитывается на основе минимальных ставок за игру. Используется для расчета большей из двух величин при агрегировании данных по странам.
partner_revenue_per_sub_min Доходы по странам рассчитываются на основе минимального количества абонентов; используется метод вычисления на основе большей из двух величин.
partner_revenue_pro_rata Ваша пропорция дохода от подписки YouTube Premium, рассчитанная с учетом ставок распределения прибыли.
partner_revenue_pro_rata_audio Ваша доля дохода от подписки YouTube Premium Pro за контент, воспроизводимый только в аудиорежиме.
partner_revenue_pro_rata_audio_per_sub_min Ваша доля дохода от подписки YouTube Premium Pro Rata за контент, воспроизводимый только в аудиоформате.
partner_revenue_pro_rata_audio_visual Ваша доля дохода от подписки YouTube Premium Pro за контент, воспроизводимый в аудиовизуальном режиме.
partner_revenue_pro_rata_partner_owned Ваша доля дохода от подписки YouTube Premium Pro за контент, загруженный партнерами и воспроизводимый в аудиовизуальном режиме.
partner_revenue_pro_rata_ugc Ваша доля дохода от подписки YouTube Premium Pro Rata за пользовательский контент, воспроизводимый в аудиовизуальном режиме.
partner_revenue_pro_rata_art_track Ваша доля дохода от подписки YouTube Premium Pro за контент Art Track, воспроизводимый в аудиовизуальном режиме.
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, для ссылки, связанной с претензией. Это поле будет пустым для претензий, загруженных партнерами.
reference_type Тип ссылки или канал, например, Audio , Visual , AudioVisual .
reference_video_id Идентификатор видео, сгенерированный YouTube, для ссылки. Применяется только в том случае, если утверждение связано со ссылкой, созданной на основе видео с YouTube.
release_date Дата выпуска указана в метаданных ресурса. Актуально только для партнеров в сфере телевидения/кино.
revenue_source Указывает источник дохода. Возможные значения:
  • Ads — доход от рекламы, показанной в видеоролике.
  • Subscriptions — доход от платных подписок YouTube Premium.
  • Transactions — Доход от транзакций, таких как платный контент или покупки.
revenue_type Указывает тип дохода, который представляет данная строка.
right_type Указывает типы прав по мировому соглашению, связанных с иском. Допустимые значения для этого поля:
  • Механический
  • Производительность
  • Синхронизация
season Номер сезона, соответствующий эпизоду телесериала. Максимальная длина поля — 5 байт.
shorts_flat_fee_revenue_usd Доход от фиксированной комиссии в долларах США для коротких позиций.
shorts_monthly_pool_usd Ежемесячная выручка в долларах США для пула коротких позиций.
shorts_partner_revenue_usd Доходы партнеров в долларах США для Shorts.
shorts_usages_marketshare Доля рынка использования шорт.
skippable_video_ads_enabled Указывает, включена ли возможность пропуска рекламы в видео. Пропускаемая внутрипотоковая реклама воспроизводится до, во время или после других видео на YouTube, а также на веб-сайтах и ​​в приложениях партнеров Google Video. Через 5 секунд у зрителя есть возможность пропустить рекламу и продолжить просмотр видео.
source_of_fingerprint Источник отпечатка пальца для заданного эталонного файла.
sponsored_cards_enabled Указывает, включены ли рекламные карточки для видео. Рекламные карточки с информацией о товарах позволяют зрителям приобретать товары, которые они видят в видео.
sr_approx_daily_engaged_views Примерное количество ежедневных просмотров звукозаписи, вызывающих активность.
start_date Дата и время начала.
status Указывает на статус актива. Возможные значения: active или inactive .
status_detail Предоставляет дополнительную информацию или объяснение статуса справочного файла. Это поле доступно только в версии 1.1 еженедельного отчета по справочным материалам.
studio Студия, связанная с данным активом.
subscribers Количество подписчиков.
tax_withholding_rate Применяемая ставка удержания налога, указанная в отчете об удержании налога.
tax_withheld_amount Сумма удержанного налога, указанная в отчете об удержании налога.
third_party_ads_enabled Указывает, включена ли показ сторонней рекламы для данного видео.
third_party_video_id Идентификатор видео, предоставленный партнером, используется партнером для идентификации видео в целях таргетирования рекламы.
time_published Дата и время публикации видео на YouTube в формате MM/DD/YYYY HH:MM:SS . Это поле будет пустым для видео, которые никогда не публиковались (т.е. частных или скрытых видео).
time_uploaded Дата и время загрузки видео на YouTube в формате MM/DD/YYYY HH:MM:SS .
tms Идентификационный номер Tribune Media Systems (TMS), состоящий из 12–14 символов, который однозначно идентифицирует фильм или телеэпизод.
total_playbacks Общее количество прослушиваний в сервисе YouTube Audio Tier.
total_revenue_by_source Общий доход по источникам, таким как реклама или подписка.
total_views Общее количество просмотров, сгенерированных пользователями, получившими поддержку от рекламы.
unlaunched_territories_adjustment Корректировка пула коротких позиций для территорий, где запуск новых продуктов еще не состоялся.
upc Универсальный код продукта (UPC) — необязательное поле метаданных, используемое для уникальной идентификации актива.
uploader Имя владельца контента, загрузившего видео.
upload_source Способ загрузки видео на YouTube.
us_sourced_revenue Объем доходов, получаемых из Соединенных Штатов.
usd_local_rate Обменный курс, используемый для конвертации долларов США в местную валюту. Значение представляет собой средний курс для ежедневных транзакций за отчетный период.
username Имя владельца контента на YouTube.
video_channel_id Идентификатор канала, сгенерированный YouTube, для канала, опубликовавшего заявленное видео.
video_duration Длительность видео.
video_duration_sec Длительность видео в секундах.
video_id Видео, указанное в строке, является идентификатором видео на YouTube, который однозначно идентифицирует видео. Дополнительные данные о видео можно получить с помощью метода videos.list в API данных YouTube.
video_length Длительность видео в секундах.
video_matching_length Общая совпадающая продолжительность в заявленном видео.
video_privacy_status Указывает, является ли видео общедоступным, частным или скрытым.
video_title Название видеоролика, связанного с данными в строке.
video_upload_date Дата публикации заявленного видео.
video_url URL-адрес видео на YouTube.
views Количество просмотров видео.
writers Список авторов композиции, разделённый символом вертикальной черты.
youtube_revenue_split

Для музыкальных лейблов, кино- и телепартнеров: Общий доход от рекламы на YouTube, полученный от вашего контента. Эта сумма впоследствии распределяется в соответствии с долей дохода. Поле partner_revenue содержит ваш доход.

Для музыкальных издателей: Общий доход от рекламы на YouTube, получаемый с учетом владения активами, но до распределения в соответствии с ставкой доли дохода. Поле partner_revenue содержит ваш доход.

youtube_revenue_split_auction

Для музыкальных лейблов, кино- и телепартнеров: Общий доход от рекламы AdSense, проданной на аукционе, до применения распределения доходов.

Для музыкальных издателей: Общий доход от продажи рекламы AdSense на аукционах, с учетом владения активами, но до применения распределения доходов.

youtube_revenue_split_partner_sold_partner_served

Для музыкальных лейблов, кино- и телепартнеров: Общий доход от рекламы, проданной и показанной партнерами. Эта сумма впоследствии распределяется в соответствии с ставкой распределения дохода. Параметр partner_revenue_partner_served_partner_sold содержит ваш доход от рекламы, проданной и показанной партнерами.

Для музыкальных издателей: Общий доход от рекламы, продаваемой и размещаемой партнерами, с учетом права собственности на активы. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр partner_revenue_partner_served_partner_sold содержит ваш доход от рекламы, продаваемой и размещаемой партнерами.

youtube_revenue_split_partner_sold_youtube_served

Для музыкальных лейблов, кино- и телепартнеров: Общий доход от DoubleClick for Publishers (DFP). Эта сумма впоследствии распределяется в соответствии с ставкой распределения дохода. Параметр partner_revenue_partner_served_partner_sold содержит ваш доход от рекламы, продаваемой и показываемой партнерами.

Для музыкальных издателей: Общий доход от DoubleClick for Publishers (DFP) с учетом владения активами. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр partner_revenue_partner_sold_youtube_sold содержит ваш доход от рекламы, продаваемой и показываемой партнерами.

youtube_revenue_split_reserved

Для музыкальных лейблов, кино- и телепартнеров: Общий доход от зарезервированной рекламы, продаваемой через DoubleClick (DCLK) и другие источники, продаваемые YouTube. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр partner_revenue_reserved содержит ваш доход от этих источников.

Для музыкальных издателей: Общий доход от зарезервированной рекламы, продаваемой через DoubleClick (DCLK) и другие источники, продаваемые YouTube, с учетом права собственности на активы. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр partner_revenue_reserved содержит ваш доход от этих источников.

your_isrc Предоставленный вами код ISRC для данного актива.

Прайм-тайм

В следующей таблице определены поля, которые отображаются в отчетах, управляемых системой YouTube Reporting API для партнеров, занимающихся программами прайм-тайма:

Поля
AgeGroup Возрастная группа зрителей, указанных в отчете. Обратите внимание, что для включения в список необходимо, чтобы было не менее 50 просмотров представителями определенной возрастной группы. Возможные значения поля:
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration Среднее количество секунд просмотра программы по всем сеансам просмотра.
AverageViewPercent Средний процент просмотров программы по всем сеансам просмотра.
CallSign При необходимости указывается позывной станции, на которой транслировалась программа.
ConcurrentViewers Общее количество просмотров, в течение которых была просмотрена конкретная минута эпизода, определяемая значением поля MinutesSinceStart .
ContentId Уникальное значение, которое вы, как поставщик метаданных, используете для идентификации ресурса и которое вы предоставили YouTube. Вы можете использовать это значение для сопоставления ресурса с вашей собственной системой управления контентом. Значение может быть уникальным идентификатором, созданным вами для ресурса, или стандартным идентификатором, например, идентификатором TMS. Значение имеет максимальную длину 64 байта и может содержать буквенно-цифровые символы, дефисы (-), подчеркивания (_), точки (.), символы «@» или косые черты (/).
ContentLength Продолжительность программы в секундах. Обратите внимание, что продолжительность рекламных роликов не включена для программ VOD с динамической вставкой рекламы (DAI).
ContentType Способ просмотра контента зрителем. Возможные значения поля:
  • DVR : Зритель записал программу и сохранил её на свой видеорегистратор.
  • Live : Зритель смотрел программу во время ее первоначальной прямой трансляции. Например, зритель смотрел спортивное событие в прямом эфире.
  • VOD : Зритель выбрал эпизод или программу, доступную по запросу.
Date Дата, когда были выполнены действия программы. Значение указано в формате YYYYMMDD .
DeviceType Тип устройства, на котором зритель просматривал контент. Обратите внимание, что для отображения данного типа устройства в списке должно быть не менее 50 событий просмотра. Возможные значения поля:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId Трехзначный идентификатор, который Nielsen использует для идентификации обозначенных рыночных зон (DMA), связанных с событиями просмотра, описанными в строке данных.
EpisodeNumber Если применимо, указывается порядковый номер эпизода программы в указанном сезоне. Сезон обозначается полем SeasonNumber . Например, для первого эпизода второго сезона программы это значение будет равно 1 .
Gender Пол зрителей, указанных в отчете. Обратите внимание, что для отображения пола в списке должно быть не менее 50 просмотров, совершенных представителями определенного пола. Возможные значения поля:
  • Male
  • Female
MinutesSinceStart Количество минут с момента начала просмотра программы. Обратите внимание, что это число включает как время самой программы, так и время показа рекламы, за исключением программ по запросу (VOD), использующих динамическую вставку рекламы (DAI). Для программ VOD с DAI это число включает только время самой программы.
Network Телестанция или сеть, которая выпустила контент или на которой он транслировался.
PeakConcurrentViewers Максимальное количество одновременных просмотров конкретной программы в любую минуту.
Platform Способ просмотра контента зрителем. Возможные значения поля:
  • Android
  • iOS
  • TV HTML5
  • Web
ProgramTitle Название эпизода, фильма или события.
ProgramType Тип программы, которую смотрел зритель. Возможные значения поля:
  • PROGRAM_TYPE_UNKNOWN
  • PROGRAM_TYPE_MOVIE
  • PROGRAM_TYPE_EPISODE
  • PROGRAM_TYPE_COMPLEX_EPISODE
  • PROGRAM_TYPE_SPORTS
  • PROGRAM_TYPE_SPECIAL
  • PROGRAM_TYPE_EVENT
  • PROGRAM_TYPE_PAID_PROGRAMMING
PublishDateTime Дата выхода программы в эфир или дата её публикации. Значение указывается в формате YYYY-MM-DD .
SeasonNumber Номер сезона, связанный с программой. Максимальная длина поля — 5 байт.
SeriesTitle Название сериала, связанного с данными в строке отчета. Например, для телепрограммы это значение будет указывать название шоу, а поле ProgramTitle — название эпизода.
TmsId Идентификационный номер Tribune Media Systems (TMS), состоящий из 12–14 символов, который однозначно идентифицирует программу.
TotalWatchTime Общее время просмотра программы в секундах по всем сеансам просмотра.
ViewersComplete Общее количество просмотров в прямом эфире, с записи и по запросу, во время которых зритель прекращал просмотр видео в течение определенной минуты, определяется значением поля MinutesSinceStart . Если значение MinutesSinceStart меньше, чем длительность всей программы ( ContentLength ), то эти зрители прекратили просмотр до окончания программы.
ViewersResume Общее количество просмотров, в которых зритель запускает программу, записанную на видеорегистратор (DVR), или программу, записанную по запросу (VOD), в любой момент времени, кроме первой минуты (минуты 0) видео.
ViewersStart Общее количество просмотров, в которых выполняется хотя бы одно из следующих условий:
  • Зритель мог присоединиться к прямой трансляции в любую минуту этой программы.
  • Зритель запустил программу на видеорегистраторе в любой момент в течение первой минуты (минуты 0).
  • Зритель запустил программу VOD в любой момент в течение первой минуты (минуты 0).
Views Общее количество просмотров программы по всем сеансам.