Metrics

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

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

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

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

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

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

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

engaged_views (core metric)
Количество просмотров видео продолжительностью не менее 4 секунд.
views (core metric)
Количество просмотров видео. В отчете по плейлисту метрика указывает количество просмотров видео в контексте плейлиста. Справочный центр YouTube предоставляет дополнительную информацию о том, как сообщается о просмотрах. This is a core metric and is subject to the Deprecation Policy .
red_views
Количество просмотров видео участниками YouTube Premium (ранее известного как YouTube Red).
views_percentage (core metric)
Процент зрителей, которые были авторизованы при просмотре видео или плейлиста. This is a core metric and is subject to the Deprecation Policy .

Метрики времени просмотра

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

Каналы могут получать или терять подписчиков в нескольких местах, включая страницу просмотра видео, страницу канала и руководство, которое отображается на домашней странице YouTube. Чтобы определить количество новых подписчиков канала, которые не подписались через страницу просмотра видео, базовый отчет о действиях пользователей содержит строку, в которой не указано значение параметра video_id . Эта строка также указывает значение для метрики subscribersLost , но не указывает значения для других метрик.
subscribers_lost (core metric)
Количество раз, когда пользователи отписывались от канала. This is a core metric and is subject to the Deprecation Policy .

Данные для этой метрики сообщаются аналогично метрике subscribers_gained . Чтобы определить количество пользователей, которые отписались, но не отписались на странице просмотра видео, базовый отчет об активности пользователей содержит строку, в которой не указано значение параметра video_id . Эта строка также указывает значение для метрики subscribers_gained , но не указывает значения для других метрик.
videos_added_to_playlists
Количество раз, когда видео были добавлены в какие-либо плейлисты YouTube. Видео могли быть добавлены в плейлист владельца видео или в плейлисты других каналов.

Значение метрики включает количество раз, когда видео были добавлены в плейлисты по умолчанию, такие как плейлист «Посмотреть позже». Однако оно не учитывает плейлисты, в которые видео добавляется автоматически, такие как плейлист загрузок канала или история просмотров пользователя.

Эта метрика возвращает абсолютное число, то есть если пользователь добавляет видео в плейлист, удаляет его, а затем добавляет снова, значение метрики отражает добавление видео в плейлист дважды. Данные по этой метрике недоступны для дат до 1 октября 2014 г.
videos_removed_from_playlists
Количество раз, когда видео были удалены из плейлистов YouTube. Видео могли быть удалены из плейлиста владельца видео или из плейлистов других каналов.

Значение метрики включает в себя количество раз, когда видео были удалены из плейлистов по умолчанию, таких как плейлист «Посмотреть позже».

Эта метрика возвращает абсолютное число, то есть если пользователь добавляет видео в плейлист, удаляет его, добавляет его снова и снова удаляет его, значение метрики отражает удаление видео из плейлиста дважды. Данные по этой метрике недоступны для дат до 1 октября 2014 года.

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

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

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

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

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

Большинство из следующих метрик являются метриками внутри плейлиста; остальные метрики в списке, такие как метрика playlistSaves , касаются взаимодействия пользователя с самим плейлистом, а не с видео в плейлисте. Таким образом, эти метрики не будут характеризоваться ни как агрегированные видеометрики, ни как метрики внутри плейлиста.

playlist_starts
Количество раз, когда зрители инициировали воспроизведение плейлиста. Обратите внимание, что эта метрика включает только просмотры плейлиста, которые произошли в Интернете.
playlist_saves_added (only supported in YouTube Reporting API)
Количество раз, когда пользователи сохраняли плейлист. Дополнительную информацию о сохраненных плейлистах см. в Справочном центре YouTube . Эта метрика возвращает абсолютное число, то есть если пользователь сохраняет плейлист, удаляет его из списка сохраненных плейлистов и сохраняет его снова, значение метрики отражает добавление двух сохранений плейлиста.
playlist_saves_removed (only supported in YouTube Reporting API)
Количество раз, когда пользователи удаляли плейлист из своих списков сохраненных плейлистов. Эта метрика возвращает абсолютное число, то есть если пользователь сохраняет плейлист, удаляет его из списка сохраненных плейлистов, сохраняет его снова и удаляет его снова, значение метрики отражает удаление двух сохранений плейлиста.

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

annotation_impressions
Общее количество показов аннотаций.
annotation_clickable_impressions
Количество появившихся аннотаций, на которые можно было нажать.
annotation_clicks
Количество нажатых аннотаций.
annotation_click_through_rate (core metric)
Соотношение аннотаций, на которые нажимали зрители, к общему количеству показов кликабельных аннотаций. This is a core metric and is subject to the Deprecation Policy . В Справочном центре YouTube есть дополнительная информация о создании аннотаций и использовании аннотаций-ссылок .
annotation_closable_impressions
Количество появившихся аннотаций, которые можно закрыть.
annotation_closes
Количество закрытых аннотаций.
annotation_close_rate (core metric)
Соотношение аннотаций, которые зрители закрыли, к общему числу показов аннотаций. This is a core metric and is subject to the Deprecation Policy .

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

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

