В этом документе определяются показатели, которые можно получить с помощью API YouTube Analytics. Этот API поддерживает запросы в реальном времени для создания настраиваемых отчетов YouTube Analytics.
Метрики – это отдельные измерения активности пользователей, эффективности рекламы или расчетного дохода. Показатели активности пользователей включают в себя такие вещи, как количество просмотров видео и рейтинги (нравится и не нравится).
Основные показатели
В то время как API YouTube Analytics подпадает под действие Политики прекращения поддержки, определенной в Условиях использования , на неосновные показатели (и неосновные параметры) эта политика не распространяется. В определениях на этой странице любая метрика, которая является основной метрикой, явно обозначена как таковая.
В приведенном ниже списке указаны основные показатели API.
-
annotationClickThroughRate
-
annotationCloseRate
-
averageViewDuration
-
comments
-
dislikes
-
estimatedMinutesWatched
-
estimatedRevenue
-
likes
-
shares
-
subscribersGained
-
subscribersLost
-
viewerPercentage
-
views
- Основная метрика
earnings
устарела 4 августа 2016 г. и переименована вestimatedRevenue
. В соответствии с политикой устаревания, определенной в Условиях использования , показателиearnings
иestimatedRevenue
поддерживались одновременно до 10 августа 2017 года. - 31 марта 2015 года поддержка основных показателей
favoritesAdded
иfavoritesRemoved
была прекращена. Эти показатели можно было получить только через API YouTube Analytics.
Дополнительные сведения см. в списке API YouTube, на которые распространяется Политика устаревания .
Просмотр показателей
- views (core metric)
- Количество просмотров видео. В отчете по плейлисту метрика показывает, сколько раз видео было просмотрено в контексте плейлиста. Справочный центр YouTube предоставляет дополнительную информацию о том, как регистрируются просмотры. This is a core metric and is subject to the Deprecation Policy .
- 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 .
- Количество раз, когда пользователи поделились видео с помощью кнопки
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 .
Показатели плейлиста
- playlistStarts
- Сколько раз зрители инициировали воспроизведение плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, которые произошли в Интернете.
- viewsPerPlaylistStart
- Среднее количество просмотров видео при каждом запуске плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, которые произошли в Интернете.
- averageTimeInPlaylist
- Расчетное среднее количество времени в минутах, в течение которого зритель просматривал видео в плейлисте после запуска плейлиста. Обратите внимание, что этот показатель включает только просмотры плейлистов, которые произошли в Интернете.
Показатели аннотаций
Примечание. Отчеты 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
- Рейтинг кликов для карточек, который рассчитывается как отношение кликов карточек к показам карточек.
- Количество показов тизеров карточек. Просмотр видео может генерировать несколько показов тизера.
- Количество кликов по тизерам карточек. Клики по значку карточки относятся к последнему тизеру, показанному пользователю.
- Рейтинг кликов для тизеров карточек, который рассчитывается как отношение кликов по тизерам карточек к общему количеству показов тизеров карточек.
Показатели удержания аудитории
- audienceWatchRatio
- Абсолютное соотношение зрителей, смотрящих видео в данный момент видео. Отношение рассчитывается путем сравнения количества просмотров части видео с общим количеством просмотров видео. Измерение
elapsedVideoTimeRatio
определяет часть видео, которой соответствует метрика.
Обратите внимание, что часть видео может быть просмотрена более одного раза (или не просмотрена вообще) в данном просмотре видео. Например, если пользователи перематывают и смотрят одну и ту же часть видео несколько раз, абсолютное соотношение для этой части видео может быть больше1
.
В следующих примерах показано, как вычисляется значение:- Одноминутное видео смотрят 100 раз. Половина зрителей прекращают просмотр через 15 секунд, а остальные смотрят видео целиком. Ни один из зрителей не просматривает какие-либо части видео более одного раза. В этом случае значение этого показателя будет равно
1
для сегментов времени в первой четверти видео, а его значение будет равно0.50
для остальной части видео. - Одноминутное видео смотрят 100 раз. Все зрители смотрят видео целиком, но 20 зрителей смотрят видео до 45-секундной отметки, затем возвращаются к 30-секундной отметке, а затем досматривают оставшуюся часть видео. В этом случае значение метрики будет равно
1
для сегментов времени либо в первой половине, либо в последней четверти видео. Однако значение будет равно1.2
для сегментов времени в третьей четверти видео, поскольку 100 % зрителей просмотрели этот сегмент видео, но 20 % этих зрителей просмотрели этот сегмент дважды.
- Одноминутное видео смотрят 100 раз. Половина зрителей прекращают просмотр через 15 секунд, а остальные смотрят видео целиком. Ни один из зрителей не просматривает какие-либо части видео более одного раза. В этом случае значение этого показателя будет равно
- relativeRetentionPerformance
- Измерение, показывающее, насколько хорошо видео удерживает зрителей во время воспроизведения по сравнению со всеми видео на YouTube аналогичной продолжительности. Метрика имеет значение от
0
до1
, которое определяет относительную эффективность удержания видео в заданной точке видео. Точка в видео определяется измерениемelapsedVideoTimeRatio
.
Значение0
указывает, что видео удерживает зрителей хуже, чем любое другое видео аналогичной длины, а значение1
указывает, что видео удерживает зрителей лучше, чем любое другое видео аналогичной длины. Среднее значение0.5
указывает на то, что половина видео одинаковой продолжительности удерживает зрителей лучше, а половина – хуже.
Следующий гипотетический пример иллюстрирует, как значения могут отображаться в отчете. В среднем 90 процентов зрителей, которые смотрят видео продолжительностью 10 минут, продолжают смотреть через три минуты, а 70 процентов продолжают смотреть через восемь минут. Однако для определенного 10-минутного видео только 80 процентов зрителей все еще смотрят через три минуты, но все эти зрители продолжают смотреть через восемь минут.- При значении
elapsedVideoTimeRatio
, которое соответствует моменту, когда видео начинается через три минуты, метрикаrelativeRetentionPerformance
будет иметь значение ниже0.5
, поскольку в это время видео работает хуже, чем среднее видео. - При значении
elapsedVideoTimeRatio
, соответствующем восьмиминутной отметке видео, метрикаrelativeRetentionPerformance
будет иметь значение выше0.5
, поскольку в это время видео работает лучше, чем другие видео аналогичной продолжительности.
- При значении
Расчетные показатели дохода
Примечание. Ориентировочные показатели дохода подлежат корректировке в конце месяца и не включают рекламу, проданную и обслуживаемую партнерами. Пожалуйста, посетите Справочный центр YouTube для получения дополнительной информации и примечаний о приблизительных цифрах дохода.
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
- Предполагаемый валовой доход на тысячу воспроизведений.