Dimensions

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

Параметры – это общие критерии, которые используются для агрегирования данных, например дата, когда произошло действие пользователя, или страна, в которой он находился.

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

Чтобы получить отчет, вызовите метод reports.query YouTube Analytics API. В запросе используйте параметр dimensions, чтобы указать параметры, которые YouTube будет использовать для расчета значений показателей в отчетах.

Основные параметры

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

Ниже перечислены основные параметры API.

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

Фильтры

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

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

Важно! Запросы к API для получения отчетов владельца контента должны фильтровать данные с помощью одного из параметров объекта отчета или поддерживаемого сочетания параметров claimedStatus и uploaderType.

Размеры

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

Ресурсы

Эти параметры соответствуют ресурсам, которыми управляют каналы и владельцы контента на YouTube:

Примечание. API позволяет указывать несколько значений для параметров video, playlist и channel, когда они используются в качестве фильтров. Для этого в качестве значения параметра filters укажите разделенный запятыми список идентификаторов видео, плейлистов или идентификаторов каналов, для которых нужно отфильтровать ответ API. В значении параметра можно указать до 500 идентификаторов.

video (основной параметр)
Идентификатор видео YouTube. В YouTube Data API это значение свойства id ресурса video. This is a core dimension and is subject to the Deprecation Policy.
плейлист
Идентификатор плейлиста YouTube. В YouTube Data API это значение свойства id ресурса playlist.
channel (основной параметр) (используется только в отчетах для владельцев контента)
Идентификатор канала YouTube. В YouTube Data API это значение свойства id ресурса channel. This is a core dimension and is subject to the Deprecation Policy.

Параметр channel часто используется в отчетах владельца контента, поскольку в них обычно агрегируются данные по нескольким каналам.
group (только фильтр)
Идентификатор группы в YouTube Аналитике. Это значение можно получить с помощью метода groups.list YouTube Analytics API. Если вы используете фильтр group, ответ API содержит данные обо всех видео, плейлистах или каналах в этой группе.

Примеры

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

  • Примеры каналов

    • Базовая статистика
      • Топ-10 – самые популярные видео на канале
      • Топ-10 – CTR аннотаций для самых популярных видео на канале
      • Статистика по определенному плейлисту
      • Топ-10 – самые популярные плейлисты на канале
    • Геотаргетинг
      • Топ-10 – самые популярные видео в определенной стране.
      • Топ-10 самых популярных видео в Европе

  • Примеры владельцев контента

    • Базовая статистика
      • Топ-10 самых популярных видео владельца контента
      • Топ-10 самых популярных видео владельца контента
      • Топ-10 самых популярных видео на канале владельца контента
      • Топ-10 – CTR аннотаций для самых популярных видео на канале
      • Топ-10 самых популярных плейлистов владельца контента
    • Геотаргетинг
      • Топ-10 самых популярных видео владельца контента в Европе
      • Топ-10 плейлистов, которые чаще всего включают в США

Географические области

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

country (основной параметр)
Страна, связанная с показателями в строке отчета. Значение параметра – двухбуквенный код страны по стандарту ISO-3166-1, например US, CN (Китай) или FR (Франция). Код страны ZZ используется для отчетных показателей, для которых YouTube не удалось определить связанную страну. This is a core dimension and is subject to the Deprecation Policy.
province
Штат или территория США, к которым относятся показатели в строке отчета. Значение параметра – это код ISO 3166-2, который идентифицирует штат США или округ Колумбия, например US-MI (Мичиган) или US-TX (Техас). Код провинции US-ZZ используется для отчетных показателей, для которых YouTube не удалось определить связанный штат США. Если запрос к API содержит province в значении параметра dimensions, то в нем также должно быть ограничение данных по США, то есть country==US в значении параметра filters.

Примечание. Этот параметр не поддерживает значения ISO 3166-2, которые идентифицируют внешние малые острова США, поскольку у этих территорий также есть собственные коды стран ISO 3166-1. Кроме того, не поддерживаются регионы других стран, кроме США.

dma
Трехзначный идентификатор, который компания Nielsen использует для обозначения медиарынка, связанного с событиями просмотра, описанными в строке данных.
city
Расчетный город, связанный с показателями в строке отчета. Данные по этому параметру доступны с 1 января 2022 г.
continent (только фильтр)
Код региона по классификации ООН. API поддерживает следующие значения:
Значение Описание
002 Африка
019 Северная и Южная Америка (Северная Америка, Латинская Америка, Южная Америка и Карибский бассейн)
142 Азия
150 Европа
009 Океания
Этот параметр можно использовать только для фильтрации данных. Чтобы использовать этот параметр, задайте для параметра filters значение continent==REGION_CODE, указав значение REGION_CODE из таблицы.
subContinent (только фильтр)
Код статистического региона ООН, который идентифицирует географический субрегион. Список субрегионов и стран, которые к ним относятся, можно найти на сайте Статистического отдела ООН.

