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. Он также не поддерживает подразделения других стран, кроме США.

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> . Например, воспроизведение в приложениях, использующих YouTube Android Player API, будет классифицироваться с использованием этого значения.

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

    С 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 , а другое представление имеет значение subscribedStatus UNSUBSCRIBED .
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 – Зритель перешел, проведя по вертикали от предыдущего видео в режиме просмотра Shorts.
  • SOUND_PAGE – просмотры происходили со сводных страниц звука Shorts.
  • SUBSCRIBER . Просмотры видео были перенаправлены из каналов на главной странице YouTube или из функций подписки YouTube. Если вы выполняете фильтрацию на основе этого источника трафика, поле insightTrafficSourceDetail указывает элементы фида домашней страницы или другую страницу, с которой были перенаправлены просмотры.
  • YT_CHANNEL – просмотры видео произошли на странице канала. Если вы выполняете фильтрацию на основе этого источника трафика, поле insightTrafficSourceDetail указывает идентификатор канала для этого канала.
  • YT_OTHER_PAGE – просмотры видео были перенаправлены по ссылке, отличной от результатов поиска или ссылки на связанное видео, которая появилась на странице YouTube. Если вы фильтруете на основе этого источника трафика, поле insightTrafficSourceDetail идентифицирует страницу.
  • YT_SEARCH – просмотры видео были получены из результатов поиска YouTube. Если вы фильтруете на основе этого источника трафика, поле insightTrafficSourceDetail указывает поисковый запрос.
  • VIDEO_REMIXES – просмотры видео были перенаправлены по ссылке на ремикс видео в проигрывателе Shorts. Если вы выполняете фильтрацию на основе этого источника трафика, поле insightTrafficSourceDetail указывает видео, с которого был перенаправлен зритель.
insightTrafficSourceDetail
Данные в отчете агрегируются на основе источников перехода, сгенерировавших наибольшее количество просмотров для указанного видео, и указанного типа источника трафика. В следующем списке указаны источники трафика , для которых доступен этот отчет. Для каждого источника трафика в списке указана информация, которую предоставляет измерение insightTrafficSourceDetail .
  • ADVERTISING — тип рекламы, которая привела к просмотрам. Возможные значения:
    • Объявление, ориентированное на взаимодействие по клику
    • Объявление, ориентированное на взаимодействие
    • Поисковые объявления Google
    • Видеообъявление на главной странице
    • Зарезервированная реклама In-Stream с возможностью пропуска
    • TrueView в поиске и на дисплее
    • 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 – видео, которое набрало просмотры.

Примеры

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

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

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

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

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

Устройства

deviceType
Это измерение определяет физический форм-фактор устройства, на котором произошло представление. В следующем списке указаны типы устройств, для которых API возвращает данные. Вы также можете использовать измерение deviceType в качестве фильтра, чтобы ограничить отчет операционной системы, содержащий только данные для определенного типа устройства.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • 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
Блэкберри Мессенджер BBM
Блогер BLOGGER
Скопировать в буфер обмена COPY_PASTE
Саймир CYWORLD
Дигг DIGG
Дропбокс DROPBOX
Встроить EMBED
Электронная почта MAIL
Фейсбук FACEBOOK
Facebook Мессенджер FACEBOOK_MESSENGER
Страницы Facebook FACEBOOK_PAGES
Фотка FOTKA
Gmail GMAIL
идти GOO
Гугл+ GOOGLEPLUS
Перейти СМС GO_SMS
ГруппаМе GROUPME
Hangouts HANGOUTS
привет5 HI5
Текстовое сообщение HTC HTC_MMS
Google Входящие INBOX
Диалоговое окно активности системы iOS IOS_SYSTEM_ACTIVITY_DIALOG
История КАКАО KAKAO_STORY
Какао (Разговор Какао) KAKAO
Кик KIK
Электронная почта LGE LGE_EMAIL
Линия LINE
Линкедин LINKEDIN
Живой Журнал LIVEJOURNAL
Менеам 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
Вейбо WEIBO
WhatsApp WHATS_APP
Викоп WYKOP
Yahoo! Япония YAHOO
YouTube-игры YOUTUBE_GAMING
YouTube Детям YOUTUBE_KIDS
YouTube Музыка YOUTUBE_MUSIC
Ютуб ТВ 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 г.

Примеры

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

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

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 – нам не удалось классифицировать этот тип объявления.

Примеры

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

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

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

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

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

Плейлисты

isCurated (filter only)
Этот фильтр указывает, что запрос получает данные о просмотрах видео, произошедших в контексте списка воспроизведения. Этот фильтр необходим для любого отчета о списке воспроизведения, и его значение должно быть установлено равным 1 .

Примеры

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

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

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

ВАЖНО: API Запросы на получение отчетов владельца контента должны фильтровать данные, используя одно из следующих измерений:
  • video
  • channel
  • Поддерживаемая комбинация измерений claimedStatus и uploaderType размеров, как определено ниже.
claimedStatus (only used in content owner reports)
Это измерение позволяет указать, что ответ API должен содержать только метрики только для заявленного контента. Единственное действительное значение для этого измерения claimed . Если параметр filters ограничивает запрос claimedStatus==claimed , API получит только данные только для заявленного контента. Таблица в определении измерения uploaderType дает более подробную информацию о том, как использовать это измерение.
uploaderType (core dimension) (only used in content owner reports)
Это измерение позволяет указать, должен ли ответ API содержать метрики для контента, загруженного указанным владельцем контента и/или контентом, загруженным третьими лицами, такими как видеопогруженные видео. Допустимые значения являются self и thirdParty . Это основное измерение и подлежит политике снижения .

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

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

Примеры

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