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 из списка ООН.

Примеры

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

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

    • Основные статистические данные : количество просмотров (и многое другое) для канала в зависимости от страны.
    • Географический
      • Показатели времени просмотра видеороликов канала в зависимости от страны
      • Метрики аннотирования для видео на канале, специфичные для каждой страны.
      • Показатели по отдельным провинциям США: штаты и Вашингтон, округ Колумбия.
      • Показатели времени просмотра плейлистов канала с учетом специфики каждой страны.
      • Топ-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 (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 года, в отчетах YouTube Analytics воспроизведение больше не классифицируется как MOBILE . Однако это значение может сохраниться в отчетах, поскольку устаревшие данные по-прежнему относятся к этой категории. После этой даты мобильное воспроизведение классифицируется как 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). Исключение: в CORE включается активность пользователей, которая происходила в YouTube Music до 1 марта 2021 года.
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 или сводных страниц с хэштегами коротких видеороликов.
  • 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)
Этот параметр определяет возрастную группу авторизованных пользователей, связанных с данными отчета, и включает пользователей, которых 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 .
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 Messenger ANDROID_MESSENGER
обмен сообщениями на Android ANDROID_MMS
Blackberry Messenger BBM
Блогер BLOGGER
Скопировать в буфер обмена COPY_PASTE
Cyworld CYWORLD
Дигг DIGG
Dropbox DROPBOX
Встроить EMBED
Электронная почта MAIL
Фейсбук FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Страницы Facebook FACEBOOK_PAGES
Фотка FOTKA
Гмайл GMAIL
идти GOO
Google+ GOOGLEPLUS
Перейти SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
текстовое сообщение HTC HTC_MMS
Входящие сообщения Google INBOX
Диалоговое окно активности системы iOS IOS_SYSTEM_ACTIVITY_DIALOG
История Какао KAKAO_STORY
Какао (Kakao Talk) KAKAO
Кик KIK
Электронная почта LGE LGE_EMAIL
Линия LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
менеаме MENEAME
микси MIXI
Сообщения Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Навер NAVER
Рядом Поделиться NEARBY_SHARE
НУджидж NUJIJ
Одноклассники (Одноклассники) ODNOKLASSNIKI
Другой OTHER
Пинтерест PINTEREST
Ракутен (楽天市場) RAKUTEN
Реддит REDDIT
Skype SKYPE
Скайрок SKYBLOG
Беседы с Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Телеграмма TELEGRAM
Текстовое сообщение TEXT_MESSAGE
Туэнти TUENTI
tumblr. TUMBLR
Твиттер TWITTER
Неизвестный UNKNOWN
сообщения Verizon VERIZON_MMS
Вибер VIBER
ВКонтакте (ВКонтакте) VKONTAKTE
WeChat WECHAT
Вейбо WEIBO
WhatsApp WHATS_APP
Вайкоп WYKOP
Yahoo! Япония YAHOO
YouTube Gaming 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 – Объявление, проданное на условиях резервирования, которое не может быть отнесено к другим типам объявлений.

  • unknown – YouTube не смог классифицировать этот тип рекламы.

Примеры

В приведенных ниже примерах отчетов отображаются показатели эффективности рекламы или дохода:

  • 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.