YouTube Analytics API: Channel Reports

Измерения 7DayTotals и 30DayTotals устарели. Для получения дополнительной информации см. Историю изменений .

На этой странице перечислены отчеты, которые владельцы каналов могут получить с помощью 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 Analytics владельцы каналов используют эту область для управления группами и элементами групп YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Просматривайте ресурсы YouTube и связанный с ними контент на YouTube и управляйте ими. В API YouTube Analytics владельцы контента используют эту область для управления группами и элементами групп YouTube Analytics.

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

Фильтры

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

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

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

Общие сведения о таблицах отчетов

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

Содержание
Размеры:
Используйте ровно 1 day , month
Используйте 0 или более subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

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

  • dimensions=day
  • dimensions=7DayTotals,subscribedStatus
  • dimensions=30DayTotals,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Однако значение параметра day,month недопустимо, так как оно использует два измерения на основе времени, но запрос должен использовать ровно 1. В этом случае значение параметра subscribedStatus,youtubeProduct фактически возвращает отчет, но показатели не агрегируются по дням. , неделя, месяц и т. д. (Этот отчет документируется отдельно в документации.)

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

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

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

Видео отчеты

Основные характеристики

Базовая статистика активности пользователей

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

Содержание
Размеры:
[Никто]
Метрики:
Используйте 1 или более 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 или более 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 или более 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 или более 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 или более 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 или более 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 или более views , estimatedMinutesWatched , averageViewDuration , averageViewPercentage
Фильтры:
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Варианты сортировки: - views
- estimatedMinutesWatched

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

Подробные отчеты о воспроизведении содержат статистику по следующим атрибутам просмотра:

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

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

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

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

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus
Используйте 0 или 1 day , month
Метрики:
Используйте 1 или более 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 или более 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

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

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

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

Содержание
Размеры:
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Используйте 0 или 1 day , month
Метрики:
Используйте 1 или более 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 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Используйте 0 или 1 continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Детали воспроизведения по странам с метрикой mediumViewPercentage

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

Содержание
Размеры:
Необходимый country
Используйте 0 или более creatorContentType , subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более 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 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
Фильтры:
Необходимый country ==US
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus , youtubeProduct
Подробная информация о воспроизведении по провинциям с метрикой mediumViewPercentage

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

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

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

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

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

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

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

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

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

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

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

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

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

Содержание
Размеры:
Необходимый insightTrafficSourceType
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus
Метрики:
Используйте 1 или более 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 или более views , estimatedMinutesWatched
Фильтры:
Необходимый insightTrafficSourceType (see note below table)
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 video , group
Используйте 0 или более liveOrOnDemand , subscribedStatus
Варианты сортировки: - views
- estimatedMinutesWatched

Примечание. Этот отчет поддерживается только для определенных источников трафика. Например, источник трафика NO_LINK_EMBEDDED не имеет дополнительных деталей и, следовательно, не поддерживает этот отчет. Подробные сведения о том, какие источники трафика поддерживают этот отчет, см. в определении insightTrafficSourceType .

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

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

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

Содержание
Размеры:
Необходимый deviceType
Используйте 0 или более creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более 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 или более 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 или более 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 аналогичной длины.

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

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

Лучшие видео

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

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

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

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

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

Основные характеристики

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

Содержание
Размеры:
[Никто]
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

по времени

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

Содержание
Размеры:
Используйте ровно 1 day , month
Используйте 0 или более subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

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

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

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

Содержание
Размеры:
Необходимый country
Используйте 0 или более subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

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

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

Содержание
Размеры:
Необходимый province
Используйте 0 или более subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1; country ==US
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

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

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

Содержание
Размеры:
Необходимый insightPlaybackLocationType
Используйте 0 или более day , subscribedStatus
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Необязательный subscribedStatus

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

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

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

Содержание
Размеры:
Необходимый insightPlaybackLocationDetail
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1; insightPlaybackLocationType ==EMBEDDED
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Необязательный subscribedStatus
Варианты сортировки: - views
- estimatedMinutesWatched
- playlistStarts

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

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

Содержание
Размеры:
Необходимый insightTrafficSourceType
Используйте 0 или более day , subscribedStatus
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Необязательный subscribedStatus

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

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

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

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

Содержание
Размеры:
Необходимый insightTrafficSourceDetail
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1; insightTrafficSourceType
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Необязательный subscribedStatus
Варианты сортировки: - views
- estimatedMinutesWatched
- playlistStarts

Примечание. Этот отчет поддерживается только для определенных источников трафика. Например, источник трафика NO_LINK_EMBEDDED не имеет дополнительных деталей и, следовательно, не поддерживает этот отчет. Подробные сведения о том, какие источники трафика поддерживают этот отчет, см. в определении insightTrafficSourceType .

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

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

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

Содержание
Размеры:
Необходимый deviceType
Используйте 0 или более day , subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более operatingSystem , subscribedStatus , youtubeProduct

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

Этот отчет объединяет статистику просмотров на основе операционных систем зрителей. Например, он определяет количество просмотров плейлиста на устройствах Android или PlayStation.

Содержание
Размеры:
Необходимый operatingSystem
Используйте 0 или более day , subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более deviceType , subscribedStatus , youtubeProduct

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

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

Содержание
Размеры:
Необходимый deviceType , operatingSystem
Используйте 0 или более day , subscribedStatus , youtubeProduct
Метрики:
Используйте 1 или более views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или 1 playlist , group
Используйте 0 или более subscribedStatus , youtubeProduct

Демография зрителей

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

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

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

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

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

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

Содержание
Размеры:
Необходимый playlist
Метрики:
Используйте 1 или более views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
Фильтры:
Необходимый isCurated ==1
Используйте 0 или 1 country , province , continent , subContinent
Используйте 0 или более playlist , subscribedStatus , youtubeProduct
Варианты сортировки: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- playlistStarts

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

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

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

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

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

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

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