Metrics

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

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

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

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

В списке ниже указаны основные показатели API.

Примечание. Следующие основные метрики полностью устарели:
  • Основной показатель earnings был объявлен устаревшим 4 августа 2016 года и переименован в estimatedRevenue . В соответствии с Политикой прекращения поддержки, определенной в Условиях использования , метрики earnings и estimatedRevenue поддерживались одновременно до 10 августа 2017 года.
  • Основные показатели favoritesAdded и favoritesRemoved устарели 31 марта 2015 года. Эти показатели можно было получить только через API YouTube Analytics.

Дополнительную информацию см. в списке API YouTube, на которые распространяется Политика прекращения поддержки .

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

views (core metric)
Эта метрика представляет разные цифры в разных типах отчетов:
  • В отчетах о видео этот показатель указывает количество просмотров видео.
  • В отчетах о плейлистах, в которых не используется параметр isCurated , эта метрика указывает общее количество просмотров видео в плейлисте, независимо от того, произошли ли эти просмотры в контексте плейлиста. Обратите внимание, что значение метрики включает только просмотры видео владельца канала.

    В этих отчетах метрика playlistViews указывает, сколько раз видео плейлиста были просмотрены в контексте определенного плейлиста.
  • В отчетах по плейлистам, в которых используется параметр isCurated , этот показатель указывает, сколько раз видео просматривалось в контексте определенного плейлиста. Обратите внимание, что метрика playlistViews не поддерживается для этих отчетов.
This is a core metric and is subject to the Deprecation Policy .
playlistViews
Эта метрика определяется в разделе показателей плейлиста .
redViews
Сколько раз видео было просмотрено участниками YouTube Premium (ранее известного как YouTube Red).
uniques ( deprecated September 27, 2016)
Количество уникальных зрителей, посмотревших видео. Этот расчет основан на количестве уникальных файлов cookie и, следовательно, будет учитывать больше пользователей, использующих несколько устройств или браузеров.
Метрика uniques устарела 27 сентября 2016 года. Она не является основной метрикой и будет поддерживаться до 31 октября 2016 года.
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 г.

Устаревшие показатели вовлеченности

Следующие метрики являются основными метриками , которые устарели 31 марта 2015 года.

favoritesAdded (core metric) ( deprecated March 31, 2015)
Сколько раз пользователи отмечали видео как избранное. Дополнительную информацию можно найти в Справочном центре YouTube . This is a core metric and is subject to the Deprecation Policy .
favoritesRemoved (core metric) ( deprecated March 31, 2015)
Сколько раз пользователи удаляли видео из списков избранных видео. Дополнительную информацию можно найти в Справочном центре YouTube . This is a core metric and is subject to the Deprecation Policy .

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

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

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

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

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

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

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

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 , поскольку в этот момент видео работает лучше, чем другие видео аналогичной длины.

Предполагаемые показатели дохода

Примечание. Ориентировочные показатели дохода могут корректироваться в конце месяца и не включают рекламу, продаваемую и обслуживаемую партнерами. Дополнительную информацию и примечания о предполагаемых доходах можно найти в Справочном центре 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
Ориентировочный валовой доход за тысячу воспроизведений.