card_impressions
Количество показов карточек. При открытии панели карточек для каждой карточки видео регистрируется показ карточки.
card_clicks
Количество кликов по карточкам.
card_click_rate
Показатель кликабельности карточек, который рассчитывается как отношение количества кликов по карточкам к количеству показов карточек.
card_teaser_impressions
Количество показов тизеров карт. Просмотр видео может сгенерировать несколько показов тизеров.
card_teaser_clicks
Количество кликов по тизерам карточек. Клики по иконкам карточек относятся к последнему тизеру, показанному пользователю.
card_teaser_click_rate
Показатель кликабельности для тизеров карт, который рассчитывается как отношение кликов по тизерам карт к общему количеству показов тизеров карт.

Показатели конечного экрана

Конечные экраны — это элементы, которые показываются в течение последних 5–20 секунд видео для продвижения вашего контента, канала и веб-сайтов. Справочный центр YouTube содержит более подробные инструкции по добавлению конечных экранов в ваши видео и отчет YouTube Analytics о конечных экранах .

end_screen_element_impressions
Количество отображаемых элементов конечного экрана. Для каждого отображаемого элемента конечного экрана регистрируется один показ.
end_screen_element_clicks
Количество нажатий на элементы конечного экрана.
end_screen_element_click_rate
Показатель кликабельности для элементов конечной заставки, который рассчитывается как отношение кликов по элементам конечной заставки к показам элементов конечной заставки.

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

audience_retention_percentage
Абсолютное соотношение зрителей, просматривающих видео в заданной точке видео. Соотношение рассчитывается путем сравнения количества просмотров части видео с общим количеством просмотров видео. Измерение elapsed_video_time_percentage определяет часть видео, которой соответствует метрика.

Обратите внимание, что часть видео может быть просмотрена более одного раза (или не просмотрена вообще) в данном видеопросмотре. Например, если пользователи перематывают и смотрят одну и ту же часть видео несколько раз, то абсолютное отношение для этой части видео может быть больше 1 .

Следующие примеры иллюстрируют, как рассчитывается значение:
  • Видео продолжительностью в одну минуту просматривается 100 раз. Половина зрителей прекращает просмотр через 15 секунд, а остальные смотрят все видео. Никто из зрителей не смотрит ни одну часть видео больше одного раза. В этом случае значение этой метрики будет равно 1 для временных интервалов в первой четверти видео, а ее значение будет равно 0.50 для оставшейся части видео.
  • Одноминутное видео просматривается 100 раз. Все зрители смотрят все видео, но 20 из них смотрят до 45-секундной отметки видео, затем возвращаются к 30-секундной отметке видео и смотрят оставшуюся часть видео. В этом случае значение метрики будет равно 1 для временных интервалов в первой половине или последней четверти видео. Однако значение будет равно 1.2 для временных интервалов в третьей четверти видео, поскольку 100 процентов зрителей посмотрели этот сегмент видео, но 20% из этих зрителей посмотрели этот сегмент дважды.

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

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

Оценочные показатели дохода

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

API отчетов YouTube сообщает все предполагаемые показатели доходов и прибыли в долларах США.
estimated_partner_revenue (core metric)
Общий расчетный чистый доход от всех источников рекламы, проданных Google, а также от нерекламных источников для выбранного диапазона дат и региона.
estimated_partner_ad_revenue
Общий расчетный чистый доход от всех источников рекламы, проданной Google, за выбранный диапазон дат и регион.

Оценочные показатели дохода подлежат корректировке в конце месяца и не включают рекламу, проданную и предоставленную партнерами.
estimated_partner_ad_auction_revenue (only supported in YouTube Reporting API)
Общая предполагаемая прибыль (чистый доход) от рекламы, проданной на аукционе через AdSense для выбранного диапазона дат и региона. Ранее эта метрика называлась estimated_partner_ad_sense_revenue .
estimated_partner_ad_reserved_revenue (only supported in YouTube Reporting API)
Общая предполагаемая прибыль (чистый доход) от зарезервированной рекламы через DoubleClick (DCLK) и другие источники, проданные через YouTube. Ранее эта метрика называлась estimated_partner_double_click_revenue .
estimated_partner_red_revenue (only supported in YouTube Reporting API)
Общая предполагаемая прибыль (чистый доход) от подписок YouTube Premium (ранее известная как YouTube Red).
estimated_partner_transaction_revenue (only supported in YouTube Reporting API)
Общий предполагаемый доход от транзакций, таких как платный контент и фан-финансирование, за вычетом любых возмещений, взимаемых партнерами.

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

estimated_youtube_ad_revenue
Расчетный валовой доход в долларах США от всей рекламы, проданной Google или DoubleClick-партнером, для выбранного диапазона дат и региона. Валовой доход подлежит корректировке в конце месяца и не включает рекламу, предоставленную партнером. Валовой доход не следует путать с расчетным доходом или чистым доходом, который учитывает вашу долю собственности и соглашения о распределении доходов.
estimated_cpm
Расчетный валовой доход за тысячу показов рекламы.
ad_impressions
Количество подтвержденных показов рекламы.
estimated_monetized_playbacks
Количество случаев, когда зритель воспроизводил ваше видео и ему был показан хотя бы один показ рекламы. Монетизированное воспроизведение засчитывается, если зрителю показывают рекламу в начале ролика, но он прекращает просмотр рекламы до начала вашего видео. Ожидаемая оценочная погрешность для этого показателя составляет ±2,0%.
estimated_playback_based_cpm
Предполагаемый валовой доход за тысячу воспроизведений.