Metrics

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

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

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

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

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

Для получения более подробной информации см. список API YouTube, на которые распространяется политика устаревания .

Просмотреть метрики

engaged_views (core metric)
Количество просмотров видеороликов канала после первых секунд.
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 .

Показатели охвата

video_thumbnail_impressions
Количество показов миниатюр видео зрителям. Показы засчитываются, если миниатюра отображается более 1 секунды и на экране видно не менее 50% её размера. Дополнительную информацию см. в Справочном центре YouTube .
video_thumbnail_impressions_ctr
Процент показов, которые привели к переходу на просмотр видео. Он рассчитывается как количество кликов, деленное на количество показов.

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

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 года.

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

Отчеты по плейлистам содержат два типа метрик, которые объясняют, как зрители взаимодействуют с видео в плейлисте:

  • Агрегированные видеометрики предоставляют показатели активности пользователей и показов, которые суммируются для всех видео в плейлисте, принадлежащих также каналу, которому принадлежит этот плейлист. Метрики для видео, принадлежащих другим каналам, в агрегированном виде не учитываются. В результате, если канал создает плейлист, содержащий только видео, принадлежащие другим каналам, отчеты по этим плейлистам не будут содержать значений для этих метрик.

    Определения поддерживаемых агрегированных видеометрик см. в разделах «Метрики просмотра» и «Метрики времени просмотра» данного документа.

  • Показатели внутри плейлиста отражают активность и вовлеченность пользователей в контексте страницы плейлиста. Эти показатели включают просмотры всех видео в плейлисте, независимо от того, какому каналу они принадлежат, но учитывают только просмотры, произошедшие в контексте плейлиста.

Большинство из перечисленных ниже показателей относятся к показателям, отражающим взаимодействие пользователя с плейлистом; остальные показатели в списке, такие как показатель playlistSaves , касаются взаимодействия пользователя с самим плейлистом, а не с видео в нем. Таким образом, эти показатели не будут классифицироваться ни как агрегированные показатели видео, ни как показатели, отражающие взаимодействие пользователя с плейлистом.

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
Показатель кликабельности (CTR) для рекламных карточек рассчитывается как отношение количества кликов по рекламным карточкам к общему числу показов рекламных карточек.

Показатели конечного экрана

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

end_screen_element_impressions
Количество отображенных элементов конечного экрана. Для каждого отображенного элемента конечного экрана регистрируется один показ.
end_screen_element_clicks
Количество кликов по элементам конечного экрана.
end_screen_element_click_rate
Показатель кликабельности (CTR) для элементов конечного экрана рассчитывается как отношение количества кликов по элементам конечного экрана к количеству показов этих элементов.

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

membershipsCancellationSurveyResponses
Количество опросов, пройденных пользователями YouTube, которые отменили подписку на указанный канал в течение отчетного периода.

Предполагаемые показатели выручки

Примечание: Предполагаемые показатели выручки могут быть скорректированы на конец месяца и не включают рекламу, продаваемую и показываемую партнерами. Дополнительную информацию и примечания к предполагаемым показателям выручки см. в Справочном центре 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_reserved_revenue (only supported in YouTube Reporting API)
Общая предполагаемая прибыль (чистая выручка) от зарезервированной рекламы, продаваемой через DoubleClick (DCLK) и другие источники, принадлежащие YouTube. Ранее этот показатель назывался estimated_partner_double_click_revenue .
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
Предполагаемый валовой доход на тысячу воспроизведений.