Этот параметр можно использовать только для фильтрации данных. Чтобы использовать этот параметр, задайте для параметра filters значение subContinent==REGION_CODE, указав значение REGION_CODE из списка ООН.

Примеры

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

  • Примеры каналов

    • Базовая статистика. Количество просмотров канала в разных странах и другие данные.
    • Геотаргетинг
      • Показатели времени просмотра видео на канале по странам
      • Показатели аннотаций в видео на канале с разбивкой по странам
      • Показатели по штатам США и округу Колумбия.
      • Время просмотра плейлистов канала по странам
      • Топ-10 плейлистов, которые чаще всего включают в США
    • Место воспроизведения. Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
    • Источник трафика. Количество просмотров и время просмотра из разных источников трафика в стране.
    • Демографические данные. Демографические данные зрителей в Калифорнии (возрастная группа и пол).
    • Самые популярные видео
      • Топ-10 – самые популярные видео в определенной стране.
      • Топ-10 самых популярных видео в Европе

  • Примеры владельцев контента

    • Базовая статистика. Число просмотров по странам и другие данные обо всех загруженных вами видео.
    • Геотаргетинг
      • Показатели времени просмотра загруженного вами контента по странам
      • Показатели аннотаций для самостоятельно загруженного контента с разбивкой по странам
      • Показатели по штатам США и округу Колумбия.
      • Показатели времени просмотра плейлистов владельца контента с разбивкой по странам.
      • Топ-10 плейлистов, которые чаще всего включают в США
    • Место воспроизведения. Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
    • Демографические данные. Демографические данные зрителей в Калифорнии (возрастная группа и пол).
    • Лучшие видео. Топ-10 самых популярных видео владельца контента в Европе.
    • Доход/эффективность рекламы. Показатели дохода и эффективности рекламы по странам.

Периоды

Эти параметры указывают, что в отчете должны быть агрегированы данные за определенный период времени, например за день, неделю или месяц. Параметры запроса startDate и endDate определяют период времени, за который в отчет включаются данные. Обратите внимание, что в отчете будут представлены данные за период до последнего дня, за который на момент выполнения запроса доступны все указанные в нем показатели. В отчетах даты указываются в формате YYYY-MM-DD.

Важно! Все даты относятся к периоду времени, который начинается в 00:00 по тихоокеанскому времени (UTC-7 или UTC-8) и заканчивается в 23:59 по тихоокеанскому времени в указанный день, месяц и год. В результате дни, когда часы переводятся вперед на летнее время, длятся 23 часа, а дни, когда часы переводятся назад, – 25 часов.

Параметр Месяц относится к периоду времени, который начинается в 00:00 по тихоокеанскому времени (UTC-7 или UTC-8) в первый день указанного месяца и года.

day (основной параметр)
При использовании этого параметра данные в отчете агрегируются по дням, и каждая строка содержит данные за один день. Чтобы получить более подробные данные, можно использовать другие параметры. Например, в отчете об источниках трафика можно объединить ежедневную статистику просмотров в зависимости от того, как пользователи находят ваши видео. This is a core dimension and is subject to the Deprecation Policy.
month (основной параметр)
Данные в отчете агрегируются по календарным месяцам. Как и в случае с ежедневными отчетами, вы можете использовать другие фильтры для дальнейшей сегментации данных. В отчете даты указаны в формате YYYY-MM.

Примечание. Если в запросе API используется параметр month, то в параметрах start-date и end-date должен быть указан первый день месяца. This is a core dimension and is subject to the Deprecation Policy.

Примеры

