Dimensions

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

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

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

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

Основные размеры

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

В следующем списке определены основные измерения API.

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

Фильтры

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

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

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

Размеры

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

Ресурсы

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

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

video (core dimension)
Идентификатор видео YouTube. В API данных YouTube это значение свойства id video . This is a core dimension and is subject to the Deprecation Policy .
playlist
Идентификатор плейлиста YouTube. В API данных YouTube это значение свойства id ресурса playlist .
channel (core dimension) (only used in content owner reports)
Идентификатор канала YouTube. В API данных YouTube это значение свойства id ресурса channel . This is a core dimension and is subject to the Deprecation Policy .

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

Примеры

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

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

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

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

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

Географические районы

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

country (core dimension)
Страна, связанная с метриками в строке отчёта. Значение параметра представляет собой двухбуквенный код страны 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 использует для обозначения выделенной рыночной зоны (DMA), связанной с событиями просмотра, описанными в строке данных.
city
Предполагаемый город, связанный с показателями в строке отчёта. Данные по этому параметру доступны для дат, начинающихся с 1 января 2022 года.
continent (filter only)
Статистический код региона ООН. API поддерживает следующие значения:
Ценности
002 Африка
019 Америка (Северная Америка, Латинская Америка, Южная Америка и Карибский бассейн)
142 Азия
150 Европа
009 Океания
Это измерение можно использовать только для фильтрации данных. Чтобы использовать это измерение, установите значение параметра filters как continent==REGION_CODE , указав значение REGION_CODE из таблицы.
subContinent (filter only)
Статистический код региона ООН, идентифицирующий географический субрегион. Статистический отдел ООН перечисляет субрегионы, а также страны, которые он относит к каждому региону.

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

Примеры

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

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

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

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

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

Периоды времени

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

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

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

day (core dimension)
При использовании этого параметра данные в отчёте агрегируются ежедневно, и каждая строка содержит данные за один день. Вы можете использовать другие параметры для более детальной детализации данных. Например, отчёт по источникам трафика может агрегировать ежедневную статистику просмотров на основе способа, которым пользователи переходят к вашим видео. This is a core dimension and is subject to the Deprecation Policy .
month (core dimension)
Данные в отчёте агрегированы по календарным месяцам. Как и в ежедневных отчётах, вы можете использовать другие фильтры для ещё более точной сегментации данных. Даты в отчёте представлены в формате 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> . Например, воспроизведения в приложениях, использующих API YouTube Android Player, будут классифицироваться по этому значению.

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

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

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

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

  • YT_OTHER – Данные описывают представления, которые не классифицируются иным образом.

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

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

insightTrafficSourceType
Данные в отчёте агрегируются на основе типа реферера, который описывает способ, которым пользователи перешли на видео. Возможные значения для этого параметра:
  • ADVERTISING – Зритель перешёл на видео по рекламе. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail определяет тип рекламы.
  • ANNOTATION . Зрители перешли к видео, нажав на аннотацию в другом видео.
  • CAMPAIGN_CARD – Просмотры, полученные из заявленных видео, загруженных пользователями и использованных владельцем контента для продвижения просмотренного контента. Этот источник трафика поддерживается только для отчётов владельца контента.
  • END_SCREEN – Просмотры были сделаны с конечной заставки другого видео.
  • EXT_URL – просмотры видео осуществлялись по ссылке с другого сайта. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail идентифицирует веб-страницу. Этот источник трафика включает переходы из результатов поиска Google.
  • HASHTAGS – Просмотры, полученные со страниц хэштегов VOD или опорных страниц хэштегов Shorts.
  • LIVE_REDIRECT — просмотры видео были осуществлены с помощью Live Redirects .
  • NO_LINK_EMBEDDED – Видео было встроено на другой веб-сайт во время просмотра.
  • NO_LINK_OTHER – YouTube не определил источник перехода по этому трафику. Эта категория включает прямой трафик на видео, а также трафик в мобильных приложениях.
  • NOTIFICATION – Просмотры видео были связаны с электронной почтой или уведомлением от YouTube.
  • PLAYLIST – Просмотры видео произошли во время его воспроизведения в составе плейлиста. Включая трафик со страницы плейлиста.
  • PRODUCT_PAGE — просмотры видео были осуществлены со страницы продукта.
  • PROMOTED – просмотры видео были получены в результате неоплачиваемого продвижения на YouTube, например, со страницы YouTube «Видео в центре внимания».
  • RELATED_VIDEO – просмотры видео были связаны с похожим видео на странице просмотра другого видео. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail указывает идентификатор этого видео.
  • SHORTS — Зритель перешел на страницу, проведя по экрану вертикально от предыдущего видео в разделе «Короткие видео».
  • SOUND_PAGE – Просмотры, полученные со страниц со звуком коротких видео.
  • SUBSCRIBER – просмотры видео были связаны с фидами на главной странице YouTube или функциями подписки на YouTube. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail указывает элементы фида на главной странице или другую страницу, с которой были связаны просмотры.
  • YT_CHANNEL – просмотры видео были совершены на странице канала. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail указывает идентификатор этого канала.
  • YT_OTHER_PAGE – просмотры видео были осуществлены по ссылке, отличной от результата поиска или ссылки на связанное видео, размещенной на странице YouTube. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail идентифицирует страницу.
  • YT_SEARCH – просмотры видео были связаны с результатами поиска на YouTube. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail указывает поисковый запрос.
  • VIDEO_REMIXES – просмотры видео были осуществлены по ссылке на ремикс в проигрывателе Shorts. При фильтрации по этому источнику трафика поле insightTrafficSourceDetail укажет видео, с которого был осуществлен переход.
