YouTube Analytics API: Channel Reports

На этой странице представлены отчеты, которые владельцы каналов могут получать с помощью API YouTube Analytics. Отчеты по каналам предоставляют метрики активности пользователей для указанного канала и измеряют такие показатели, как просмотры видео, рейтинги и количество подписчиков.

  • В отчетах по видеоконтенту представлена ​​статистика по всей активности пользователей, связанной с видеороликами канала.
  • Отчеты по плейлистам содержат статистику, непосредственно связанную с просмотрами видео в контексте данного плейлиста.
  • Отчеты об эффективности рекламы содержат показатели, связанные с доходом и эффективностью рекламы. В них используется параметр adType для группировки показателей на основе типов рекламы, которые показывались во время воспроизведения видео. В разделе отчетов об эффективности рекламы объясняется два типа показателей эффективности рекламы, которые поддерживает API.

Получение отчета

Для получения отчета по каналу необходимо установить значение параметра ids в вашем API-запросе на одно из следующих значений:

  • channel==MINE – API возвращает данные о YouTube-канале авторизованного пользователя.

  • channel== CHANNEL_ID – Установите CHANNEL_ID равным уникальному идентификатору канала, для которого вы получаете данные. Пользователь, авторизующий запрос, должен быть владельцем канала.

    В настоящее время идентификатор канала представляет собой строку, начинающуюся с букв UC , однако его формат может измениться. (Вы можете найти идентификатор своего канала на странице расширенных настроек учетной записи для вашего канала YouTube или получить его программным способом, используя метод channels.list YouTube Data API's .)

Авторизация

Все запросы к API YouTube Analytics должны быть авторизованы. В руководстве по авторизации объясняется, как использовать протокол OAuth 2.0 для получения токенов авторизации.

Для запросов к API YouTube Analytics используются следующие области авторизации:

Области применения
https://www.googleapis.com/auth/yt-analytics.readonly Просматривайте отчеты YouTube Analytics по вашему контенту на YouTube. Этот раздел предоставляет доступ к показателям активности пользователей, таким как количество просмотров и оценок.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Просматривайте финансовые отчеты YouTube Analytics по вашему контенту на YouTube. Этот раздел предоставляет доступ к показателям активности пользователей, а также к прогнозируемым показателям дохода и эффективности рекламы.
https://www.googleapis.com/auth/youtube Управляйте своим аккаунтом YouTube. В API аналитики YouTube владельцы каналов используют эту область действия для управления группами и элементами групп аналитики YouTube.
https://www.googleapis.com/auth/youtubepartner Просматривайте и управляйте ресурсами YouTube и связанным с ними контентом на YouTube. В API YouTube Analytics владельцы контента используют эту область действия для управления группами и элементами групп в YouTube Analytics.

Примечание: Для отчетов по каналам поддерживаются показатели предполагаемого дохода и эффективности рекламы. Для доступа к этим показателям ваш запрос должен быть авторизован с использованием области действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly . Кроме того, канал авторизованного пользователя должен быть участником партнерской программы YouTube. Запрос финансовых показателей для канала, не входящего в партнерскую программу YouTube, приведет к ошибке 403 Forbidden .

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

Фильтры

В таблицах, описывающих поддерживаемые отчеты, указаны фильтры, которые можно использовать для каждого отчета. В таблицах фильтры, указанные в скобках, являются необязательными. Например, для параметра фильтрации video(,country) фильтр video является обязательным, а фильтр country — необязательным.

API также поддерживает возможность указания нескольких значений для фильтров video и playlist . Если вы укажете несколько значений для одного из этих фильтров, вы также можете добавить этот фильтр в список параметров, которые вы указываете для запроса. Это справедливо даже в том случае, если фильтр не указан в списке поддерживаемых параметров для конкретного отчета.

Полное объяснение того, как фильтровать результаты API по определенному значению или набору значений, см. в определении параметра filters .

Понимание таблиц отчетов

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

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более subscribedStatus , youtubeProduct

Таблица содержит две строки для измерений, одну строку для метрик и три строки для фильтров. Для измерений и фильтров значения из каждой строки могут быть объединены в запросе API при условии, что комбинация соответствует правилам использования, указанным в таблице. Например, допустимые значения параметров dimensions для этого отчета включают:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Однако значение параметра day,month недопустимо, поскольку оно использует два измерения, основанных на времени, и в запросе должно быть указано либо 0, либо 1.

Терминология таблиц отчетов

В таблицах используется следующая терминология для обозначения того, являются ли измерения обязательными или необязательными:

  • Эти термины означают, что требуется указать значение:
    • Обязательно: необходимо указать значение.
    • Используйте ровно 1: необходимо включить одно значение из группы.
    • Используйте 1 или более: Вы можете включить любые или все значения из группы, но необходимо включить хотя бы одно.
  • Эти термины означают, что значение является необязательным:
    • Необязательно: Вы можете указать значение по своему усмотрению.
    • Используйте 0 или 1: Вы можете выбрать одно значение из группы.
    • Используйте 0 или более: Вы можете включить любые или все значения из группы.

Видеорепортажи

Основные статистические данные

Основные статистические данные об активности пользователей

Этот отчет содержит статистику, связанную с действиями пользователей на канале. Вы можете отфильтровать отчет, чтобы получить только данные по конкретному видео или стране.

Содержание
Размеры:
[Никто]
Показатели:
Используйте 1 или более engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
Фильтры:
Используйте 0 или 1 country , continent , subContinent
Используйте 0 или 1 video , group

Основные статистические данные об активности пользователей в штатах США

В этом отчете представлены статистические данные по конкретному штату США или округу Колумбия. Обратите внимание, что данный отчет поддерживает только часть показателей, доступных в отчете по отдельной стране, описанном выше.

Содержание
Размеры:
[Никто]
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Необходимый province
Используйте 0 или 1 video , group

на основе времени

Активность пользователей по странам за определенные периоды времени

Этот отчет содержит статистику действий пользователей на канале за определенные временные интервалы. Вы можете отфильтровать отчет, чтобы получить только данные по конкретному видео или стране.

Содержание
Размеры:
Используйте ровно 1 day , month
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , uniques , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
Фильтры:
Используйте 0 или 1 country , continent , subContinent
Используйте 0 или 1 video , group

Активность пользователей в штатах США за определенные периоды времени.

В этом отчете представлены статистические данные об активности пользователей в конкретном штате США или округе Колумбия. Обратите внимание, что данный отчет поддерживает только часть показателей, доступных в отчете по отдельным странам, описанном выше.

Содержание
Размеры:
Используйте ровно 1 day , month
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Необходимый province
Используйте 0 или 1 video , group

география пользователя

Активность пользователей по странам

В этом отчете представлена ​​статистика активности пользователей по странам для каждого канала. Вы можете отфильтровать отчет, чтобы получить данные только по конкретному видео.

Содержание
Размеры:
Необходимый country
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
Фильтры:
Используйте 0 или 1 continent , subContinent
Используйте 0 или 1 video , group

Активность пользователей по провинциям

В этом отчете представлена ​​статистика активности пользователей по штатам США и округу Колумбия. Для создания этого отчета необходимо установить значение параметра filters равным country==US .

Содержание
Размеры:
Необходимый province
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Необходимый country ==US
Используйте 0 или 1 video , group

Активность пользователей по городам (<= 250 результатов)

Примечание: Для этого отчета необходимо установить параметр maxResults на целое число, равное 250 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .

В этом отчете представлены статистические данные об активности пользователей по городам.

Содержание
Размеры:
Необходимый city
Используйте 0 или более creatorContentType , country , province , subscribedStatus

Note: If you include the province dimension, you must also use the country ==US filter.
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Параметры сортировки: - views
- estimatedMinutesWatched

Активность пользователей по данным DMA

В этом отчете представлена ​​статистика активности пользователей по обозначенным рыночным зонам (DMA). Для получения этого отчета необходимо либо установить значение параметра filters равным country==US , либо отфильтровать данные по конкретной провинции (штату США).

Содержание
Размеры:
Необходимый dma
Используйте 0 или 1 day
month
creatorContentType
subscribedStatus
Показатели:
Используйте 1 или более engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
Фильтры:
Используйте 0 или 1 country ==US
province
Используйте 0 или 1 video
group
Параметры сортировки: - views
- estimatedMinutesWatched

Подробности воспроизведения

В подробных отчетах о воспроизведении представлены статистические данные, относящиеся к следующим параметрам просмотра:

  • Это была прямая видеотрансляция или видео по запросу?
  • Был ли зритель подписан на канал, которому принадлежит видео?
  • На каком устройстве YouTube был сделан этот снимок?

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

Активность пользователей в зависимости от статуса подписки

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

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Используйте 0 или 1 country , continent , subContinent
Используйте 0 или 1 video , group
Необязательный subscribedStatus

Активность пользователей в зависимости от статуса подписки по провинциям

В этом отчете представлены показатели активности пользователей, как подписанных, так и неподписанных, в штатах США или округе Колумбия. Данный отчет содержит меньше показателей, чем предыдущий.

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Используйте 0 или 1 video , group
Используйте 0 или более province , subscribedStatus

Детали воспроизведения с возможностью указания временного параметра.

Временное измерение — день или месяц — является необязательным для этих отчетов, поскольку в любом случае необходимо использовать параметры запроса startDate и endDate для указания диапазона дат, который будет охватывать отчет. Если измерение присутствует, это означает, что данные в отчете должны быть агрегированы по дням, месяцам и т. д.

Подробная информация о воспроизведении с возможностью указания временного параметра и статистика в режиме реального времени или по запросу.

Этот отчет предоставляет подробную статистику воспроизведения за определенные временные интервалы. Он поддерживает измерение (и фильтр) liveOrOnDemand .

Содержание
Размеры:
Используйте 0 или более creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Подробная информация о воспроизведении с возможностью указания временного параметра и показателя averageViewPercentage.

Этот отчет предоставляет подробную статистику воспроизведения за определенные временные интервалы. Он поддерживает метрику averageViewPercentage .

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Используйте 0 или 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более subscribedStatus , youtubeProduct

Подробная информация о воспроизведении по странам

Подробная информация о воспроизведении по странам со статистикой liveOrOnDemand

Этот отчет предоставляет подробную статистику воспроизведения по каждой стране. Он поддерживает измерение (и фильтр) liveOrOnDemand .

Содержание
Размеры:
Необходимый country
Используйте 0 или более creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Используйте 0 или 1 continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Подробная информация о воспроизведении по странам с указанием среднего процента просмотра .

Следующий отчет аналогичен предыдущему. В нем добавлена ​​поддержка метрики averageViewPercentage , но отсутствует поддержка liveOrOnDemand в качестве параметра или фильтра.

Содержание
Размеры:
Необходимый country
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более subscribedStatus , youtubeProduct

Подробная информация о воспроизведении по провинциям

Подробная информация о воспроизведении по провинциям со статистикой liveOrOnDemand

Этот отчет содержит подробную статистику воспроизведения для штатов США и округа Колумбия. Он поддерживает измерение (и фильтр) liveOrOnDemand .

Содержание
Размеры:
Необходимый province
Используйте 0 или более creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Необходимый country ==US
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Подробная информация о воспроизведении по провинциям с указанием среднего процента просмотра .

Следующий отчет аналогичен предыдущему. В нем добавлена ​​поддержка метрики averageViewPercentage , но отсутствует поддержка liveOrOnDemand в качестве параметра или фильтра.

Содержание
Размеры:
Необходимый province
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Необходимый country ==US
Используйте 0 или 1 video , group
Используйте 0 или более subscribedStatus , youtubeProduct

Места воспроизведения

отчет о местоположении воспроизведения видео

В этом отчете представлены статистические данные, касающиеся типа страницы или приложения, в которых происходило воспроизведение видео.

Содержание
Размеры:
Необходимый insightPlaybackLocationType
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus

Подробная информация о месте воспроизведения (<= 25 результатов)

Примечание: Для этого отчета необходимо установить параметр maxResults на целое число, равное 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .

В этом отчете определены встроенные видеоплееры, которые обеспечили наибольшее количество просмотров или времени просмотра видеороликов канала.

Содержание
Размеры:
Необходимый insightPlaybackLocationDetail
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Необходимый insightPlaybackLocationType ==EMBEDDED
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus
Параметры сортировки: - views
- estimatedMinutesWatched

Источники трафика

Источник трафика

Этот отчет обобщает статистику просмотров в зависимости от способа, которым зрители попали на ваш видеоконтент. Например, он определяет количество просмотров, которые произошли из поиска Google или по ссылке на похожее видео.

Примечание: В этом отчете будет возвращена ошибка, если произведение количества запрошенных видео на количество дней в заданном диапазоне дат превышает 50 000. Например, запрос, извлекающий данные для 500 идентификаторов видео, может запрашивать данные максимум за 100 дней. Чтобы уменьшить количество возвращаемых строк, разделите запрос на несколько запросов, в которых указано меньшее количество видео или заданы более короткие диапазоны дат.

Содержание
Размеры:
Необходимый insightTrafficSourceType
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus

Подробная информация об источнике трафика (<= 25 результатов)

Примечание: Для этого отчета необходимо установить параметр maxResults на целое число, равное 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .

Этот отчет объединяет статистику просмотров на основе источников переходов, которые сгенерировали наибольшее количество просмотров контента канала. Источники переходов классифицируются по типу трафика, а определение параметра insightTrafficSourceDetail указывает источники трафика, для которых доступен отчет. Например, если вы установите фильтр insightTrafficSourceType в значение ADVERTISING , в отчете будут перечислены типы рекламы, которые сгенерировали наибольшее количество просмотров или времени просмотра контента канала.

Содержание
Размеры:
Необходимый insightTrafficSourceDetail
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Необходимый insightTrafficSourceType (see note below table)
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus
Параметры сортировки: - views
- estimatedMinutesWatched

Примечание: Данный отчет поддерживается только для определенных источников трафика. Источники трафика VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES и NO_LINK_EMBEDDED относятся к числу неподдерживаемых.

Тип устройства и операционная система

Тип устройства

Этот отчет обобщает статистику просмотров в зависимости от способа, которым зрители попали на ваш видеоконтент. Например, он определяет количество просмотров, совершенных на мобильных устройствах или игровых консолях.

Содержание
Размеры:
Необходимый deviceType
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более operatingSystem , liveOrOnDemand , subscribedStatus , youtubeProduct

Операционная система

В этом отчете собрана статистика просмотров на основе операционных систем пользователей. Например, в нем указано количество просмотров, совершенных на устройствах Android или PlayStation.

Содержание
Размеры:
Необходимый operatingSystem
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более deviceType , liveOrOnDemand , subscribedStatus , youtubeProduct

Операционная система и тип устройства

В этом отчете собрана сводная статистика просмотров на основе операционных систем и типов устройств пользователей. Например, в нем указано количество просмотров, совершенных на планшетах Android или на настольных компьютерах Windows.

Содержание
Размеры:
Необходимый deviceType , operatingSystem
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct

Демографические данные зрителей

В этом отчете собраны статистические данные о просмотрах с учетом возрастных групп и пола зрителей.

Содержание
Размеры:
Используйте 1 или более ageGroup , gender
Используйте 0 или более creatorContentType , liveOrOnDemand , subscribedStatus
Показатели:
Используйте 1 или более viewerPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus
Примечание: Значения viewerPercentage в этом отчете не нормализованы для различных значений или комбинаций значений параметров детализации воспроизведения ( subscribedStatus , liveOrOnDemand или youtubeProduct ).

Например, отчет, использующий измерение subscribedStatus, возвращает данные viewerPercentage, суммарно равные 100 процентам для просмотров, на которые оформлена подписка , и данные viewerPercentage , суммарно равные 100 процентам для просмотров, на которые подписка не оформлена. (Общая сумма значений всех полей viewerPercentage в отчете составляет 200 процентов.)

Вы можете использовать фильтры, чтобы гарантировать, что отчет будет содержать данные viewerPercentage только для одного значения (или комбинации значений) по параметрам детализации воспроизведения.

Вовлеченность и обмен контентом

В этом отчете представлены статистические данные, показывающие, как часто видеоролики канала распространялись на различных социальных платформах.

Содержание
Размеры:
Необходимый sharingService
Используйте 0 или более creatorContentType , subscribedStatus
Показатели:
Используйте 1 или более shares
Фильтры:
Используйте 0 или 1 country , continent , subContinent
Используйте 0 или 1 video , group
Необязательный subscribedStatus

Удержание аудитории

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

  • Удержание аудитории

    Эти показатели демонстрируют, насколько хорошо видео удерживает внимание аудитории.

    • audienceWatchRatio — это коэффициент, который сравнивает количество просмотров фрагмента видео с общим количеством просмотров самого видео.
    • relativeRetentionPerformance демонстрирует, насколько хорошо видео удерживает зрителей во время воспроизведения по сравнению с другими видеороликами YouTube аналогичной продолжительности.
  • Детальная статистика часов

    Эти показатели предоставляют информацию о том, как часто просматривались определенные фрагменты видео.

    • startedWatching показывает, как часто зрители начинали смотреть видео в определенном его фрагменте.
    • stoppedWatching указывает, как часто зрители прекращали просмотр видео во время определенного его фрагмента.
    • totalSegmentImpressions показывает, как часто просматривался тот или иной фрагмент видео.

Примечание: В этом отчете не поддерживается возможность указания списка значений, разделенных запятыми, для video ; значение должно содержать один идентификатор видео.

Содержание
Размеры:
Необходимый elapsedVideoTimeRatio
Показатели:
Используйте 1 или более audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
Фильтры:
Необходимый video
Используйте 0 или более audienceType
subscribedStatus
youtubeProduct

Одновременное количество зрителей (для прямых трансляций)

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

Содержание
Размеры:
Используйте 0 или 1 livestreamPosition
Показатели:
Используйте 1 или более averageConcurrentViewers
peakConcurrentViewers
Фильтры:
Необходимый video

Лучшие видео

Примечание: Для создания этих отчетов необходимо установить параметр maxResults на целое число, равное 200 или меньше. Данные за период до 1 января 2013 года доступны только для 10 самых популярных видеороликов. В отличие от большинства других отчетов, для этих отчетов также необходимо указать значение параметра запроса sort .

Лучшие видеоролики с возможностью фильтрации по регионам (<= 200 результатов)

В этом отчете перечислены лучшие видеоролики канала. Отчет можно отфильтровать по странам , континентам или субконтинентам .

Содержание
Размеры:
Необходимый video
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
Фильтры:
Используйте 0 или 1 country , continent , subContinent
Параметры сортировки: - views
- redViews
- estimatedRevenue
- estimatedRedPartnerRevenue
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- subscribersGained
- subscribersLost

Лучшие видеоролики по штатам (<= 200 результатов)

В этом отчете перечислены самые популярные видеоролики канала в конкретном штате США или округе Колумбия. Обратите внимание, что этот отчет поддерживает только часть показателей, доступных в отчете по отдельным странам, описанном выше.

Содержание
Размеры:
Необходимый video
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Необходимый province
Необязательный subscribedStatus
Параметры сортировки: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

Лучшие видео для подписчиков и отписавшихся зрителей (<= 200 результатов)

В этом отчете перечислены лучшие видео канала для подписчиков и отписавшихся пользователей. Отчет можно отфильтровать по стране , континенту или субконтиненту . Предыдущий отчет позволял получить список лучших видео в конкретном штате США для подписчиков и отписавшихся пользователей, но он поддерживал меньше метрик, чем этот отчет.

Содержание
Размеры:
Необходимый video
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
Фильтры:
Необязательный subscribedStatus
Используйте 0 или 1 country , continent , subContinent
Параметры сортировки: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

Лучшие видеоролики по продуктам YouTube (<= 200 результатов)

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

Содержание
Размеры:
Необходимый video
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или более subscribedStatus , youtubeProduct
Параметры сортировки: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

Лучшие видеоролики с фильтрами детализации воспроизведения (<= 200 результатов)

В этом отчете перечислены самые популярные видео канала, отфильтрованные по любому или всем параметрам детализации воспроизведения: liveOrOnDemand , subscribedStatus и youtubeProduct . В отличие от предыдущего отчета, этот поддерживает фильтр liveOrOnDemand и не поддерживает показатель averageViewPercentage .

Содержание
Размеры:
Необходимый video
Необязательный creatorContentType
Показатели:
Используйте 1 или более engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Параметры сортировки: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

Отчеты по плейлистам

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

Сводные видеометрики

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

Список поддерживаемых YouTube показателей агрегированных видеометрик см. в разделе «Поддерживаемые метрики плейлистов» .

Показатели внутри плейлиста

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

Поддерживаемые метрики плейлистов

Содержание
Сводные видеометрики engagedViews , views , estimatedMinutesWatched , averageViewDuration
Показатели внутри плейлиста playlistViews , playlistEstimatedMinutesWatched , playlistAverageViewDuration , playlistSaves , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist

Основные статистические данные

Этот отчет содержит статистику взаимодействия пользователей с видеороликами в плейлистах канала. Вы можете отфильтровать отчет, чтобы получить данные только по определенному плейлисту.

Содержание
Размеры:
[Никто]
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

на основе времени

Этот отчет содержит статистику взаимодействия пользователей с видеороликами в плейлистах канала. Вы можете отфильтровать отчет, чтобы получить данные только по определенному плейлисту.

Содержание
Размеры:
Используйте ровно 1 day , month
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

география пользователя

Активность плейлистов по странам

В этом отчете представлены статистические данные о взаимодействии пользователей из определенной страны с видеороликами в плейлистах канала.

Содержание
Размеры:
Необходимый country
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration
Фильтры:
Используйте ровно 1 playlist , group
Используйте 0 или 1 continent , subContinent

Активность плейлистов по провинциям

В этом отчете представлена ​​статистика активности плейлистов по штатам США и округу Колумбия. Для получения данных по Соединенным Штатам необходимо отфильтровать результаты.

Содержание
Размеры:
Необходимый province
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration
Фильтры:
Необходимый country ==US
Используйте ровно 1 playlist , group

Места воспроизведения

В этом отчете представлены статистические данные о типе страницы или приложения, где происходило воспроизведение видеороликов из вашего плейлиста.

Содержание
Размеры:
Необходимый insightPlaybackLocationType
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

Подробная информация о месте воспроизведения (<= 25 результатов)

Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .

В этом отчете определены встроенные видеоплееры, которые обеспечили наибольшее количество просмотров или времени просмотра видеороликов в плейлистах канала.

Содержание
Размеры:
Необходимый insightPlaybackLocationDetail
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Необходимый insightPlaybackLocationType ==EMBEDDED
Используйте ровно 1 playlist , group
Параметры сортировки: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

Источники трафика

Этот отчет обобщает статистику просмотров в зависимости от того, как зрители попали на контент вашего плейлиста. Например, он определяет количество просмотров, которые произошли из поисковых запросов Google.

Содержание
Размеры:
Необходимый insightTrafficSourceType
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

Подробная информация об источнике трафика (<= 25 результатов)

Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .

В этом отчете собрана статистика просмотров на основе источников переходов, которые сгенерировали наибольшее количество просмотров для видео в плейлистах канала. Источники переходов классифицируются по типу трафика, а определение параметра insightTrafficSourceDetail указывает на источники трафика, для которых доступен отчет.

Например, если вы установите фильтр insightTrafficSourceType в значение ADVERTISING , в отчете будут перечислены типы рекламы, которые сгенерировали наибольшее количество просмотров или времени просмотра для плейлистов канала.

Содержание
Размеры:
Необходимый insightTrafficSourceDetail
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Необходимый insightTrafficSourceType ==ADVERTISING (or another supported value)
Используйте ровно 1 playlist , group
Параметры сортировки: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

Примечание: Данный отчет поддерживается только для определенных источников трафика. Источники трафика VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES и NO_LINK_EMBEDDED относятся к числу неподдерживаемых.

Тип устройства и операционная система

Тип устройства

Этот отчет обобщает статистику просмотров в зависимости от того, как зрители попали на видео в ваших плейлистах. Например, он определяет количество просмотров, произошедших на мобильных устройствах или игровых консолях.

Содержание
Размеры:
Необходимый deviceType
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

Операционная система

В этом отчете собрана статистика просмотров на основе операционных систем пользователей. Например, в нем указано количество просмотров, совершенных на устройствах Android или PlayStation.

Содержание
Размеры:
Необходимый operatingSystem
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

Операционная система и тип устройства

В этом отчете собрана сводная статистика просмотров на основе операционных систем и типов устройств пользователей. Например, в нем указано, сколько просмотров было совершено на планшетах Android или настольных компьютерах Windows.

Содержание
Размеры:
Необходимый deviceType , operatingSystem
Показатели:
Используйте 1 или более engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
Фильтры:
Используйте ровно 1 playlist , group

Демографические данные зрителей

Содержание
Размеры:
Используйте 1 или более ageGroup , gender
Показатели:
Необходимый viewerPercentage
Фильтры:
Используйте ровно 1 playlist , group

Лучшие плейлисты

Примечание: Для создания этих отчетов необходимо установить параметр maxResults на целое число, равное 200 или меньше. Данные за период до 1 января 2013 года доступны только для 10 лучших плейлистов. В отличие от большинства других отчетов, для этих отчетов также необходимо указать значение параметра запроса sort .

В этом отчете представлен список лучших плейлистов канала, составленный на основе указанных критериев фильтрации и сортировки.

Содержание
Размеры:
Необходимый playlist
Показатели:
Используйте 1 или более averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
Параметры сортировки: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

Отчеты о членстве

Отмена членства

В этом отчете представлены статистические данные, показывающие причины, по которым пользователи отменили свою подписку на канал.

Содержание
Размеры:
Используйте 0 или 1 membershipsCancellationSurveyReason
Показатели:
Необходимый membershipsCancellationSurveyResponses

Отчеты об эффективности рекламы

Примечание: Для отчетов об эффективности рекламы требуется токен авторизации, предоставляющий доступ к области действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly .

Отчеты об эффективности рекламы предоставляют метрики, основанные на показах, для объявлений, которые демонстрировались во время воспроизведения видео. Эти метрики учитывают каждый показ объявления, а каждое воспроизведение видео может привести к нескольким показам.

Показатели эффективности рекламы, основанные на количестве показов, включают в себя:

Кроме того, некоторые отчеты по видеоконтенту поддерживают следующие показатели эффективности рекламы, основанные на воспроизведении. Однако эти показатели не включаются в отчеты об эффективности рекламы.

Эффективность рекламы по типам рекламы

Содержание
Размеры:
Необходимый adType
Необязательный day
Показатели:
Используйте 1 или более grossRevenue , adImpressions , cpm
Фильтры:
Используйте 0 или 1 video , group
Используйте 0 или 1 country , continent , subContinent