В следующих примерах запросов используются временные параметры или фильтры:

  • Примеры каналов

    • На основе времени
      • Ежедневное время просмотра видео на канале
      • Ежедневная статистика по аннотациям в видео на канале
      • Ежедневные просмотры плейлистов на канале
    • Место воспроизведения. Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
    • Источник трафика. Ежедневное количество просмотров и время просмотра из разных источников трафика.
    • Устройство/ОС
      • Ежедневные показатели по типам устройств для операционной системы Android
      • Ежедневные показатели операционной системы для мобильных устройств
      • Ежедневные показатели по операционным системам и типам устройств

  • Примеры владельцев контента

    • На основе времени
      • Ежедневные показатели времени просмотра для загруженного вами контента
      • Показатели аннотаций для контента, на который заявлены права
      • Ежедневное количество просмотров плейлистов для владельца контента
    • Место воспроизведения. Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
    • Источник трафика. Ежедневное количество просмотров и время просмотра из разных источников трафика.
    • Устройство/ОС
      • Ежедневные показатели по типам устройств для видео, на которые заявлены права
      • Ежедневная статистика по операционным системам, на которых пользователи мобильных устройств смотрели видео, на которые заявлены права.
      • Ежедневные показатели по операционным системам и типам устройств
    • Доход/эффективность объявлений. Ежедневный доход и показатели эффективности объявлений.

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

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

insightPlaybackLocationType
Данные в отчете агрегируются по типу страницы или приложения, где воспроизводились видео. Возможные значения:

  • BROWSE – данные о просмотрах на главной странице YouTube, в фиде подписок или в других разделах YouTube.

  • CHANNEL – данные о просмотрах на странице канала.

  • EMBEDDED – данные о просмотрах на других сайтах или в приложениях, где видео было встроено с помощью тега <iframe> или <object>.

  • EXTERNAL_APP – данные о просмотрах в стороннем приложении, в котором видео воспроизводилось не через встроенный проигрыватель <iframe> или <object>. Например, это значение будет присвоено воспроизведениям в приложениях, использующих YouTube Android Player API.

  • IMMERSIVE_LIVE_FEED – данные о просмотрах в ленте вертикальных трансляций.

  • MOBILE – данные о просмотрах на мобильном сайте YouTube или в одобренных API-клиентах YouTube, в том числе на мобильных устройствах.

    С 10 сентября 2013 года воспроизведения больше не классифицируются как MOBILE в отчетах YouTube Аналитики. Это значение может остаться в отчетах, поскольку устаревшие данные по-прежнему относятся к этой категории. После этой даты просмотры на мобильных устройствах классифицируются как WATCH, EMBEDDED или EXTERNAL_APP в зависимости от типа приложения, в котором они происходят.

  • SEARCH – просмотры, которые произошли непосредственно на странице результатов Поиска на YouTube.

  • SHORTS_FEED – данные о просмотрах в ленте YouTube Shorts.

  • WATCH – данные о просмотрах на странице просмотра видео на YouTube или в официальном приложении YouTube, например в приложении YouTube для Android.

  • YT_OTHER – данные о просмотрах, которые не относятся к другим категориям.

insightPlaybackLocationDetail
Данные агрегируются на основе страницы, на которой находится проигрыватель. Обратите внимание, что этот отчет поддерживается только для просмотров во встроенных проигрывателях. В нем указываются встроенные проигрыватели, которые сгенерировали больше всего просмотров для указанного видео. Таким образом, он предоставляет более подробную информацию, чем отчет о местоположениях, определяя URL-адреса или приложения, связанные с основными встроенными проигрывателями.

Примеры

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

  • Примеры каналов

    • Место воспроизведения
      • Количество просмотров и время просмотра в разных местах воспроизведения
      • Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
      • Топ-10 сторонних сайтов, на которых встроенное видео набрало больше всего просмотров.
      • Число просмотров и время просмотра плейлиста в разных местах воспроизведения.
      • Ежедневное число просмотров плейлистов и время просмотра на разных платформах.

  • Примеры владельцев контента

    • Место воспроизведения
      • Количество просмотров и время просмотра в разных местах воспроизведения
      • Ежедневное число просмотров и время просмотра в разных местах воспроизведения.
      • Топ-10 сторонних сайтов, на которых встроенное видео набрало больше всего просмотров.
      • Число просмотров и время просмотра плейлиста в разных местах воспроизведения.
      • Ежедневное число просмотров плейлистов и время просмотра на разных платформах.

Сведения о воспроизведении

creatorContentType
Этот параметр определяет тип контента, связанного с показателями действий пользователя в строке данных. Данные для этого параметра доступны с 1 января 2019 г.

В таблице ниже перечислены значения параметра.
Значение Описание
LIVE_STREAM Просмотренный контент был трансляцией на YouTube.
SHORTS Просмотренный контент – это видео YouTube Shorts.
STORY Пользователь посмотрел сюжет.
VIDEO_ON_DEMAND Просмотренный контент – это видео YouTube, которое не относится ни к одному из других значений параметра.
UNSPECIFIED Тип просмотренного контента неизвестен.
liveOrOnDemand
Этот параметр указывает, связаны ли показатели действий пользователя в строке данных с просмотрами прямой трансляции. Данные по этому параметру доступны с 1 апреля 2014 г.