insightTrafficSourceDetail
Данные в отчёте агрегируются на основе источников трафика, сгенерировавших наибольшее количество просмотров определённого видео, и указанного типа источника трафика. В следующем списке указаны источники трафика , для которых доступен этот отчёт. Для каждого источника трафика в списке указана информация, предоставляемая измерением insightTrafficSourceDetail .
  • ADVERTISING – Тип рекламы, приведшей к просмотрам. Возможные значения:
    • Реклама с функцией воспроизведения по клику
    • Реклама для вовлечения
    • Реклама в Google Поиске
    • Видеореклама на главной странице
    • Зарезервированный пропускаемый поток
    • TrueView в поиске и на дисплее
    • TrueView в потоке
    • Реклама на 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 – Видео, которое привело к просмотрам.

Примеры

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

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

    • Источник трафика
      • Количество просмотров и время просмотра из разных источников трафика в стране
      • Количество ежедневных просмотров и время просмотра из разных источников трафика
      • Топ-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 содержит дополнительную информацию о демографических данных в отчётах YouTube Analytics .

ageGroup (core dimension)
Это измерение определяет возрастную группу вошедших в систему пользователей, связанных с данными отчёта. 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 .
gender (core dimension)
Это измерение определяет пол вошедших в систему пользователей, связанных с данными отчёта. Допустимые значения: female , male и user_specified . This is a core dimension and is subject to the Deprecation Policy .

Примеры

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

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

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

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

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

Взаимодействие и обмен контентом

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

В следующей таблице перечислены допустимые значения размеров:
Служба обмена Значение API
Амеба AMEBA
Электронная почта Android ANDROID_EMAIL
Android-мессенджер ANDROID_MESSENGER
Android-сообщения ANDROID_MMS
BlackBerry Messenger BBM
Блогер BLOGGER
Копировать в буфер обмена COPY_PASTE
Cyworld CYWORLD
Дигг DIGG
Дропбокс DROPBOX
Встроить EMBED
Электронная почта MAIL
Фейсбук FACEBOOK
Фейсбук Мессенджер FACEBOOK_MESSENGER
Страницы Facebook FACEBOOK_PAGES
Фотка FOTKA
Gmail GMAIL
идти GOO
Google+ GOOGLEPLUS
Отправьте СМС GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
привет5 HI5
Текстовое сообщение HTC HTC_MMS
Входящие Google INBOX
Диалог активности системы iOS IOS_SYSTEM_ACTIVITY_DIALOG
История КАКАО KAKAO_STORY
Какао (Kakao Talk) KAKAO
Кик KIK
Электронная почта LGE LGE_EMAIL
Линия LINE
Линкедин LINKEDIN
Живой Журнал LIVEJOURNAL
menéame MENEAME
микс MIXI
Motorola Сообщения MOTOROLA_MESSAGING
Майспейс MYSPACE
Навер NAVER
Поделиться поблизости NEARBY_SHARE
Нуджидж NUJIJ
Одноклассники (Одноклассники) ODNOKLASSNIKI
Другой OTHER
Пинтерест PINTEREST
Ракутен (楽天市場) RAKUTEN
реддит REDDIT
Скайп SKYPE
Скайрок SKYBLOG
Беседы с Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Телеграмма TELEGRAM
Текстовое сообщение TEXT_MESSAGE
Туэнти TUENTI
тамблер. TUMBLR
Твиттер TWITTER
Неизвестный UNKNOWN
Сообщения Verizon VERIZON_MMS
Вайбер VIBER
ВКонтакте (ВКонтакте) VKONTAKTE
WeChat WECHAT
Вейбо WEIBO
WhatsApp WHATS_APP
Выкоп WYKOP
Yahoo! Япония YAHOO
YouTube Гейминг YOUTUBE_GAMING
YouTube Дети YOUTUBE_KIDS
YouTube Музыка YOUTUBE_MUSIC
YouTube ТВ YOUTUBE_TV

