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 — CTR аннотаций для самых просматриваемых видео на канале.
      • Статистика по конкретному плейлисту
      • Топ 10 — самые просматриваемые плейлисты для канала
    • Географический
      • Топ-10 — самые просматриваемые видео в определенной стране
      • Топ-10 — самые просматриваемые видео в Европе

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

    • Основные характеристики
      • Топ-10 — самые просматриваемые видео для владельца контента
      • Топ-10 – самые просматриваемые видео для владельца контента
      • Топ-10 – самые просматриваемые видео на канале владельца контента
      • Топ-10 — CTR аннотаций для самых просматриваемых видео на канале.
      • Топ-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-часовой период.

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

  • 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 , а одно представление имеет значение 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 — просмотры видео происходили во время воспроизведения видео как части списка воспроизведения. Обратите внимание, что этот источник трафика отличается от YT_PLAYLIST_PAGE , что указывает на то, что просмотры происходили со страницы со списком всех видео в плейлисте.
  • PRODUCT_PAGE – просмотры видео были перенаправлены со страницы продукта.
  • PROMOTED — просмотры видео были получены из бесплатного продвижения YouTube, такого как страница YouTube «Видео в центре внимания».
  • RELATED_VIDEO — просмотры видео были перенаправлены из связанного списка видео на другой странице просмотра видео. Если вы выполняете фильтрацию на основе этого источника трафика, в поле insightTrafficSourceDetail указывается идентификатор видео для этого видео.
  • SHORTS — Зритель перешел по вертикальному свайпу от предыдущего видео в процессе просмотра короткометражек.
  • SOUND_PAGE — просмотры исходят от сводных страниц звука Shorts.
  • SUBSCRIBER . Просмотры видео были получены из каналов на главной странице YouTube или из функций подписки YouTube. Если вы выполняете фильтрацию на основе этого источника трафика, в поле insightTrafficSourceDetail указываются элементы фида домашней страницы или другая страница, с которой были связаны просмотры.
  • YT_CHANNEL — просмотры видео происходили на странице канала. Если вы выполняете фильтрацию на основе этого источника трафика, в поле insightTrafficSourceDetail указывается идентификатор канала для этого канала.
  • YT_OTHER_PAGE — просмотры видео были получены по ссылке, отличной от результата поиска или связанной ссылки на видео, появившейся на странице YouTube. Если вы фильтруете на основе этого источника трафика, поле insightTrafficSourceDetail идентифицирует страницу.
  • YT_PLAYLIST_PAGE — просмотры видео происходят со страницы, на которой перечислены все видео в плейлисте. Обратите внимание, что этот источник трафика отличается от PLAYLIST , который указывает на то, что просмотры произошли, когда видео воспроизводилось как часть плейлиста.
  • YT_SEARCH — просмотры видео были получены из результатов поиска YouTube. Если вы выполняете фильтрацию на основе этого источника трафика, в поле insightTrafficSourceDetail указывается поисковый запрос.
  • VIDEO_REMIXES — просмотры видео были получены по ссылке на ремикс видео в проигрывателе короткометражных фильмов. Если вы выполняете фильтрацию на основе этого источника трафика, в поле insightTrafficSourceDetail указывается видео, с которого был перенаправлен зритель.
insightTrafficSourceDetail
Данные в отчете агрегируются на основе рефереров, сгенерировавших наибольшее количество просмотров для указанного видео и указанного типа источника трафика. В следующем списке указаны источники трафика , для которых доступен этот отчет. Для каждого источника трафика список определяет информацию, которую предоставляет измерение insightTrafficSourceDetail .
  • ADVERTISING — Тип рекламы, которая привела к просмотрам. Возможные значения:
    • Объявление, ориентированное на взаимодействие по клику
    • Объявление о помолвке
    • Поисковая реклама Google
    • Видеореклама на главной странице
    • Зарезервировано In-Stream с возможностью пропуска
    • TrueView In-Search и In-Display
    • In-Stream 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
  • 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
Google+ GOOGLEPLUS
Перейти СМС GO_SMS
GroupMe GROUPME
Видеовстречи 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 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
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 г.

Примеры

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

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

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 на странице просмотра видео, либо в виде комбинации того и другого. When the overlay runs, it automatically closes after displaying for a certain amount of time, and the user can close the overlay as well. If an overlay and a banner are shown together, each ad is counted as a separate impression.

  • reservedInstream – Non-skippable video ads that are inserted before, during, or after the main video.

  • reservedInstreamSelect

  • reservedMasthead – A large ad, which can include video and graphic elements, that appears on the homepage.

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

  • unknown – We could not classify this ad type.

Examples

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

Playlists

isCurated (filter only)
This filter indicates that the request is retrieving data about video views that occurred in the context of a playlist. This filter is required for any playlist report and its value must be set to 1 .

Examples

All of the sample requests that retrieve playlist reports use the isCurated filter.

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.

Examples

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