Dimensions

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

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

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

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

Размеры сердечника

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

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

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

Фильтры

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

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

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

Размеры

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

Ресурсы

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

  • CHANNEL – данные описывают просмотры, произошедшие на странице канала.

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

Обратите внимание, что значение измерения является точным на момент совершения пользователем действия. Например, предположим, что пользователь не подписался на канал и смотрит одно из видео этого канала, затем подписывается на канал и смотрит другое видео, все в тот же день. Отчет канала показывает, что одно представление имеет subscribedStatus значение SUBSCRIBED , а одно представление имеет 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
    • Видеореклама на домашней странице
    • Зарезервировано для пропуска в потоке
    • 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
  • UNKNOWN_PLATFORM
operatingSystem
Это измерение определяет программную систему устройства, на котором произошло представление. Следующий список определяет операционные системы, для которых API возвращает данные. Вы также можете использовать operatingSystem в качестве фильтра, чтобы ограничить отчет о типе устройства, чтобы он содержал только данные для определенной операционной системы.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Примеры

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

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

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

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

Демография

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

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

Примеры

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

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

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

Примеры

Следующие пример отчетов о получении рекламы или показателей доходов:

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

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

    • Доход/реклама
      • Метрики доходов и производительности рекламы для заявленного контента
      • Ежедневные доходы и показатели эффективности рекламы
      • Страновые доходы и показатели эффективности рекламы
      • Топ -10 - видео с самым высоким доходом
      • Метрики производительности рекламы для разных типов рекламы

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

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

ВАЖНО: 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 для фильтрации данных.