Metrics

В этом документе определяются показатели, которые получает API отчетов YouTube. Этот API извлекает отчеты с массовыми данными, которые содержат данные YouTube Analytics для канала или владельца контента.

Метрики – это отдельные измерения активности пользователей, эффективности рекламы или расчетного дохода. Показатели активности пользователей включают в себя такие вещи, как количество просмотров видео и рейтинги (нравится и не нравится).

Основные показатели

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

В приведенном ниже списке указаны основные показатели API. Любые из этих показателей, которые также используются в API YouTube Analytics, также являются основными показателями в этом API.

Дополнительные сведения см. в списке API YouTube, на которые распространяется Политика устаревания .

Просмотр показателей

views (core metric)
Количество просмотров видео. В отчете по плейлисту метрика показывает, сколько раз видео было просмотрено в контексте плейлиста. Справочный центр YouTube предоставляет дополнительную информацию о том, как регистрируются просмотры. This is a core metric and is subject to the Deprecation Policy .
red_views
Количество просмотров видео участниками YouTube Premium (ранее YouTube Red).
views_percentage (core metric)
Процент зрителей, которые вошли в систему при просмотре видео или плейлиста. This is a core metric and is subject to the Deprecation Policy .

Показатели времени просмотра

watch_time_minutes (core metric)
Количество минут, в течение которых пользователи смотрели видео для указанного канала, владельца контента, видео или плейлиста. This is a core metric and is subject to the Deprecation Policy .
red_watch_time_minutes
Количество минут, в течение которых участники YouTube Premium (ранее YouTube Red) смотрели видео.
average_view_duration_seconds (core metric)
Средняя продолжительность воспроизведения видео в секундах. По состоянию на 13 декабря 2021 года этот показатель не включает циклический трафик клипов . В отчете по плейлисту метрика указывает среднюю продолжительность воспроизведения видео в секундах в контексте плейлиста. This is a core metric and is subject to the Deprecation Policy .
average_view_duration_percentage
Средний процент видео, просмотренного во время воспроизведения видео. По состоянию на 13 декабря 2021 года этот показатель не включает циклический трафик клипов .

Показатели вовлеченности

comments (core metric)
Количество комментариев пользователей к видео. Дополнительную информацию см. в Справочном центре YouTube . This is a core metric and is subject to the Deprecation Policy .
likes (core metric)
Сколько раз пользователи указали, что им понравилось видео, поставив ему положительную оценку. This is a core metric and is subject to the Deprecation Policy .
dislikes (core metric)
Количество раз, когда пользователи указывали, что им не нравится видео, ставя ему отрицательную оценку. This is a core metric and is subject to the Deprecation Policy .
shares (core metric)
Количество раз, когда пользователи поделились видео с помощью кнопки Share . Дополнительную информацию см. в Справочном центре YouTube . This is a core metric and is subject to the Deprecation Policy .
subscribers_gained (core metric)
Количество раз, когда пользователи подписывались на канал. This is a core metric and is subject to the Deprecation Policy .

Каналы могут получать или терять подписчиков в нескольких местах, включая страницу просмотра видео, страницу канала и руководство, которое появляется на главной странице YouTube. Чтобы определить количество новых подписчиков канала, которые не подписались через страницу просмотра видео, в базовом отчете о действиях пользователей содержится строка, в которой не указано значение параметра video_id . В этой строке также указано значение метрики subscribersLost , но не указаны значения для других метрик.
subscribers_lost (core metric)
Количество раз, когда пользователи отписывались от канала. This is a core metric and is subject to the Deprecation Policy .

Данные для этой метрики сообщаются аналогично метрике subscribers_gained . Чтобы определить количество пользователей, которые отписались, но не отказались от подписки на странице просмотра видео, в базовом отчете о действиях пользователей содержится строка, в которой не указано значение параметра video_id . В этой строке также указано значение для метрики subscribers_gained , но не указаны значения для других метрик.
videos_added_to_playlists
Сколько раз видео добавлялись в любые плейлисты YouTube. Видео могли быть добавлены в плейлист владельца видео или в плейлисты других каналов.

Значение метрики включает в себя количество раз, когда видео добавлялись в плейлисты по умолчанию, такие как плейлист «Посмотреть позже». Однако он не учитывает плейлисты, в которые автоматически добавляется видео, например плейлист загрузки канала или историю просмотров пользователя.

