Фильмы, музыка и телевидение
В следующей таблице определены поля, которые отображаются в отчетах, управляемых системой YouTube Reporting API, для партнеров из кино, музыки и телевидения:
| Поля | |
|---|---|
active_claims | Количество активных заявок. |
active_reference_id | Идентификатор, сгенерированный YouTube для соответствующей активной ссылки. |
activity_month | Месяц составления отчета. |
adjustment_type | Указывает, представляет ли строка обычные данные о выручке или корректировку ранее заявленной выручки:
|
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 | Тип актива. Возможные значения:
|
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 | Способ, которым было создано требование в отношении видео. Возможные значения поля:
|
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 | Источник заявленного видео. Возможные значения поля:
Примечание: В отчетах, загружаемых из меню «Отчеты» в 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 | Источник заявленного видео. Возможные значения:
|
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 | Указаны исключаемые части эталонного фрагмента и тип исключения (например, перекрытие эталонного фрагмента, ручное исключение, недопустимый сегмент). Доступные типы исключения:
|
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 | Указывает источник дохода. Возможные значения:
|
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, полученный от вашего контента. Эта сумма впоследствии распределяется в соответствии с долей дохода. Поле Для музыкальных издателей: Общий доход от рекламы на YouTube, получаемый с учетом владения активами, но до распределения в соответствии с ставкой доли дохода. Поле |
youtube_revenue_split_auction | Для музыкальных лейблов, кино- и телепартнеров: Общий доход от рекламы AdSense, проданной на аукционе, до применения распределения доходов. Для музыкальных издателей: Общий доход от продажи рекламы AdSense на аукционах, с учетом владения активами, но до применения распределения доходов. |
youtube_revenue_split_partner_sold_partner_served | Для музыкальных лейблов, кино- и телепартнеров: Общий доход от рекламы, проданной и показанной партнерами. Эта сумма впоследствии распределяется в соответствии с ставкой распределения дохода. Параметр Для музыкальных издателей: Общий доход от рекламы, продаваемой и размещаемой партнерами, с учетом права собственности на активы. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр |
youtube_revenue_split_partner_sold_youtube_served | Для музыкальных лейблов, кино- и телепартнеров: Общий доход от DoubleClick for Publishers (DFP). Эта сумма впоследствии распределяется в соответствии с ставкой распределения дохода. Параметр Для музыкальных издателей: Общий доход от DoubleClick for Publishers (DFP) с учетом владения активами. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр |
youtube_revenue_split_reserved | Для музыкальных лейблов, кино- и телепартнеров: Общий доход от зарезервированной рекламы, продаваемой через DoubleClick (DCLK) и другие источники, продаваемые YouTube. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр Для музыкальных издателей: Общий доход от зарезервированной рекламы, продаваемой через DoubleClick (DCLK) и другие источники, продаваемые YouTube, с учетом права собственности на активы. Эта сумма впоследствии распределяется в соответствии с долей дохода. Параметр |
your_isrc | Предоставленный вами код ISRC для данного актива. |
Прайм-тайм
В следующей таблице определены поля, которые отображаются в отчетах, управляемых системой YouTube Reporting API для партнеров, занимающихся программами прайм-тайма:
| Поля | |
|---|---|
AgeGroup | Возрастная группа зрителей, указанных в отчете. Обратите внимание, что для включения в список необходимо, чтобы было не менее 50 просмотров представителями определенной возрастной группы. Возможные значения поля:
|
AverageViewDuration | Среднее количество секунд просмотра программы по всем сеансам просмотра. |
AverageViewPercent | Средний процент просмотров программы по всем сеансам просмотра. |
CallSign | При необходимости указывается позывной станции, на которой транслировалась программа. |
ConcurrentViewers | Общее количество просмотров, в течение которых была просмотрена конкретная минута эпизода, определяемая значением поля MinutesSinceStart . |
ContentId | Уникальное значение, которое вы, как поставщик метаданных, используете для идентификации ресурса и которое вы предоставили YouTube. Вы можете использовать это значение для сопоставления ресурса с вашей собственной системой управления контентом. Значение может быть уникальным идентификатором, созданным вами для ресурса, или стандартным идентификатором, например, идентификатором TMS. Значение имеет максимальную длину 64 байта и может содержать буквенно-цифровые символы, дефисы (-), подчеркивания (_), точки (.), символы «@» или косые черты (/). |
ContentLength | Продолжительность программы в секундах. Обратите внимание, что продолжительность рекламных роликов не включена для программ VOD с динамической вставкой рекламы (DAI). |
ContentType | Способ просмотра контента зрителем. Возможные значения поля:
|
Date | Дата, когда были выполнены действия программы. Значение указано в формате YYYYMMDD . |
DeviceType | Тип устройства, на котором зритель просматривал контент. Обратите внимание, что для отображения данного типа устройства в списке должно быть не менее 50 событий просмотра. Возможные значения поля:
|
DmaId | Трехзначный идентификатор, который Nielsen использует для идентификации обозначенных рыночных зон (DMA), связанных с событиями просмотра, описанными в строке данных. |
EpisodeNumber | Если применимо, указывается порядковый номер эпизода программы в указанном сезоне. Сезон обозначается полем SeasonNumber . Например, для первого эпизода второго сезона программы это значение будет равно 1 . |
Gender | Пол зрителей, указанных в отчете. Обратите внимание, что для отображения пола в списке должно быть не менее 50 просмотров, совершенных представителями определенного пола. Возможные значения поля:
|
MinutesSinceStart | Количество минут с момента начала просмотра программы. Обратите внимание, что это число включает как время самой программы, так и время показа рекламы, за исключением программ по запросу (VOD), использующих динамическую вставку рекламы (DAI). Для программ VOD с DAI это число включает только время самой программы. |
Network | Телестанция или сеть, которая выпустила контент или на которой он транслировался. |
PeakConcurrentViewers | Максимальное количество одновременных просмотров конкретной программы в любую минуту. |
Platform | Способ просмотра контента зрителем. Возможные значения поля:
|
ProgramTitle | Название эпизода, фильма или события. |
ProgramType | Тип программы, которую смотрел зритель. Возможные значения поля:
|
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 | Общее количество просмотров, в которых выполняется хотя бы одно из следующих условий:
|
Views | Общее количество просмотров программы по всем сеансам. |