В таблице ниже перечислены значения параметра.
Значение Описание
LIVE Данные в строке описывают действия пользователя во время прямой трансляции.
ON_DEMAND Данные в строке описывают действия пользователя, которые не происходили во время прямой трансляции.
subscribedStatus
Этот параметр показывает, связаны ли показатели действий пользователей в строке данных со зрителями, которые подписаны на канал, где размещено видео или плейлист. Допустимые значения: SUBSCRIBED и UNSUBSCRIBED.

Обратите внимание, что значение параметра точно отражает время, когда произошло действие пользователя. Например, пользователь, не подписанный на канал, смотрит одно из его видео, затем подписывается на канал и смотрит другое видео в тот же день. В отчете по каналу указано, что у одного просмотра значение subscribedStatus равно SUBSCRIBED, а у другого – subscribedStatusUNSUBSCRIBED.
youtubeProduct
Этот параметр позволяет определить, в каком сервисе YouTube было выполнено действие пользователя. Данные по этому параметру доступны с 18 июля 2015 г.

В таблице ниже перечислены значения параметра.
Значение Описание
CORE Действия пользователя, которые не выполнялись в одном из специализированных приложений YouTube (YouTube Гейминг, YouTube Детям или YouTube Music). Исключение: действия пользователей в YouTube Music до 1 марта 2021 года включены в CORE.
GAMING Действия пользователя в YouTube Гейминге.
KIDS Действия пользователя в YouTube Детям.
MUSIC Действия пользователя в YouTube Music были совершены 1 марта 2021 года или позже. Данные до 1 марта 2021 г. включены в CORE. Данные в реальном времени не записываются.
UNKNOWN Действия пользователя были выполнены до 18 июля 2015 года.

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

insightTrafficSourceType
Данные в отчете агрегируются по типу источника трафика, который описывает, как пользователи перешли к видео. Возможные значения этого параметра:
  • ADVERTISING – зритель перешел к видео по ссылке в объявлении. Если вы отфильтруете данные по этому источнику трафика, то в поле insightTrafficSourceDetail будет указан тип объявления.
  • ANNOTATION – зрители перешли к видео, нажав на аннотацию в другом ролике.
  • CAMPAIGN_CARD – просмотры, полученные благодаря пользовательским видео, на которые заявлены права и которые владелец контента использовал для продвижения. Этот источник трафика поддерживается только в отчетах для владельцев контента.
  • END_SCREEN – просмотры, полученные благодаря конечной заставке в другом видео.
  • EXT_URL – просмотры видео, на которое пользователь перешел по ссылке на другом сайте. Если вы отфильтруете данные по этому источнику трафика, то в поле insightTrafficSourceDetail будет указана веб-страница. К этому источнику трафика относятся переходы из результатов поиска Google.
  • HASHTAGS – просмотры со страниц хештегов видео по запросу или страниц Shorts с этим треком.
  • LIVE_REDIRECT – просмотры видео, полученные благодаря live-редиректу.
  • NO_LINK_EMBEDDED – видео было встроено на сторонний сайт.
  • NO_LINK_OTHER – YouTube не удалось определить источник трафика. В эту категорию входит прямой трафик на страницу видео, а также трафик из мобильных приложений.
  • NOTIFICATION – просмотры видео, на которое пользователь перешел по ссылке из электронного письма или уведомления от YouTube.
  • PLAYLIST – просмотры видео, которое воспроизводилось в составе плейлиста. Сюда относится трафик со страницы плейлиста.
  • PRODUCT_PAGE – просмотры видео, на которые пользователи перешли со страницы товара.
  • PROMOTED – просмотры видео, полученные в результате бесплатного продвижения на YouTube, например на странице "Популярные видео".
  • RELATED_VIDEO – просмотры видео, которые были получены благодаря его показу в списке похожих видео на странице просмотра другого ролика. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указан идентификатор видео.
  • SHORTS – зритель перешел к видео, пролистав ленту Shorts.
  • SOUND_PAGE – просмотры со страниц Shorts с этим треком.
  • SUBSCRIBER – просмотры видео, которые были запущены из фидов на главной странице YouTube или из фида подписок. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будут указаны элементы фида на главной странице или другие страницы, с которых были получены просмотры.
  • YT_CHANNEL – просмотры видео на странице канала. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указан идентификатор канала.
  • YT_OTHER_PAGE – просмотры видео, которые были получены по ссылке, не относящейся к результатам поиска или похожим видео на YouTube. Если вы отфильтруете данные по этому источнику трафика, поле insightTrafficSourceDetail будет указывать на страницу.
  • YT_SEARCH – просмотры видео, которые были получены из результатов поиска на YouTube. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указан поисковый запрос.
  • VIDEO_REMIXES – просмотры, полученные по ссылке на использованный фрагмент видео в проигрывателе Shorts. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указано видео, с которого был выполнен переход.
  • WATCH_WITH – просмотры видео, полученные благодаря стриму с комментариями автора или совместному просмотру. Если вы отфильтруете данные по этому источнику трафика, в поле insightTrafficSourceDetail будет указано видео, с которого был выполнен переход.
