Metrics

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

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

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

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

Ниже приведён список основных метрик API.

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

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

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

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

estimatedMinutesWatched (core metric)
Количество минут, в течение которых пользователи смотрели видео на указанном канале, у владельца контента, в видео или плейлисте. This is a core metric and is subject to the Deprecation Policy .
estimatedRedMinutesWatched
Количество минут, в течение которых подписчики YouTube Premium (ранее известные как YouTube Red) смотрели видео.
averageViewDuration (core metric)
Средняя продолжительность воспроизведения видео в секундах. По состоянию на 13 декабря 2021 года этот показатель не включает зацикленные фрагменты . В отчете по плейлистам этот показатель указывает среднюю продолжительность воспроизведения видео в секундах, произошедшего в контексте плейлиста. This is a core metric and is subject to the Deprecation Policy .
averageViewPercentage
Средний процент времени, проведённого за просмотром видео во время воспроизведения. По состоянию на 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 .
subscribersGained (core metric)
Количество раз, когда пользователи подписывались на канал. This is a core metric and is subject to the Deprecation Policy .

Каналы могут получать или терять подписчиков в нескольких местах, включая страницу просмотра видео, страницу канала и руководство, которое отображается на главной странице YouTube. В отчетах по каналам этот показатель включает подписчиков, полученных из любого из этих мест. Однако в отчетах, которые используют либо параметр video , либо параметр filter для ограничения ответа только данными для конкретного видео, показатель subscribersGained будет включать статистику только со страницы просмотра указанного видео.
subscribersLost (core metric)
Количество отписок пользователей от канала. 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
Общее количество сохранений плейлиста пользователями. Дополнительную информацию о сохраненных плейлистах см. в Справочном центре YouTube . Этот показатель возвращает число чистого изменения, то есть, если пользователь сохраняет плейлист, удаляет его из списка сохраненных плейлистов и сохраняет снова, значение показателя отражает добавление одного сохраненного плейлиста.
playlistStarts
Количество раз, когда зрители инициировали воспроизведение плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, произошедшие в веб-версии.
playlistViews
Количество просмотров видеороликов из плейлиста в контексте этого плейлиста. Этот показатель включает данные по видеороликам из плейлистов, принадлежащим другим каналам.
viewsPerPlaylistStart
Среднее количество просмотров видео, произошедших при каждом запуске плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, произошедшие в веб-версии.

Метрики аннотаций

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

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

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

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

cardImpressions
Количество показов карточек. При открытии панели с карточками регистрируется оттиск каждой карточки из видео.
cardClicks
Количество кликов по карточкам.
cardClickRate
Показатель кликабельности карточек рассчитывается как отношение количества кликов по карточкам к количеству показов карточек.
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 3-секундных сегментов, которые обозначаются параметром elapsedVideoTimeRatio . Зритель заходит на YouTube и смотрит первую минуту и ​​десять секунд видео, что включает в себя все или часть первых 24 сегментов видео. При последующем посещении YouTube зритель смотрит остальную часть видео, начиная воспроизведение с 24-го сегмента и продолжая до 100-го сегмента.

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

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

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

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

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

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

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

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

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

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