Примечание: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program .
На этой странице представлены отчеты, которые владельцы контента могут получать с помощью API YouTube Analytics. Отчеты для владельцев контента содержат метрики для каналов, связанных с конкретным владельцем контента на YouTube. Метрики представляют собой отдельные измерения активности пользователей, эффективности рекламы или предполагаемого дохода.
В отчетах по видеоконтенту содержатся данные об активности пользователей, эффективности рекламы и предполагаемых показателях дохода от видеороликов на каналах владельца контента.
Отчеты по плейлистам предоставляют статистику, непосредственно связанную с просмотрами видео в контексте плейлиста. В отчетах по плейлистам используются многие из тех же параметров и фильтров, что и в отчетах по видео.
Отчеты об эффективности рекламы содержат показатели, связанные с доходом и эффективностью рекламы. В них используется параметр adType для группировки показателей на основе типов рекламы, которые показывались во время воспроизведения видео. В разделе отчетов об эффективности рекламы объясняется два типа показателей эффективности рекламы, которые поддерживает API.
Получение отчета
Чтобы получить отчет о владельце контента, вызовите метод reports.query API и установите значение параметра ids в запросе API равным contentOwner== OWNER_NAME , где OWNER_NAME указывает идентификатор владельца контента. Если вы не уверены в значении, обратитесь к своему менеджеру по работе с партнерами.
Авторизация
Все запросы к 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 .
Фильтры
Все API-запросы для получения отчетов о владельцах контента должны фильтровать данные, используя либо параметр video , либо параметр channel , либо поддерживаемую комбинацию параметров claimedStatus и uploaderType . (Поддерживаемые комбинации перечислены в определении параметра uploaderType .)
В таблицах, описывающих поддерживаемые отчеты, указаны фильтры, которые можно использовать для каждого конкретного отчета. В описаниях фильтры, указанные в скобках, являются необязательными. Например, если в отчете указан параметр фильтрации video(,country) , то отчет можно отфильтровать таким образом, чтобы он включал только данные для конкретного видео или только данные для конкретного видео в конкретной стране.
API также поддерживает возможность указания нескольких значений для фильтров video , playlist и channel . Если вы укажете несколько значений для одного из этих фильтров, вы также можете добавить этот фильтр в список параметров, которые вы указываете для запроса. Это справедливо даже в том случае, если фильтр не указан в списке поддерживаемых параметров для конкретного отчета.
Полное объяснение того, как фильтровать результаты API по определенному значению или набору значений, см. в определении параметра filters .
Понимание таблиц отчетов
В этом разделе объясняется форматирование и терминология, используемые в таблицах, определяющих отчеты, поддерживаемые API. В следующей таблице перечислены измерения, метрики и фильтры, поддерживаемые для отчета о воспроизведении видео с подробными сведениями, с использованием измерения времени и метрики averageViewPercentage .
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Таблица содержит две строки для измерений, одну строку для метрик и три строки для фильтров. Для измерений и фильтров значения из каждой строки могут быть объединены в запросе API при условии, что комбинация соответствует правилам использования, указанным в таблице. Например, допустимые значения параметров dimensions для этого отчета включают:
-
dimensions=day -
dimensions=day,subscribedStatus -
dimensions=month,subscribedStatus,youtubeProduct -
dimensions=month,youtubeProduct
Однако значение параметра day,month недопустимо, поскольку оно использует два измерения, основанных на времени, и в запросе должно быть указано либо 0, либо 1.
Терминология таблиц отчетов
В таблицах используется следующая терминология для обозначения того, являются ли измерения обязательными или необязательными:
- Эти термины означают, что требуется указать значение:
- Обязательно: необходимо указать значение.
- Используйте ровно 1: необходимо включить одно значение из группы.
- Используйте 1 или более: Вы можете включить любые или все значения из группы, но необходимо включить хотя бы одно.
- Эти термины означают, что значение является необязательным:
- Необязательно: Вы можете указать значение по своему усмотрению.
- Используйте 0 или 1: Вы можете выбрать одно значение из группы.
- Используйте 0 или более: Вы можете включить любые или все значения из группы.
Важно: Все запросы к API для получения отчетов о видеоконтенте от владельцев должны фильтровать данные, используя либо измерение
видео , измерение
канала , измерение
группы , либо поддерживаемую комбинацию измерений
claimedStatus и
uploaderType . (Некоторые отчеты не поддерживают все эти параметры.) Поддерживаемые комбинации, которые также указаны в определении измерения
uploaderType , следующие:
-
uploaderType==self -
claimedStatus==claimed -
claimedStatus==claimed;uploaderType==self -
claimedStatus==claimed;uploaderType==thirdParty
Видеорепортажи
Основные статистические данные
Основные статистические данные (включая количество подписчиков)
Этот отчет предоставляет статистику, связанную с действиями пользователей на всех каналах владельца контента. Вы можете отфильтровать отчет, чтобы получить только данные по конкретному видео или стране. Он также может использоваться для получения статистики только по заявленному контенту, включая заявленный контент, загруженный владельцем контента, третьими лицами или обоими.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 * |
|
| Фильтры: | |
Основные статистические данные по штатам США
В этом отчете представлены статистические данные по конкретному штату США или округу Колумбия. Обратите внимание, что данный отчет поддерживает только часть показателей, доступных в отчете по отдельной стране, описанном выше.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| Фильтры: | |
на основе времени
Активность за определенные периоды времени
Этот отчет содержит статистику действий пользователей на всех каналах владельца контента за определенные временные интервалы. Вы можете отфильтровать отчет, чтобы получить данные только по конкретному видео или стране.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 * |
|
| Фильтры: | |
Активность пользователей в штатах США за определенные периоды времени.
В этом отчете представлены статистические данные по конкретному штату США или округу Колумбия. Обратите внимание, что данный отчет поддерживает только часть показателей, доступных в отчете по отдельной стране, описанном выше.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| Фильтры: | |
география пользователя
Активность пользователей по странам
Этот отчет содержит статистические данные об активности пользователей по каждой стране для всех каналов владельца контента. Вы можете отфильтровать отчет, чтобы получить данные только по конкретному видео или каналу.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 * |
|
| Фильтры: | |
Активность пользователей по провинциям
В этом отчете представлена статистика активности пользователей по штатам США и округу Колумбия. Для создания этого отчета необходимо установить значение параметра filters равным country==US .
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| Фильтры: | |
Подробности воспроизведения
В подробных отчетах о воспроизведении представлены статистические данные, относящиеся к следующим параметрам просмотра:
- Это была прямая видеотрансляция или видео по запросу?
- Был ли зритель подписан на канал, которому принадлежит видео?
- На каком устройстве YouTube был сделан этот снимок?
Технически, параметры детализации воспроизведения, поддерживаемые этими отчетами, являются необязательными. Если вы не укажете параметры детализации воспроизведения в своем запросе, возвращаемый отчет будет фактически похож на один из базовых отчетов по статистике , по времени или по географическому признаку пользователя .
Примечание: измерение и фильтр liveOrOnDemand нельзя использовать совместно с метрикой averageViewPercentage . Поэтому в каждом из следующих подразделов приведены два отчета. Один отчет поддерживает измерение (и фильтр) liveOrOnDemand , а другой — метрику averageViewPercentage .
Активность пользователей в зависимости от статуса подписки
Этот отчет предоставляет метрики активности пользователей, как подписанных, так и неподписанных. Статистику можно группировать по временным периодам ( дню или месяцу ), а также фильтровать по стране , континенту или субконтиненту .
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 |
|
| Фильтры: | |
Активность пользователей в зависимости от статуса подписки по провинциям
В этом отчете представлены показатели активности пользователей, как подписанных, так и неподписанных, в штатах США или округе Колумбия. Данный отчет содержит меньше показателей, чем предыдущий.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| Фильтры: | |
Детали воспроизведения с возможностью указания временного параметра.
Временное измерение — день или месяц — является необязательным для этих отчетов, поскольку в любом случае необходимо использовать параметры запроса startDate и endDate для указания диапазона дат, который будет охватывать отчет. Если измерение присутствует, это означает, что данные в отчете должны быть агрегированы по дням, месяцам и т. д.
Подробная информация о воспроизведении с возможностью указания временного параметра и статистика в режиме реального времени или по запросу.
Этот отчет предоставляет подробную статистику воспроизведения за определенные временные интервалы. Он поддерживает измерение (и фильтр) liveOrOnDemand .
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о воспроизведении с возможностью указания временного параметра и показателя averageViewPercentage.
В этом отчете представлены подробные статистические данные о воспроизведении за определенные временные интервалы.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о воспроизведении по странам
Подробная информация о воспроизведении по странам со статистикой liveOrOnDemand
Этот отчет предоставляет подробную статистику воспроизведения по каждой стране. Он поддерживает измерение (и фильтр) liveOrOnDemand .
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о воспроизведении по странам с указанием среднего процента просмотра .
Следующий отчет аналогичен предыдущему. В нем добавлена поддержка метрики averageViewPercentage , но отсутствует поддержка liveOrOnDemand в качестве параметра или фильтра.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о воспроизведении по провинциям
Подробная информация о воспроизведении по провинциям со статистикой liveOrOnDemand
Этот отчет содержит подробную статистику воспроизведения для штатов США и округа Колумбия. Он поддерживает измерение (и фильтр) liveOrOnDemand .
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о воспроизведении по провинциям с указанием среднего процента просмотра .
Следующий отчет аналогичен предыдущему. В нем добавлена поддержка метрики averageViewPercentage , но отсутствует поддержка liveOrOnDemand в качестве параметра или фильтра.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Места воспроизведения
отчет о местоположении воспроизведения видео
В этом отчете представлены статистические данные, касающиеся типа страницы или приложения, в которых происходило воспроизведение видео.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о месте воспроизведения (<= 25 результатов)
Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .
В этом отчете определяются встроенные видеоплееры, которые обеспечили наибольшее количество просмотров или времени просмотра контента владельца. При получении этого отчета необходимо установить фильтр insightPlaybackLocationType в значение EMBEDDED .
Источники трафика
Источник трафика
Этот отчет обобщает статистику просмотров в зависимости от способа, которым зрители попали на ваш видеоконтент. Например, он определяет количество просмотров, которые произошли из поиска Google или по ссылке на похожее видео.
Примечание: В этом отчете будет возвращена ошибка, если произведение количества запрошенных видео на количество дней в заданном диапазоне дат превышает 50 000. Например, запрос, извлекающий данные для 500 идентификаторов видео, может запрашивать данные максимум за 100 дней. Чтобы уменьшить количество возвращаемых строк, разделите запрос на несколько запросов, в которых указано меньшее количество видео или заданы более короткие диапазоны дат.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация об источнике трафика (<= 25 результатов)
Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .
Этот отчет объединяет статистику просмотров на основе источников переходов, которые сгенерировали наибольшее количество просмотров для контента владельца. Источники переходов классифицируются по типу трафика, а определение параметра insightTrafficSourceDetail указывает источники трафика, для которых доступен отчет. Например, если вы установите фильтр insightTrafficSourceType в значение ADVERTISING , в отчете будут перечислены типы объявлений, которые сгенерировали наибольшее количество просмотров или времени просмотра для контента владельца.
Примечание: Данный отчет поддерживается только для определенных источников трафика. Источники трафика VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES и NO_LINK_EMBEDDED относятся к числу неподдерживаемых.
Тип устройства и операционная система
Тип устройства
В этом отчете собрана статистика просмотров в зависимости от типа устройства, которое использовали зрители при просмотре вашего контента. Например, в нем указано количество просмотров на планшетах или игровых консолях.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Операционная система
В этом отчете собрана статистика просмотров на основе операционных систем пользователей. Например, в нем указано количество просмотров, совершенных на устройствах Android или PlayStation.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Операционная система и тип устройства
В этом отчете собрана сводная статистика просмотров на основе операционных систем и типов устройств пользователей. Например, в нем указано количество просмотров, совершенных на планшетах Android или на настольных компьютерах Windows.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Демографические данные зрителей
В этом отчете собраны статистические данные о просмотрах с учетом возрастных групп и пола зрителей.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Примечание: Значения
viewerPercentage в этом отчете не нормализованы для различных значений параметра
subscribedStatus, описывающего детализацию воспроизведения.
Например, если в отчете используется измерение
subscribedStatus , то он возвращает данные
viewerPercentage, суммарно равные 100 процентам для подписанных просмотров
и данным
viewerPercentage , суммарно равным 100 процентам для неподписанных просмотров. (Суммовое значение всех полей
viewerPercentage в отчете составляет 200 процентов.)
Вы можете использовать фильтры, чтобы гарантировать, что отчет будет содержать данные
viewerPercentage только для одного значения измерения
subscribedStatus .
Вовлеченность и обмен контентом
В этом отчете представлены статистические данные, показывающие, как часто видеоролики канала распространялись на различных социальных платформах.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | shares |
|
| Фильтры: | |
Удержание аудитории
В этом отчете оценивается способность видео удерживать аудиторию. Показатель elapsedVideoTimeRatio измеряет прошедшее время до истечения соответствующих значений метрики. Показатели audienceWatchRatio и relativeRetentionPerformance предоставляют два измерения, демонстрирующих, насколько хорошо видео удерживает аудиторию. Первое — это абсолютное значение, а второе показывает, как видео работает по сравнению с другими видео на YouTube аналогичной длины.
Примечание: Отчеты по удержанию аудитории не поддерживают возможность указания списка значений, разделенных запятыми, для video ; значение должно содержать один идентификатор видео.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Лучшие видео
Примечание: Для создания этих отчетов необходимо установить параметр maxResults на целое число, равное 200 или меньше. Данные за период до 1 января 2013 года доступны только для 10 самых популярных видеороликов. В отличие от большинства других отчетов, для этих отчетов также необходимо указать значение параметра запроса sort .
Лучшие видеоролики в целом, по странам, по континентам или по субконтинентам (<= 200 результатов)
В этом отчете представлен список лучших видеороликов владельца контента, отобранных на основе указанных критериев фильтрации и сортировки.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 * |
|
| Фильтры: | |
| Параметры сортировки: | - engagedViews
- views
- redViews
- estimatedRevenue
- estimatedRedPartnerRevenue
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- subscribersGained
- subscribersLost |
Лучшие видеоролики по штатам США (<= 200 результатов)
В этом отчете перечислены самые популярные видеоролики владельца контента в конкретном штате США или округе Колумбия. Обратите внимание, что этот отчет поддерживает только часть показателей, доступных в отчете по отдельным странам, описанном выше.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| Фильтры: | |
| Параметры сортировки: | - engagedViews
- views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched |
Лучшие видео для подписчиков и отписавшихся зрителей (<= 200 результатов)
В этом отчете перечислены самые популярные видео для подписчиков и отписавшихся пользователей. Отчет можно отфильтровать по стране , континенту или субконтиненту . Предыдущий отчет позволял получить список самых популярных видео в конкретном штате США для подписчиков и отписавшихся пользователей, но он поддерживал меньше метрик, чем этот отчет.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 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 |
|
| Фильтры: | |
| Параметры сортировки: | - engagedViews
- views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched |
Лучшие видеоролики по продуктам YouTube (<= 200 результатов)
В этом отчете перечислены самые популярные видеоролики, а также поддерживаются фильтры по детализации воспроизведения и географические фильтры. Этот отчет похож на предыдущий, но поддерживает меньшее количество метрик и добавлена поддержка фильтра youtubeProduct .
Лучшие видеоролики с фильтрами детализации воспроизведения (<= 200 результатов)
В этом отчете перечислены самые популярные видеоролики владельца контента, отфильтрованные по одному или нескольким параметрам воспроизведения: liveOrOnDemand , subscribedStatus и youtubeProduct . Отчет также поддерживает фильтрацию по региону.
Отчеты по плейлистам
Отчеты по плейлистам содержат метрики, связанные с активностью пользователей при просмотре видео в плейлистах владельца канала. Доступны две версии этих отчетов, и для каждого доступного отчета в следующих разделах приведено описание каждой версии:
Сводные видеометрики
Эти метрики предоставляют данные об активности пользователей и показах, которые агрегируются для всех видео в плейлисте, принадлежащих также каналу, которому принадлежит этот плейлист. Метрики для видео, принадлежащих другим каналам, не учитываются при агрегировании. В результате, если канал создает плейлист, содержащий только видео, принадлежащие другим каналам, отчеты по этим плейлистам не будут содержать значений для этих метрик.
Список поддерживаемых YouTube показателей агрегированных видеометрик см. в разделе «Поддерживаемые метрики плейлистов» .
Показатели внутри плейлиста
Эти показатели отражают активность и вовлеченность пользователей в контексте страницы плейлиста. В них включены просмотры всех видео в плейлисте, независимо от того, какому каналу они принадлежат, но учитываются только просмотры, произошедшие в контексте плейлиста.
Поддерживаемые метрики плейлистов
Основные статистические данные
Данный отчет содержит статистические данные о взаимодействии пользователей с видеороликами в плейлистах на каналах владельца контента. Для составления отчета не требуется указывать какие-либо обязательные параметры.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| Фильтры: | |
на основе времени
Этот отчет содержит статистические данные о взаимодействии пользователей с видеороликами в плейлистах каналов владельца контента за определенные временные интервалы. Вы можете отфильтровать отчет, чтобы получить данные только для конкретного плейлиста или канала.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| Фильтры: | |
география пользователя
В этом отчете представлены статистические данные о взаимодействии пользователей из определенной страны с видеороликами в плейлистах канала.
В этом отчете представлена статистика плейлистов по странам.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Активность плейлистов по провинциям
В этом отчете представлена статистика активности плейлистов для штатов США и округа Колумбия. Для создания этого отчета необходимо указать country==US в значении параметра filters .
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Места воспроизведения
В этом отчете представлены статистические данные, касающиеся типа страницы или приложения, где происходило воспроизведение плейлистов.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Подробная информация о месте воспроизведения (<= 25 результатов)
Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .
В этом отчете определены встроенные видеоплееры, которые обеспечили наибольшее количество просмотров или времени просмотра плейлистов владельца контента.
Источники трафика
Этот отчет обобщает статистику просмотров в зависимости от способа, которым зрители попали на контент вашего плейлиста. Например, он определяет количество просмотров, которые произошли из поиска Google или со страницы канала.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| Фильтры: | |
Подробная информация об источнике трафика (<= 25 результатов)
Примечание: Для этого отчета необходимо установить параметр maxResults в виде целого числа, равного 25 или меньше. В отличие от большинства других отчетов, для этого отчета также необходимо указать значение параметра запроса sort .
В этом отчете собрана статистика просмотров на основе источников переходов, которые сгенерировали наибольшее количество просмотров для плейлистов владельца контента. Источники переходов классифицируются по типу трафика, а определение параметра insightTrafficSourceDetail указывает источники трафика, для которых доступен отчет. Например, если вы установите фильтр insightTrafficSourceType в значение ADVERTISING , в отчете будут перечислены типы объявлений, которые сгенерировали наибольшее количество просмотров или времени просмотра для плейлистов владельца контента.
| Содержание |
|---|
| Размеры: | |
| Показатели: | | Используйте 1 или более | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| Фильтры: | |
| Параметры сортировки: | - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts |
Примечание: Данный отчет поддерживается только для определенных источников трафика. Источники трафика VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES и NO_LINK_EMBEDDED относятся к числу неподдерживаемых.
Тип устройства и операционная система
Тип устройства для плейлистов
В этом отчете собрана статистика просмотров в зависимости от типа устройства, которое зрители использовали для просмотра контента вашего плейлиста. Например, в нем указывается количество просмотров, совершенных на мобильных устройствах или игровых консолях.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Операционная система для плейлистов
В этом отчете собрана статистика просмотров на основе операционных систем пользователей. Например, в нем указано количество просмотров плейлистов, произошедших на устройствах Android или PlayStation.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Операционная система и тип устройства для плейлистов
В этом отчете собрана сводная статистика просмотров на основе операционных систем и типов устройств пользователей. Например, в нем указано количество просмотров плейлистов, произошедших на планшетах Android или на настольных компьютерах Windows.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Демографические данные зрителей
В этом отчете собраны статистические данные о просмотрах с учетом возрастных групп и пола зрителей.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
Примечание: Значения
viewerPercentage в этом отчете не нормализованы для различных значений или комбинаций значений параметров детализации воспроизведения (
subscribedStatus и
youtubeProduct ).
Например, отчет, использующий измерение
subscribedStatus, возвращает данные
viewerPercentage, суммарно равные 100 процентам для просмотров, на которые оформлена подписка
, и данные
viewerPercentage , суммарно равные 100 процентам для просмотров, на которые подписка не оформлена. (Общая сумма значений всех полей
viewerPercentage в отчете составляет 200 процентов.)
Вы можете использовать фильтры, чтобы гарантировать, что отчет будет содержать данные
viewerPercentage только для одного значения (или комбинации значений) по параметрам детализации воспроизведения.
Лучшие плейлисты
Примечание: Для создания этих отчетов необходимо установить параметр maxResults на целое число, равное 200 или меньше. Данные за период до 1 января 2013 года доступны только для 10 лучших плейлистов. В отличие от большинства других отчетов, для этих отчетов также необходимо указать значение параметра запроса sort .
В этом отчете представлен список самых популярных плейлистов владельца контента, составленный на основе указанных критериев фильтрации и сортировки.
Примечание: Для отчетов об эффективности рекламы требуется токен авторизации, предоставляющий доступ к области действия https://www.googleapis.com/auth/yt-analytics-monetary.readonly .
Отчеты об эффективности рекламы предоставляют метрики, основанные на показах, для объявлений, которые демонстрировались во время воспроизведения видео. Эти метрики учитывают каждый показ объявления, а каждое воспроизведение видео может привести к нескольким показам.
Показатели эффективности рекламы, основанные на количестве показов, включают в себя:
Кроме того, некоторые отчеты по видеоконтенту поддерживают следующие показатели эффективности рекламы, основанные на воспроизведении. Однако эти показатели не включаются в отчеты об эффективности рекламы.
| Содержание |
|---|
| Размеры: | |
| Показатели: | |
| Фильтры: | |