insightTrafficSourceDetail
Данные в отчете агрегируются на основе рефереров, которые сгенерировали больше всего просмотров для указанного видео и типа источника трафика. Ниже перечислены источники трафика, для которых доступен этот отчет. Для каждого источника трафика в списке указана информация, которую предоставляет параметр insightTrafficSourceDetail.
  • ADVERTISING – тип объявления, которое привело к просмотрам. Возможные значения:
    • Объявление, ориентированное на взаимодействие, с воспроизведением по клику
    • Объявление, ориентированное на взаимодействие
    • Поисковые объявления Google
    • Видеореклама на главной странице
    • Объявления Freewheel Reserved в формате In-Stream с возможностью пропуска
    • TrueView In-Search и In-Display
    • TrueView In-Stream
    • Реклама на YouTube без категории
    • Видеостена
  • CAMPAIGN_CARD – видео, на которое заявлены права и которое привело зрителей к видео, указанному в отчете.
  • END_SCREEN – видео, после которого зрители перешли к просмотру видео, указанного в отчете.
  • EXT_URL – сайт, с которого зрители перешли к видео.
  • HASHTAGS – хештег, который привел к просмотрам.
  • NOTIFICATION – электронное письмо или уведомление, которое привело к переходу.
  • RELATED_VIDEO – похожие видео, из которых зрители перешли к видео, указанному в отчете.
  • SOUND_PAGE – видео, которое привело к просмотрам.
  • SUBSCRIBER – элемент фида на главной странице или функция подписки на YouTube, которая привела зрителей к видео, указанному в отчете. Допустимые значения:
    • activity – просмотры, полученные от различных объектов в фидах подписок на главные страницы. Относится к просмотрам, не связанным с загрузкой видео или социальными действиями (это, например, нажатие кнопки "Нравится", добавление в избранное или плейлист, а также публикация новости).
    • blogged – просмотры объектов в фидах подписки на главные страницы, полученные от ссылок в популярных блогах.
    • mychannel – просмотры из других фидов на главной странице, например "Понравилось", "История просмотра" и "Смотреть позже".
    • podcasts – просмотры, выполненные со страницы подкастов.
    • sdig – просмотры, полученные благодаря письмам с обновлениями подписок.
    • uploaded – просмотры из uploaded объектов в фидах подписки на главные страницы.
    • / – другие просмотры, полученные с главной страницы YouTube.
    • /my_subscriptions – просмотры, полученные со страницы Мои подписки на YouTube.
  • YT_CHANNEL – страница канала, на которой зрители смотрели видео.
  • YT_OTHER_PAGE – страница YouTube, с которой зрители перешли к видео.
  • YT_SEARCH – поисковый запрос, по которому зрители нашли видео.
  • VIDEO_REMIXES – видео, которое привело к просмотрам.
  • WATCH_WITH – видео, которое привело к просмотрам.

Примеры

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

  • Примеры каналов

    • Источник трафика
      • Количество просмотров и время просмотра из разных источников трафика в стране
      • Ежедневное число просмотров и время просмотра из разных источников трафика.
      • Топ-10 поисковых запросов на YouTube, которые приносят видео больше всего трафика
      • Топ-10 поисковых запросов в Google Поиске, которые приносят видео больше всего трафика.
      • Количество просмотров плейлиста и время просмотра из разных источников трафика в стране.
      • Ежедневное число просмотров плейлиста и время просмотра из разных источников трафика.

  • Примеры владельцев контента

    • Источник трафика
      • Количество просмотров и время просмотра из разных источников трафика.
      • Ежедневное число просмотров и время просмотра из разных источников трафика.
      • Топ-10 поисковых запросов на YouTube, которые приносят видео больше всего трафика
      • Топ-10 поисковых запросов в Google Поиске, которые приносят видео больше всего трафика.
      • Количество просмотров плейлиста и время просмотра из разных источников трафика в стране.
      • Ежедневное число просмотров плейлиста и время просмотра из разных источников трафика.

