Metrics

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

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

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

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

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

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

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

engaged_views (core metric)
Количество просмотров видеороликов канала после первых секунд.
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
Коэффициент кликов для элементов конечной заставки, который рассчитывается как отношение кликов по элементам конечной заставки к показам этих элементов.

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

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