Metrics

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

Показатели – это отдельные измерения действий пользователей, эффективности объявлений или расчетного дохода. К показателям активности пользователей относятся, например, количество просмотров видео и оценки ("Нравится" и "Не нравится").

Ключевые показатели

На YouTube Analytics API распространяются правила прекращения поддержки, описанные в Условиях использования. Однако эти правила не действуют в отношении неосновных показателей и параметров. В определениях на этой странице все основные показатели явно обозначены как таковые.

Ниже перечислены основные показатели API.

Подробнее о правилах прекращения поддержки YouTube API…

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

engagedViews (основной показатель)
Количество просмотров видео на канале, когда пользователь посмотрел больше одного кадра или нажал на видео, чтобы запустить его.
Просмотры (основной показатель)
В разных типах отчетов этот показатель означает разные вещи. Этот показатель включает совместные просмотры, когда несколько человек смотрят видео на одном телевизоре. This is a core metric and is subject to the Deprecation Policy.
playlistViews
Определение этого показателя приведено в разделе Показатели плейлистов.
redViews
Количество просмотров видео пользователями с подпиской YouTube Premium (ранее – YouTube Red).
viewerPercentage (основной показатель)
Процент зрителей, которые вошли в аккаунт при просмотре видео или плейлиста. This is a core metric and is subject to the Deprecation Policy.

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

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

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

Комментарии (основной показатель)
Количество комментариев к видео. Подробную информацию вы найдете в Справочном центре YouTube. This is a core metric and is subject to the Deprecation Policy.
Отметки "Нравится" (основной показатель)
Количество раз, когда пользователи показали, что им понравилось видео, поставив ему положительную оценку. This is a core metric and is subject to the Deprecation Policy.
dislikes (основной показатель)
Количество раз, когда пользователи показали, что им не понравилось видео, поставив ему отрицательную оценку. 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.
subscribersGained (основной показатель)
Количество подписок на канал. This is a core metric and is subject to the Deprecation Policy.

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

Данные для этого показателя регистрируются так же, как и для показателя subscribersGained. В отчетах по каналу этот показатель включает подписчиков, потерянных в результате любых действий, которые могут привести к отмене подписки на канал. Однако в отчетах, в которых используется параметр video или filter для ограничения ответа, чтобы включить только данные для определенного видео, этот показатель включает только пользователей, которые отменили подписку на странице просмотра указанного видео.
videosAddedToPlaylists
Сколько раз видео было добавлено в плейлисты на YouTube. Учитываются как плейлисты автора видео, так и плейлисты других пользователей.

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

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

Значение показателя включает количество удалений видео из плейлистов по умолчанию, например из плейлиста "Смотреть позже".

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

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

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

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

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

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

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

averageTimeInPlaylist
Расчетное среднее время просмотра видео в плейлисте после его запуска (в минутах). Обратите внимание, что этот показатель включает только просмотры плейлистов на сайте.
playlistAverageViewDuration
Расчетная средняя продолжительность просмотра плейлиста в секундах. Обратите внимание, что этот показатель отражает среднюю продолжительность просмотра отдельных видео в плейлисте, а показатель averageTimeInPlaylist – среднее время, которое зрители тратят на просмотр плейлиста в целом. В этом показателе учитываются данные по видео из плейлиста, которые принадлежат другим каналам.
playlistEstimatedMinutesWatched
Количество минут, в течение которых пользователи смотрели контент из плейлиста в составе плейлиста. Время просмотра, набранное в других контекстах, например когда зрители смотрели то же видео в составе других плейлистов, не учитывается. В этом показателе учитываются данные по видео из плейлиста, которые принадлежат другим каналам.
playlistSaves
Число сохранений плейлиста пользователями. Подробнее о сохраненных плейлистах… Этот показатель отражает чистое изменение. Это значит, что если пользователь сохранит плейлист, удалит его из списка сохраненных плейлистов и сохранит снова, значение показателя увеличится на единицу.
playlistStarts
Количество запусков плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов на сайте.
playlistViews
Количество просмотров видео в плейлисте. В этом показателе учитываются данные по видео из плейлиста, которые принадлежат другим каналам.
viewsPerPlaylistStart
Среднее количество просмотров видео после запуска плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов на сайте.

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