Эта метрика возвращает абсолютное число. Это означает, что если пользователь добавляет видео в плейлист, удаляет его, а затем снова добавляет, значение метрики отражает добавление видео в плейлист дважды. Данные по этому показателю недоступны для дат до 1 октября 2014 года.
videos_removed_from_playlists
Количество раз, когда видео удалялись из любых плейлистов YouTube. Видео могли быть удалены из плейлиста владельца видео или из плейлистов других каналов.

Значение метрики включает в себя количество раз, когда видео удалялись из плейлистов по умолчанию, таких как плейлист «Посмотреть позже».

Эта метрика возвращает абсолютное число, а это означает, что если пользователь добавляет видео в плейлист, удаляет его, снова добавляет, а затем снова удаляет, значение метрики отражает, что видео дважды удаляется из плейлиста. Данные по этому показателю недоступны для дат до 1 октября 2014 года.

Показатели плейлиста

playlist_starts
Сколько раз зрители инициировали воспроизведение плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, которые произошли в Интернете.
playlist_saves_added (only supported in YouTube Reporting API)
Сколько раз пользователи сохраняли плейлист. Дополнительную информацию о сохраненных плейлистах см. в Справочном центре YouTube . Эта метрика возвращает абсолютное число, означающее, что если пользователь сохраняет список воспроизведения, удаляет его из списка сохраненных списков воспроизведения и сохраняет его снова, значение метрики отражает добавление двух сохраненных списков воспроизведения.
playlist_saves_removed (only supported in YouTube Reporting API)
Сколько раз пользователи удаляли плейлист из своих списков сохраненных плейлистов. Эта метрика возвращает абсолютное число, означающее, что если пользователь сохраняет плейлист, удаляет его из списка сохраненных плейлистов, снова сохраняет и снова удаляет, значение метрики отражает два удаленных плейлиста.

Показатели аннотаций

annotation_impressions
Общее количество показов аннотаций.
annotation_clickable_impressions
Количество аннотаций, которые появились и на которые можно было нажать.
annotation_clicks
Количество нажатых аннотаций.
annotation_click_through_rate (core metric)
Отношение аннотаций, на которые нажали зрители, к общему количеству показов интерактивных аннотаций. This is a core metric and is subject to the Deprecation Policy . В Справочном центре YouTube есть дополнительная информация о создании аннотаций и использовании аннотаций ссылок .
annotation_closable_impressions
Количество появившихся аннотаций, которые можно было закрыть.
annotation_closes
Количество закрытых аннотаций.
annotation_close_rate (core metric)
Отношение аннотаций, закрытых зрителями, к общему количеству показов аннотаций. This is a core metric and is subject to the Deprecation Policy .

Метрики карты

Справочный центр YouTube содержит более подробные инструкции по добавлению карточек в видео и отчет о карточках YouTube Analytics .

card_impressions
Количество показов карточек. Когда панель карты открыта, для каждой карты видео регистрируется показ карты.
card_clicks
Количество кликов по картам.
card_click_rate
Рейтинг кликов для карточек, который рассчитывается как отношение кликов карточек к показам карточек.
card_teaser_impressions
Количество показов тизеров карточек. Просмотр видео может генерировать несколько показов тизера.
card_teaser_clicks
Количество кликов по тизерам карточек. Клики по значку карточки относятся к последнему тизеру, показанному пользователю.
card_teaser_click_rate
Рейтинг кликов для тизеров карточек, который рассчитывается как отношение кликов по тизерам карточек к общему количеству показов тизеров карточек.

Показатели конечной заставки

Конечные заставки — это элементы, которые отображаются в течение последних 5–20 секунд видео для продвижения вашего контента, канала и веб-сайтов. Справочный центр YouTube содержит более подробные инструкции по добавлению конечных заставок в ваши видео и отчет о конечных заставках YouTube Analytics .

Примечание. Данные по показателям конечной заставки доступны по состоянию на 1 мая 2016 года.

end_screen_element_impressions
Количество отображаемых элементов конечной заставки. Для каждого отображаемого элемента конечной заставки регистрируется один показ.
end_screen_element_clicks
Количество кликов по элементам конечной заставки.
end_screen_element_click_rate
Рейтинг кликов для элементов конечной заставки, который рассчитывается как отношение количества кликов по элементам конечной заставки к количеству показов элементов конечной заставки.

Показатели удержания аудитории

audience_retention_percentage
Абсолютное соотношение зрителей, смотрящих видео в данный момент видео. Отношение рассчитывается путем сравнения количества просмотров части видео с общим количеством просмотров видео. Параметр elapsed_video_time_percentage определяет часть видео, которой соответствует метрика.