Устройства

deviceType
Этот параметр позволяет определить размеры устройства, на котором выполняется воспроизведение. Ниже перечислены типы устройств, для которых API возвращает данные. Вы также можете использовать параметр deviceType в качестве фильтра, чтобы в отчете об операционных системах содержались данные только по определенному типу устройств.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
Этот параметр позволяет узнать, на устройствах с какими операционными системами пользователи смотрели ваши видео. Ниже перечислены операционные системы, для которых API возвращает данные. Вы также можете использовать operatingSystem в качестве фильтра, чтобы в отчете по типам устройств содержались данные только для определенной операционной системы.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Примеры

В следующих примерах запросов используются параметры устройств:

  • Примеры каналов

    • Устройство/ОС
      • Ежедневные показатели по типам устройств для операционной системы Android
      • Ежедневные показатели операционной системы для мобильных устройств
      • Ежедневные показатели по операционным системам и типам устройств
      • Ежедневные показатели просмотров плейлистов на устройствах с операционной системой Android.
      • Ежедневные показатели операционных систем для просмотров плейлистов на мобильных устройствах

  • Примеры владельцев контента

    • Устройство/ОС
      • Ежедневные показатели по типам устройств для видео, на которые заявлены права
      • Ежедневная статистика по операционным системам, на которых пользователи мобильных устройств смотрели видео, на которые заявлены права.
      • Ежедневные показатели по операционным системам и типам устройств
      • Ежедневные показатели просмотров плейлистов на устройствах с операционной системой Android.
      • Ежедневные показатели операционных систем для просмотров плейлистов на мобильных устройствах

Демография

Демографические параметры позволяют узнать возрастной диапазон и пол аудитории. Дополнительную информацию о демографических данных в отчетах YouTube Analytics можно найти в Справочном центре YouTube.

ageGroup (основной параметр)
Этот параметр позволяет узнать возрастную группу вошедших в аккаунт пользователей, связанных с данными отчета, и включает пользователей, которым, по оценкам YouTube, меньше 18 лет. В API используются следующие возрастные группы:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
Пол (основной параметр)
Этот параметр позволяет определить пол вошедших в аккаунт пользователей, связанных с данными отчета. Допустимые значения: female, male и user_specified. This is a core dimension and is subject to the Deprecation Policy.

Примеры

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

  • Примеры каналов

    • Демографические данные
      • Демографические данные зрителей в Калифорнии (возрастная группа и пол)
      • Демографические данные зрителей плейлистов в Калифорнии (возрастная группа и пол)

  • Примеры владельцев контента

    • Демографические данные
      • Демографические данные зрителей в Калифорнии (возрастная группа и пол)
      • Демографические данные зрителей плейлистов в Калифорнии (возрастная группа и пол)

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

sharingService (основной параметр)
Этот параметр позволяет определить, через какой сервис пользователи делились видео. Чтобы поделиться видео на YouTube или через проигрыватель YouTube, нажмите кнопку "Поделиться". This is a core dimension and is subject to the Deprecation Policy.