Более подробную информацию смотрите в справочной документации .

Примеры

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

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

    • Социальные сети : показатели распространения, агрегированные по сервисам, где были опубликованы видео.

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

    • Социальные сети : показатели распространения, агрегированные по сервисам, где были опубликованы видео.

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

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

API возвращает 100 точек данных для каждого видео со значениями коэффициента пропорциональности от 0.01 до 1.0 . Время измерения данных во время воспроизведения видео равномерным для каждого видео. Это означает, что для двухминутного видео интервал между точками данных составляет 1,2 секунды. Однако для двухчасового видео интервал между точками данных составляет 72 секунды. Значение параметра обозначает исключительную границу интервала.
audienceType (filter only)
Значение параметра определяет тип трафика, связанного с данными отчёта. Поддерживаемые значения: 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 – мультимедийная или графическая реклама, которая отображается либо в виде оверлея в нижней части видеоплеера, либо в виде рекламного блока размером 300x250 на странице просмотра видео, либо в виде комбинации этих двух вариантов. Оверлей автоматически закрывается после определенного времени отображения, и пользователь может закрыть его сам. Если оверлей и баннер отображаются одновременно, каждый показ рекламы учитывается как отдельный.

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

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

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

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

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

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

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

  • reservedInstream – непропускаемые видеорекламы, которые вставляются до, во время или после основного видео.

  • reservedInstreamSelect

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

  • reservedUnknown – An ad that was sold on a reserved basis that could not be classified into one of the other ad types.

  • unknown – YouTube could not classify this ad type.

Примеры

The following sample reports retrieve ad performance or revenue metrics:

  • Channel examples

    • Revenue/Ads
      • Channel revenue and ad performance metrics
      • Daily revenue and ad performance metrics
      • Country-specific revenue and ad performance metrics
      • Top 10 – Videos with the highest revenue
      • Ad performance metrics for different ad types

  • Content owner examples

    • Revenue/Ads
      • Revenue and ad performance metrics for claimed content
      • Daily revenue and ad performance metrics
      • Country-specific revenue and ad performance metrics
      • Top 10 – Videos with the highest revenue
      • Ad performance metrics for different ad types

Content owner dimensions

The following dimensions are only supported for content owner reports.

Important: API requests to retrieve content owner reports must filter data using one of the following dimensions:
  • video
  • channel
  • A supported combination of the claimedStatus and uploaderType dimensions as defined below.
claimedStatus (only used in content owner reports)
This dimension lets you indicate that an API response should only contain metrics for claimed content. The only valid value for this dimension is claimed . If the filters parameter restricts the query to claimedStatus==claimed , the API will only retrieve data for claimed content. The table in the definition of the uploaderType dimension provides more detail about how to use this dimension.
uploaderType (core dimension) (only used in content owner reports)
This dimension lets you indicate whether an API response should contain metrics for content uploaded by the specified content owner and/or content uploaded by third parties, such as user-uploaded videos. Valid values are self and thirdParty . This is a core dimension and is subject to the Deprecation Policy .

The table below shows the supported combinations for the claimedStatus and uploaderType dimensions, which are both used in the filters parameter:

claimedStatus value uploaderType value Описание
[Not set] self Retrieves YouTube Analytics data for claimed and unclaimed content uploaded by the content owner.
claimed [Not set] Retrieves data for claimed content uploaded by the content owner or by a third party.
claimedself Retrieves data for claimed content uploaded by the content owner.
claimedthirdParty Retrieves data for claimed content uploaded by a third party.

Примеры

Many of the sample API requests for content owner reports use a supported combination of the claimedStatus and uploaderType dimensions to filter data.