В этом документе определяются показатели, которые получает API отчетов YouTube. Этот API извлекает отчеты с массовыми данными, которые содержат данные YouTube Analytics для канала или владельца контента.
Метрики – это отдельные измерения активности пользователей, эффективности рекламы или расчетного дохода. Показатели активности пользователей включают в себя такие вещи, как количество просмотров видео и рейтинги (нравится и не нравится).
Основные показатели
В то время как YouTube Reporting API подпадает под действие Политики прекращения поддержки, определенной в Условиях предоставления услуг , на неосновные показатели (и неосновные параметры) эта политика не распространяется. В определениях на этой странице любая метрика, которая является основной метрикой, явно обозначена как таковая.
В приведенном ниже списке указаны основные показатели API. Любые из этих показателей, которые также используются в API YouTube Analytics, также являются основными показателями в этом API.
-
annotation_click_through_rate
-
annotation_close_rate
-
average_view_duration_seconds
-
comments
-
dislikes
-
estimated_partner_revenue
-
likes
-
shares
-
subscribers_gained
-
subscribers_lost
-
views_percentage
-
views
-
watch_time_minutes
Дополнительные сведения см. в списке 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 .
- Количество раз, когда пользователи поделились видео с помощью кнопки
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
- Рейтинг кликов для карточек, который рассчитывается как отношение кликов карточек к показам карточек.
- Количество показов тизеров карточек. Просмотр видео может генерировать несколько показов тизера.
- Количество кликов по тизерам карточек. Клики по значку карточки относятся к последнему тизеру, показанному пользователю.
- Рейтинг кликов для тизеров карточек, который рассчитывается как отношение кликов по тизерам карточек к общему количеству показов тизеров карточек.
Показатели конечной заставки
Конечные заставки — это элементы, которые отображаются в течение последних 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 % этих зрителей просмотрели этот сегмент дважды.
- Одноминутное видео смотрят 100 раз. Половина зрителей прекращают просмотр через 15 секунд, а остальные смотрят видео целиком. Ни один из зрителей не просматривает какие-либо части видео более одного раза. В этом случае значение этого показателя будет равно
Расчетные показатели дохода
Примечание. Ориентировочные показатели дохода подлежат корректировке в конце месяца и не включают рекламу, проданную и обслуживаемую партнерами. Пожалуйста, посетите Справочный центр 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
- Предполагаемый валовой доход на тысячу воспроизведений.