В таблице ниже перечислены допустимые значения параметров.
где поделились; Значение API
Allo ALLO
Ameba AMEBA
Android Email; ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Обмен сообщениями на Android ANDROID_MMS
Диалоговое окно системы Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
Получить реакцию BLIND_REACT
Blogger BLOGGER
Копировать в буфер обмена COPY_PASTE
Cyworld CYWORLD
Digg; DIGG
Диалоговое окно действий в системе DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
Показанный QR-код DISPLAYED_QR_CODE
Dropbox DROPBOX
Встраивание EMBED
Электронная почта MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Страницы Facebook FACEBOOK_PAGES
Поделиться в группе Facebook FACEBOOK_SHARE_TO_GROUP
Facebook Stories FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
Goo GOO
Приложение Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Текстовое сообщение HTC HTC_MMS
ИМХО IMO
Instagram INSTAGRAM
Instagram Stories INSTAGRAM_STORIES
Ссылка для приглашения (Android) INVITE_LINK_ANDROID
Ссылка для приглашения (iOS) INVITE_LINK_IOS
Как пригласить соавторов плейлиста INVITE_PLAYLIST_COLLABORATORS
Диалоговое окно активности системы iOS IOS_SYSTEM_ACTIVITY_DIALOG
KakaoStory KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Сообщения KaiOS KAIOS_MESSAGES
Kik KIK
LGE Email LGE_EMAIL
График LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Копирование и вставка в Картах MAPS_COPY_PASTE
Показ приложения в Meet MEET_LIVE_SHARING
Menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Обмен с окружением NEARBY_SHARE
NUjij NUJIJ
Одноклассники ODNOKLASSNIKI
Другое OTHER
Pinterest PINTEREST
Быстрая отправка QUICK_SHARE
Быстрая отправка (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Ремикс REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
Сохранить изображение на устройстве SAVE_TO_DEVICE_PHOTOS
Поделиться без рекламы SHARE_AD_FREE
Отправить в Snapchat SHARE_TO_SNAPCHAT_CAMERA
Поделиться с детьми SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
Tumblr. TUMBLR
Твиттер TWITTER
Неизвестно UNKNOWN
Verizon Messages VERIZON_MMS
Viber VIBER
ВКонтакте VKONTAKTE
Диалоговое окно "Действия в системе" WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! Japan YAHOO
Публикация в сообществе YouTube YOUTUBE_COMMUNITY_POST
Репост на вкладке "Сообщество" YOUTUBE_COMMUNITY_REPOST
YouTube Гейминг YOUTUBE_GAMING
YouTube Детям YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
Предпросмотр отправки контента из YouTube Music в Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEW
Зеленый экран в YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
Совместный просмотр YouTube YOUTUBE_WATCH_WITH_FRIENDS

Дополнительную информацию можно найти в Справочном центре.

Примеры

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

  • Примеры каналов

  • Примеры владельцев контента

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

elapsedVideoTimeRatio
Этот параметр указывает на соотношение просмотренной части видео к его общей продолжительности. Параметры и показатели удержания используются для оценки удержания аудитории с течением времени, а параметр elapsedVideoTimeRatio – для измерения времени. Например, значение 0.4 указывает, что в отчете представлены данные об удержании аудитории после просмотра 40 % видео.

API возвращает 100 элементов данных для каждого видео со значениями коэффициента от 0.01 до 1.0. Данные собираются через равные промежутки времени. Это значит, что для двухминутного видео интервал между точками данных составляет 1,2 секунды. а для двухчасового видео интервал между элементами данных составляет 72 секунды. Значение параметра обозначает конец интервала, не включенный в него.
audienceType (только фильтр)
Значение параметра определяет тип трафика, связанного с данными отчета. Допустимые значения: ORGANIC, AD_INSTREAM и AD_INDISPLAY. Подробную информацию о типах источников трафика можно найти в Справочном центре YouTube.

Обратите внимание, что данные для фильтра audienceType доступны с 25 сентября 2013 г. API не возвращает данные по запросам, в которых фильтр используется для получения данных за более ранние даты. Запросы, в которых не используется фильтр, работают для любой даты после 1 июля 2008 г.

Примеры

В следующих примерах запросов используются параметры удержания аудитории:

Прямые трансляции

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

количество отказов от подписки;

membershipsCancellationSurveyReason
Количество опросов, пройденных пользователями YouTube, которые отменили спонсорство на указанном канале в течение отчетного периода. В таблице ниже перечислены допустимые значения параметров.
Значение API Описание
UNKNOWN Пользователь не завершил опрос.
DISLIKE_PERKS Пользователю не понравились бонусы.
PERKS_NOT_DELIVERED Пользователь сообщил, что не получил обещанные бонусы для спонсоров.
CANNOT_ACCESS_PERKS Пользователь не смог получить доступ к бонусам.
NO_LONGER_INTERESTED Пользователь больше не заинтересован в спонсорстве.
FEEL_UNAPPRECIATED Пользователь не чувствовал себя ценным спонсором.
FINANCIAL_REASONS Пользователь отменил подписку по финансовым причинам.
JOIN_LIMITED_TIME Пользователь изначально планировал спонсировать канал в течение ограниченного времени.
OTHER У пользователя была другая причина для отмены.

Эффективность объявлений

adType
Параметр adType используется в отчетах об эффективности объявлений и агрегирует запрошенные показатели на основе типов объявлений, которые показывались во время воспроизведения видео. Ниже приведен список возможных значений параметров. Дополнительную информацию о форматах рекламы на YouTube можно найти в Справочном центре YouTube.

  • auctionBumperInstream – видеообъявления без возможности пропуска длительностью до 6 секунд, которые размещаются через аукцион и показываются перед видео.

  • auctionDisplay – мультимедийное или графическое объявление, которое показывается в нижней части видеопроигрывателя, рекламный блок размером 300 x 250 на странице просмотра видео или и то, и другое. Оверлей автоматически закрывается через определенное время, но пользователь может закрыть его и раньше. Если оверлей и баннер показываются вместе, то каждый из них учитывается как отдельный показ.

  • auctionInstream – видеообъявления без возможности пропуска, которые показываются в начале, середине или конце основного видео.

  • auctionTrueviewInslate – зритель выбирает одно из нескольких видеообъявлений, которые показываются перед видео. See the TrueView documentation for more information.

  • auctionTrueviewInstream – видеообъявления с возможностью пропуска, которые показываются до или во время основного видео. Дополнительную информацию можно найти в документации по TrueView.

  • auctionUnknown – объявление, приобретенное на аукционе AdWords, но не классифицированное как один из других типов объявлений.

  • reservedBumperInstream – видеореклама без возможности пропуска, которая продается на основе резервирования. Ее длительность составляет до 6 секунд. Такую рекламу нужно посмотреть, чтобы запустить видео.

  • reservedClickToPlay – видеообъявление, которое воспроизводится только после того, как пользователь нажмет на него. Показ объявления регистрируется каждый раз, когда рекламный блок с воспроизведением по клику появляется на экране, независимо от того, запускает ли пользователь воспроизведение. Они продаются на основе резервирования.

  • reservedDisplay – мультимедийное или графическое объявление, которое показывается в нижней части видеопроигрывателя, рекламный блок размером 300 x 250 на странице просмотра видео или и то, и другое. Оверлей автоматически закрывается через определенное время, но пользователь может закрыть его и раньше. Если оверлей и баннер показываются вместе, то каждый из них учитывается как отдельный показ.

  • reservedInstream – видеообъявления без возможности пропуска, которые размещаются в начале, середине или конце основного видео.

  • reservedInstreamSelect

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

  • reservedUnknown – объявление, проданное на основе резервирования, которое не удалось отнести ни к одному из других типов объявлений.

  • unknown – YouTube не удалось классифицировать этот тип объявления.

Примеры

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

  • Примеры каналов

    • Доход/объявления
      • Показатели дохода канала и эффективности рекламы
      • Ежедневные показатели дохода и эффективности рекламы
      • Показатели дохода и эффективности рекламы с разбивкой по странам
      • Топ-10 видео с самым высоким доходом
      • Показатели эффективности для разных типов объявлений

  • Примеры владельцев контента

    • Доход/объявления
      • Показатели дохода и эффективности рекламы для контента, на который заявлены права
      • Ежедневные показатели дохода и эффективности рекламы
      • Показатели дохода и эффективности рекламы с разбивкой по странам
      • Топ-10 видео с самым высоким доходом
      • Показатели эффективности для разных типов объявлений

Параметры владельца контента

Следующие параметры поддерживаются только в отчетах для владельцев контента.

Важно! Запросы к API для получения отчетов владельца контента должны фильтровать данные по одному из следующих параметров:
  • video
  • channel
  • Поддерживаемое сочетание параметров claimedStatus и uploaderType, как описано ниже.
claimedStatus (только в отчетах для владельцев контента)
Этот параметр позволяет указать, что ответ API должен содержать только показатели для контента, на который заявлены права. Единственное допустимое значение для этого параметра – claimed. Если в параметре filters указано значение claimedStatus==claimed, API будет извлекать данные только для контента, на который заявлены права. В таблице с определением параметра uploaderType приведена подробная информация о том, как его использовать.
uploaderType (основной параметр) (используется только в отчетах для владельцев контента)
Этот параметр позволяет указать, должен ли ответ API содержать показатели для контента, загруженного указанным владельцем контента и/или третьими лицами, например видео, загруженные пользователями. Допустимые значения: self и thirdParty. Это основной параметр, на который распространяются правила прекращения поддержки.

В таблице ниже приведены поддерживаемые комбинации параметров claimedStatus и uploaderType, которые используются в параметре filters.

На сумму claimedStatus На сумму uploaderType Описание
[Не задано] self Получает данные YouTube Аналитики для контента, загруженного владельцем контента, на который заявлены или не заявлены права.
видео, на которые заявлены права [Не задано] Возвращает данные о контенте, на который заявлены права и который был загружен владельцем контента или третьей стороной.
видео, на которые заявлены права self Возвращает данные о контенте, на который заявлены права и который загружен владельцем контента.
видео, на которые заявлены права thirdParty Получает данные о контенте, на который заявлены права и который загружен третьей стороной.

Примеры

Во многих примерах запросов к API для отчетов владельца контента используется поддерживаемое сочетание параметров claimedStatus и uploaderType для фильтрации данных.