Metrics

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

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

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

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

В списке ниже указаны основные показатели 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 г.

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

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

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

    Определения поддерживаемых агрегированных показателей видео см. в разделах этого документа, посвященных показателям просмотра и времени просмотра .

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

Большинство показателей, перечисленных ниже, являются показателями плейлиста; Остальные метрики в списке, такие как метрика 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 Cards .

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
Ориентировочный валовой доход за тысячу воспроизведений.