System-Managed Reports - Fields

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

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

Поля
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 Content ID или найти ресурс на странице ресурсов studio.youtube.com .
asset_labels Метки объектов , связанные с объектом. Метки объектов позволяют группировать объекты по пользовательским категориям. Эти метки можно использовать для поиска объектов, обновления групп объектов, создания кампаний для отмеченных объектов, фильтрации YouTube Analytics и многого другого.
asset_metadata_type Тип ресурса для ссылки, например, Web или Фильм.
asset_owners Для справки: владельцы текущих активов.
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 Tier. Рассчитывается как наибольшее из двух значений: доли партнера в чистом доходе от аудиорекламы и минимального дохода партнера от аудиорекламы за воспроизведение.
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 Content ID или найти ресурс на странице заявок 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 — видео представляет собой контент, созданный пользователями, то есть оно было загружено третьей стороной, но не соответствует требованиям, чтобы рассматривать его так же, как лицензированный контент, предоставляемый партнерами, в целях распределения доходов.

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

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 alpha-2 .
currency Указывает денежную валюту, которую представляет строка.
currency_code Указывает код денежной валюты, которую представляет строка.
custom_id Уникальное значение, которое вы, поставщик метаданных, используете для идентификации актива. Это может быть уникальный идентификатор, созданный вами для актива, или стандартный идентификатор, например, ISRC. Значение имеет максимальную длину 64 байта и может содержать буквы, цифры, дефисы (-), подчёркивания (_), точки (.), символы «at» (@) или косые черты (/).
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 Указывает, может ли воспроизводиться длинная сторонняя реклама без возможности пропуска во время видео. Встроенная видеореклама показывается во время воспроизведения видеоконтента.
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 Тип ставки Revshare, применяемой к доходу.
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 с учётом ставок RevShare. Используется для расчёта большего из двух значений.
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 с учетом ставок RevShare.
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 Ваша пропорциональная доля дохода от подписки на 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 для ссылки, связанной с заявкой. Это поле будет пустым для заявок, загруженных партнёрами.
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.
shorts_partner_revenue_usd Доход партнера в долларах США за короткие видео.
shorts_usages_marketshare Доля рынка использования коротких видео.
skippable_video_ads_enabled Указывает, включены ли в видео пропускаемые видеорекламы. Пропускаемые in-stream-рекламы воспроизводятся до, во время или после других видео на 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 Предоставленный партнером идентификатор видео, используемый партнером для идентификации видео в целях таргетинга рекламы.
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, который вы предоставили для актива.

Прайм-тайм

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

Поля
AgeGroup Возрастная группа зрителей в отчёте. Обратите внимание, что для включения в отчёт необходимо не менее 50 просмотров представителями определённой возрастной группы. Возможные значения поля:
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration Среднее количество секунд просмотра программы по всем событиям просмотра.
AverageViewPercent Средний процент просмотров программы среди всех событий просмотра.
CallSign Если применимо, указывает позывной радиостанции, на которой транслировалась программа.
ConcurrentViewers Общее количество событий просмотра, в течение которых была просмотрена конкретная минута эпизода, определяемая значением поля MinutesSinceStart .
ContentId Уникальное значение, которое вы, как поставщик метаданных, используете для идентификации ресурса и которое вы предоставили YouTube. Вы можете использовать это значение для согласования ресурса с вашей системой управления контентом. Значение может быть уникальным идентификатором, созданным вами для ресурса, или стандартным идентификатором, например, идентификатором TMS. Значение имеет максимальную длину 64 байта и может содержать буквы, цифры, дефисы (-), подчеркивания (_), точки (.), символы «at» (@) или косые черты (/).
ContentLength Продолжительность программы в секундах. Обратите внимание, что продолжительность рекламы не учитывается для программ VOD с динамической вставкой рекламы (DAI).
ContentType Способ просмотра контента зрителем. Возможные значения поля:
  • DVR : Зритель записал программу и сохранил ее на своем DVR.
  • Live : Зритель смотрел программу во время её первоначальной прямой трансляции. Например, зритель смотрел прямую трансляцию спортивного события.
  • VOD : зритель выбрал эпизод или программу, доступную по запросу.
Date Дата, когда программа была просмотрена. Значение имеет формат YYYYMMDD .
DeviceType Тип устройства, на котором зритель просматривал контент. Обратите внимание, что для отображения типа устройства в списке должно быть не менее 50 просмотров. Возможные значения поля:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId Трехзначный идентификатор, который Nielsen использует для идентификации выделенной рыночной зоны (DMA), связанной с событиями просмотра, описанными в строке данных.
EpisodeNumber Если применимо, определяет порядковый номер эпизода программы в указанном сезоне. Сезон определяется полем SeasonNumber . Например, для первого эпизода второго сезона программы это значение будет равно 1 .
Gender Пол зрителей в отчёте. Обратите внимание, что для включения в отчёт необходимо не менее 50 просмотров представителями определённого пола. Возможные значения поля:
  • Male
  • Female
MinutesSinceStart Количество минут после начала программы, когда началось событие просмотра. Обратите внимание, что это число включает в себя как время программы, так и время AD, за исключением программирования по требованию (VOD), которое использует динамическую AD вставку (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 Значение идентификатора Media Systems (TMS) от 12 до 14-характера, которое однозначно идентифицирует программу.
TotalWatchTime Общее количество времени, в считанные секунды, что программа наблюдалась во всех событиях просмотра.
ViewersComplete Общее количество событий просмотра в прямом эфире, DVR и VOD, в течение которых зритель перестал смотреть видео в течение определенной минуты, что идентифицируется по значению поля MinutesSinceStart . Если значение MinutesSinceStart представляет собой значение короче всей программы ( ContentLength ), то эти зрители перестали смотреть до окончания программы.
ViewersResume Общее количество событий просмотра, в которых зритель запускает либо программу DVR, либо программу VOD в любой точке, кроме первой минуты (минута 0) видео.
ViewersStart Общее количество событий просмотра, в которых любое из следующего является правдой:
  • Зритель присоединился к прямому потоку в любую минуту этой программы.
  • Зритель запустил программу DVR в любой момент в течение первой минуты (минута 0).
  • Зритель запустил программу VOD в любой момент в течение своей первой минуты (минута 0).
Views Общее количество раз, когда программа рассматривалась во всех событиях просмотра.