Metrics

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

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

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

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

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

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

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

engagedViews (core metric)
Количество просмотров видео продолжительностью не менее 4 секунд.
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 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
Предполагаемый валовой доход за тысячу воспроизведений.