Примечание. В отчетах YouTube Analytics API данные по показателям annotationClickThroughRate и annotationCloseRate доступны только с 10 июня 2012 года. Кроме того, в отчетах YouTube Analytics API за период после 16 июля 2013 года содержатся данные только по оставшимся показателям аннотаций.

annotationImpressions
Общее количество показов аннотаций.
annotationClickableImpressions
Количество аннотаций, которые появились на экране и на которые можно было нажать.
annotationClicks
Количество аннотаций, на которые нажимали зрители.
annotationClickThroughRate (основной показатель)
Отношение числа аннотаций, на которые нажимали зрители, к общему количеству показов интерактивных аннотаций. This is a core metric and is subject to the Deprecation Policy. Подробнее о том, как создавать аннотации и добавлять в них ссылки, написано в Справочном центре YouTube.
annotationClosableImpressions
Количество аннотаций, которые были показаны и могли быть закрыты.
annotationCloses
Количество закрытых аннотаций.
annotationCloseRate (основной показатель)
Отношение количества аннотаций, закрытых зрителями, к общему числу показов аннотаций. This is a core metric and is subject to the Deprecation Policy.

Показатели карточек

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

cardImpressions
Сколько раз зрители видели подсказки. Когда зритель открывает панель с подсказками, регистрируется показ каждой из них.
cardClicks
Сколько раз пользователи нажимали на подсказки.
cardClickRate
Показатель CTR для карточек, который рассчитывается как отношение количества кликов по карточкам к числу их показов.
cardTeaserImpressions
Сколько раз были показаны тизеры подсказок. За один просмотр видео может быть зарегистрировано несколько показов тизера.
cardTeaserClicks
Количество кликов по тизерам подсказок. Клики по значку подсказки относятся к последнему тизеру, показанному пользователю.
cardTeaserClickRate
Показатель CTR для тизеров подсказок. Рассчитывается как отношение количества кликов по тизерам к общему числу их показов.

Показатели трансляций (одновременные просмотры)

averageConcurrentViewers
Среднее количество одновременных просмотров определенного видео. Этот показатель включает участников совместного просмотра, когда несколько человек смотрят телевизор вместе. Если в отчете указан параметр livestreamPosition, то значение averageConcurrentViewers определяет среднее количество одновременных просмотров в течение определенного сегмента.
peakConcurrentViewers
Максимальное количество одновременных просмотров определенного видео. Этот показатель включает участников совместного просмотра, когда несколько человек смотрят телевизор вместе. Если в отчете указан параметр livestreamPosition, то значение peakConcurrentViewers определяет максимальное количество одновременных просмотров в определенном сегменте видео.

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

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

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

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

Значение 0 указывает, что видео удерживает зрителей хуже, чем любое другое видео аналогичной длины, а значение 1 – что видео удерживает зрителей лучше, чем любое другое видео аналогичной длины. Медианное значение 0.5 означает, что половина видео схожей продолжительности удерживает зрителей лучше, а половина – хуже.

Ниже приведен гипотетический пример того, как эти значения могут выглядеть в отчете. В среднем 90 % зрителей, которые смотрят видео продолжительностью 10 минут, продолжают просмотр после трех минут, а 70 % – после восьми минут. Однако в случае с определенным 10-минутным видео только 80 % зрителей продолжают смотреть его после трех минут, но все эти зрители продолжают смотреть его после восьми минут.
  • В точке elapsedVideoTimeRatio, соответствующей третьей минуте видео, значение показателя relativeRetentionPerformance будет ниже 0.5, поскольку в этот момент видео удерживает внимание зрителей хуже, чем в среднем.
  • В точке elapsedVideoTimeRatio, соответствующей восьмой минуте видео, значение показателя relativeRetentionPerformance будет выше, чем у показателя 0.5, поскольку в этот момент видео более популярно, чем другие ролики похожей продолжительности.
