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 Cards .

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

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

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