В этом документе описаны показатели, которые можно получить с помощью YouTube Reporting API. С помощью этого API можно запрашивать из YouTube Аналитики большие объемы данных по каналу или владельцу контента.
Показатели – это отдельные измерения действий пользователей, эффективности объявлений или расчетного дохода. К показателям действий пользователя относятся, например, число просмотров видео и оценки (лайки и дизлайки).
Ключевые показатели
На YouTube Reporting API распространяются правила прекращения поддержки, описанные в Условиях использования. Однако эти правила не действуют в отношении дополнительных показателей и параметров. В определениях на этой странице все основные показатели явно обозначены как таковые.
Ниже перечислены основные показатели API. Показатели, которые также используются в YouTube Analytics API, являются основными и в этом API.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Подробнее о правилах прекращения поддержки YouTube API…
Посмотреть показатели
- engaged_views (основной показатель)
- Количество просмотров видео на канале, когда пользователь посмотрел больше одного кадра или нажал на видео, чтобы запустить его.
- Просмотры (основной показатель)
- Количество просмотров видео. В отчете о плейлистах этот показатель отражает количество просмотров видео в плейлисте. Этот показатель включает совместные просмотры, когда несколько человек смотрят видео на одном телевизоре.
Дополнительную информацию о том, как регистрируются просмотры, можно найти в Справочном центре YouTube.
This is a core metric and is subject to the Deprecation Policy.
- red_views
- Количество просмотров видео пользователями с подпиской YouTube Premium (ранее – YouTube Red).
- views_percentage (основной показатель)
- Процент зрителей, которые вошли в аккаунт при просмотре видео или плейлиста. This is a core metric and is subject to the Deprecation Policy.
Показатели охвата
- video_thumbnail_impressions
- Сколько раз значки видео показывались зрителям. Есть два главных условия: значок демонстрировался дольше одной секунды и хотя бы половина изображения находилась в видимой части экрана. Подробную информацию вы найдете в Справочном центре YouTube.
- video_thumbnail_impressions_ctr
- Процент показов, которые привели к клику для просмотра видео. Рассчитывается как отношение количества кликов к количеству показов.
Показатели времени просмотра
- watch_time_minutes (основной показатель)
- Общее время просмотра видео на канале, у владельца контента, в видео или плейлисте (в минутах). Этот показатель включает совместные просмотры, когда несколько человек смотрят видео на одном телевизоре. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- Количество минут, в течение которых пользователи с подпиской YouTube Premium (ранее – YouTube Red) смотрели видео.
- average_view_duration_seconds (основной показатель)
- Средняя продолжительность воспроизведения видео в секундах. С 13 декабря 2021 г. этот показатель не учитывает трафик, связанный с зацикленными клипами. В отчете о плейлистах этот показатель отражает среднюю продолжительность воспроизведения видео в секундах в контексте плейлиста. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- Средняя продолжительность просмотра видео в процентах. С 13 декабря 2021 г. этот показатель не учитывает трафик, связанный с зацикленными клипами.
Показатели вовлечения
- Комментарии (основной показатель)
- Количество комментариев к видео. Подробную информацию вы найдете в Справочном центре YouTube. This is a core metric and is subject to the Deprecation Policy.
- Отметки "Нравится" (основной показатель)
- Количество раз, когда пользователи показали, что им понравилось видео, поставив ему положительную оценку. This is a core metric and is subject to the Deprecation Policy.
- dislikes (основной показатель)
- Количество раз, когда пользователи показали, что им не понравилось видео, поставив ему отрицательную оценку. 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. - subscribers_gained (основной показатель)
- Количество подписок на канал. This is a core metric and is subject to the Deprecation Policy.
Пользователи могут подписываться на каналы и отменять подписку на страницах просмотра видео, страницах каналов и в гиде на главной странице YouTube. Чтобы определить, сколько новых подписчиков канала не использовали страницу просмотра видео, в базовом отчете о действиях пользователей есть строка, в которой не указано значение параметра video_id. В этой строке также указано значение показателяsubscribersLost, но не указаны значения других показателей. - subscribers_lost (основной показатель)
- Сколько раз пользователи отменяли подписку на канал. 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 (поддерживается только в YouTube Reporting API)
- Сколько раз пользователи сохраняли плейлист. Подробнее о сохраненных плейлистах в Справочном центре YouTube. Это абсолютное значение. Если пользователь сохранит плейлист, удалит его из списка сохраненных, а затем снова сохранит, то в статистике будет учтено два сохранения.
- playlist_saves_removed (поддерживается только в YouTube Reporting API)
- Сколько раз пользователи удаляли плейлист из списка сохраненных. Этот показатель возвращает абсолютное число. Например, если пользователь сохранил плейлист, удалил его из списка сохраненных, снова сохранил и снова удалил, то значение показателя будет равно двум.
Показатели аннотаций
- annotation_impressions
- Общее количество показов аннотаций.
- annotation_clickable_impressions
- Количество аннотаций, которые появились на экране и на которые можно было нажать.
- annotation_clicks
- Количество аннотаций, на которые нажимали зрители.
- annotation_click_through_rate (основной показатель)
- Отношение числа аннотаций, на которые нажимали зрители, к общему количеству показов интерактивных аннотаций. This is a core metric and is subject to the Deprecation Policy. Подробнее о том, как создавать аннотации и добавлять в них ссылки, написано в Справочном центре YouTube.
- annotation_closable_impressions
- Количество аннотаций, которые были показаны и могли быть закрыты.
- annotation_closes
- Количество закрытых аннотаций.
- annotation_close_rate (основной показатель)
- Отношение количества аннотаций, закрытых зрителями, к общему числу показов аннотаций. This is a core metric and is subject to the Deprecation Policy.
Показатели карточек
В Справочном центре YouTube вы найдете подробные инструкции о том, как добавлять подсказки в видео и как работать с отчетом о подсказках в YouTube Аналитике.
- card_impressions
- Сколько раз зрители видели подсказки. Когда зритель открывает панель с подсказками, регистрируется показ каждой из них.
- card_clicks
- Сколько раз пользователи нажимали на подсказки.
- card_click_rate
- Показатель CTR для карточек, который рассчитывается как отношение количества кликов по карточкам к числу их показов.
- Сколько раз были показаны тизеры подсказок. За один просмотр видео может быть зарегистрировано несколько показов тизера.
- Количество кликов по тизерам подсказок. Клики по значку подсказки относятся к последнему тизеру, показанному пользователю.
- Показатель CTR для тизеров подсказок. Рассчитывается как отношение количества кликов по тизерам к общему числу их показов.
Статистика по конечным заставкам
Конечные заставки – это элементы, которые появляются в последние 5–20 секунд видео и позволяют продвигать контент, канал и сайты. В Справочном центре YouTube вы найдете подробные инструкции о том, как добавлять конечные заставки и как работать с отчетом о них в YouTube Аналитике.
- end_screen_element_impressions
- Количество показанных элементов конечной заставки. Показ регистрируется для каждого элемента конечной заставки.
- end_screen_element_clicks
- Количество кликов по элементам конечной заставки.
- end_screen_element_click_rate
- Показатель CTR элементов конечной заставки, который рассчитывается как отношение числа кликов по элементам конечной заставки к числу их показов.
Показатели отмены спонсорства
- membershipsCancellationSurveyResponses
- Количество опросов, пройденных пользователями YouTube, которые отменили спонсорство на указанном канале в течение отчетного периода.
Показатели расчетного дохода
Примечание. Показатели расчетного дохода корректируются в конце месяца и не включают рекламу, проданную и показанную в партнерских сетях. Дополнительную информацию и примечания о расчетном доходе можно найти в Справочном центре YouTube.
- estimated_partner_revenue (основной показатель)
- Общий расчетный чистый доход от всех источников рекламы, проданной Google, а также от источников, не связанных с рекламой, за выбранный диапазон дат и регион.
- estimated_partner_ad_revenue
- Общий расчетный чистый доход от всех источников рекламы, проданной Google, за выбранный диапазон дат и регион.
Показатели расчетного дохода корректируются в конце месяца и не включают рекламу, проданную и размещенную партнерами. - estimated_partner_ad_auction_revenue (поддерживается только в YouTube Reporting API)
- Общий расчетный доход (чистый доход) от рекламы, проданной на аукционе AdSense, за выбранный диапазон дат и регион. Ранее этот показатель назывался
estimated_partner_ad_sense_revenue. - estimated_partner_ad_reserved_revenue (поддерживается только в YouTube Reporting API)
- Общий расчетный доход (чистый доход) от рекламы, проданной с зарезервированными местами размещения через DoubleClick (DCLK), и других источников продаж YouTube. Ранее этот показатель назывался
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (поддерживается только в YouTube Reporting API)
- Общий расчетный доход (чистая прибыль) от подписок YouTube Premium (ранее – YouTube Red).
- estimated_partner_transaction_revenue (поддерживается только в YouTube Reporting API)
- Общий расчетный доход от транзакций, например платного контента и фан-фандинга, за вычетом возвратов платежей.
Показатели эффективности объявлений
- estimated_youtube_ad_revenue
- Ориентировочный валовой доход в долларах США от рекламы, проданной через Google или партнерскую сеть DoubleClick, за выбранный период в указанном регионе. Валовой доход корректируется в конце месяца и не включает доход от рекламы, показанной партнерами. Валовой доход не следует путать с расчетным или чистым доходом, который рассчитывается с учетом вашей доли владения и соглашений о распределении дохода.
- estimated_cpm
- Расчетный валовой доход за тысячу показов объявлений.
- ad_impressions
- Количество подтвержденных показов объявлений.
- estimated_monetized_playbacks
- Количество просмотров видео, в ходе которых происходит хотя бы один показ объявления. Коммерческое воспроизведение засчитывается, если пользователю показывается реклама в начале ролика, даже если он закрывает ее, не досмотрев до конца. Ожидаемая погрешность для этого показателя составляет ±2,0 %.
- estimated_playback_based_cpm
- Расчетный валовой доход за тысячу воспроизведений.