startedWatching
Количество раз, когда определенный сегмент видео был первым сегментом, просмотренным во время воспроизведения видео.

Например, видео X длится 5 минут. Для целей этого отчета YouTube делит видео на 100 трехсекундных сегментов, которые идентифицируются с помощью параметра elapsedVideoTimeRatio. Пользователь заходит на YouTube и смотрит первую минуту и десять секунд видео, которые включают в себя все или часть первых 24 сегментов видео. При следующем посещении YouTube пользователь досматривает видео, начиная с 24-го сегмента и до конца.

В этом примере будут получены следующие значения показателей просмотра:
  • Значение показателя startedWatching будет равно 1 для сегментов 1 и 24 и 0 для всех остальных сегментов.
  • Значение показателя stoppedWatching будет равно 1 для сегментов 24 и 100 и 0 для всех остальных сегментов.
  • Значение показателя totalSegmentImpressions будет равно 2 для сегмента 24 и 1 для всех остальных сегментов.
stoppedWatching
Количество раз, когда определенный сегмент видео был последним сегментом, просмотренным во время воспроизведения видео. Пример расчета этого показателя приведен в определении показателя startedWatching.
totalSegmentImpressions
Сколько раз был просмотрен определенный фрагмент видео. Пример расчета значения этого показателя приведен в определении показателя startedWatching. Обратите внимание, что зритель может посмотреть один и тот же фрагмент видео несколько раз за один сеанс воспроизведения.

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

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

Показатели расчетного дохода

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

По умолчанию все данные о расчетном доходе приводятся в долларах США. Однако YouTube Analytics API поддерживает параметр currency для некоторых показателей расчетного дохода и эффективности рекламы, что позволяет получать данные о расчетном доходе в других валютах.
estimatedRevenue (основной показатель) (ранее – earnings)
Общий расчетный чистый доход от всех источников рекламы, проданной Google, а также от источников, не связанных с рекламой, за выбранный диапазон дат и регион. This is a core metric and is subject to the Deprecation Policy.

Расчетный доход корректируется в конце месяца. При его расчете не учитывается реклама, проданная и показанная в партнерских сетях.
estimatedAdRevenue (ранее – adEarnings)
Общий расчетный чистый доход от всех источников рекламы, проданной Google, за выбранный диапазон дат и регион.

Показатели расчетного дохода корректируются в конце месяца и не включают рекламу, проданную и размещенную партнерами.
estimatedRedPartnerRevenue (ранее – redPartnerRevenue)
Общий расчетный доход от подписок YouTube Premium (ранее – YouTube Red) за выбранный период. Этот показатель отражает доход как от музыкального, так и от немузыкального контента и корректируется в конце месяца.

Показатели эффективности объявлений

grossRevenue
Ориентировочный валовой доход в долларах США от рекламы, проданной через Google или партнерскую сеть DoubleClick, за выбранный период в указанном регионе. Валовой доход корректируется в конце месяца и не включает доход от рекламы, показанной партнерами. Валовой доход не следует путать с расчетным или чистым доходом, который рассчитывается с учетом вашей доли владения и соглашений о распределении дохода.
cpm (ранее – impressionBasedCpm)
Расчетный валовой доход за тысячу показов объявлений.
adImpressions (ранее – impressions)
Количество подтвержденных показов объявлений.
monetizedPlaybacks
Количество просмотров видео, в ходе которых происходит хотя бы один показ объявления. Коммерческое воспроизведение засчитывается, если пользователю показывается реклама в начале ролика, даже если он уходит, не досмотрев ее. Ожидаемая погрешность для этого показателя составляет ±2,0 %.
playbackBasedCpm
Расчетный валовой доход за тысячу воспроизведений.