Обратите внимание, что часть видео может быть просмотрена более одного раза (или не просмотрена вообще) в данном просмотре видео. Например, если пользователи перематывают и смотрят одну и ту же часть видео несколько раз, абсолютное соотношение для этой части видео может быть больше 1 .

В следующих примерах показано, как вычисляется значение:
  • Одноминутное видео смотрят 100 раз. Половина зрителей прекращают просмотр через 15 секунд, а остальные смотрят видео целиком. Ни один из зрителей не просматривает какие-либо части видео более одного раза. В этом случае значение этого показателя будет равно 1 для сегментов времени в первой четверти видео, а его значение будет равно 0.50 для остальной части видео.
  • Одноминутное видео смотрят 100 раз. Все зрители смотрят видео целиком, но 20 зрителей смотрят видео до 45-секундной отметки, затем возвращаются к 30-секундной отметке, а затем досматривают оставшуюся часть видео. В этом случае значение метрики будет равно 1 для сегментов времени либо в первой половине, либо в последней четверти видео. Однако значение будет равно 1.2 для сегментов времени в третьей четверти видео, поскольку 100 % зрителей просмотрели этот сегмент видео, но 20 % этих зрителей просмотрели этот сегмент дважды.

Расчетные показатели дохода

Примечание. Ориентировочные показатели дохода подлежат корректировке в конце месяца и не включают рекламу, проданную и обслуживаемую партнерами. Пожалуйста, посетите Справочный центр YouTube для получения дополнительной информации и примечаний о приблизительных цифрах дохода.

API отчетов YouTube сообщает обо всех предполагаемых доходах и доходах в долларах США.
estimated_partner_revenue (core metric)
Общий предполагаемый чистый доход от всех рекламных источников, проданных Google, а также от нерекламных источников за выбранный диапазон дат и регион.
estimated_partner_ad_revenue
Общий предполагаемый чистый доход от всех рекламных источников, проданных Google, за выбранный диапазон дат и регион.

Расчетные показатели дохода подлежат корректировке в конце месяца и не включают рекламу, проданную и обслуживаемую партнерами.
estimated_partner_ad_auction_revenue (only supported in YouTube Reporting API)
Общий расчетный доход (чистый доход) от рекламы, проданной на аукционе через AdSense, за выбранный диапазон дат и регион. Этот показатель ранее назывался estimated_partner_ad_sense_revenue .
estimated_partner_ad_sense_revenue (only supported in YouTube Reporting API)
Общий расчетный доход (чистый доход) от рекламы AdSense, проданной на аукционе, за выбранный диапазон дат и регион.
estimated_partner_ad_reserved_revenue (only supported in YouTube Reporting API)
Общий расчетный доход (чистый доход) от зарезервированной рекламы, проданной через DoubleClick (DCLK) и другие источники, проданные на YouTube. Эта метрика ранее называлась estimated_partner_double_click_revenue .
estimated_partner_double_click_revenue (only supported in YouTube Reporting API)
Общий расчетный доход (чистый доход) от зарезервированной рекламы, проданной через DoubleClick (DCLK) и другие источники, проданные на YouTube.
estimated_partner_red_revenue (only supported in YouTube Reporting API)
Общий расчетный доход (чистый доход) от подписки YouTube Premium (ранее известной как YouTube Red).
estimated_partner_transaction_revenue (only supported in YouTube Reporting API)
Общий расчетный доход от транзакций, таких как платный контент и пожертвования фанатов, за вычетом возмещений, взимаемых партнерами.

Показатели эффективности рекламы

estimated_youtube_ad_revenue
Расчетный валовой доход в долларах США от всей рекламы, проданной Google или партнером DoubleClick, за выбранный диапазон дат и регион. Валовой доход подлежит корректировке в конце месяца и не включает рекламу партнеров. Валовой доход не следует путать с предполагаемым доходом или чистым доходом, который зависит от вашей доли владения и соглашений о разделе доходов.
estimated_cpm
Предполагаемый валовой доход на тысячу показов рекламы.
ad_impressions
Количество подтвержденных показов объявлений.
estimated_monetized_playbacks
Количество случаев, когда зритель воспроизвел ваше видео и ему был показан хотя бы один показ рекламы. Монетизированное воспроизведение засчитывается, если зрителю показывают рекламу в начале ролика, но он прекращает просмотр рекламы до того, как начнется ваше видео. Ожидаемая оценочная ошибка для этой цифры составляет ± 2,0%.
estimated_playback_based_cpm
Предполагаемый валовой доход на тысячу воспроизведений.