Dimensions

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

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

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

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

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

В следующем списке перечислены основные параметры API. Все они также являются основными параметрами API YouTube Analytics.

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

Размеры

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

Ресурсы

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

video_id (core dimension)
Идентификатор видео YouTube. В API данных YouTube это значение свойства id video . This is a core dimension and is subject to the Deprecation Policy .
playlist_id
Идентификатор плейлиста YouTube. В API данных YouTube это значение свойства id ресурса playlist .
channel_id (core dimension)
Идентификатор канала YouTube. В API данных YouTube это значение свойства id ресурса channel . This is a core dimension and is subject to the Deprecation Policy .
asset_id (only used in content owner reports)
Идентификатор актива, управляемый в системе Content ID YouTube. Актив — это представление вашей интеллектуальной собственности в этой системе. На сайте YouTube идентификаторы активов можно найти в Менеджере контента YouTube. Вы также можете получить их с помощью API YouTube Content ID .

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

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

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

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

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

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

Обратите внимание, что, хотя даты обычно представляют собой 24-часовой период, даты, когда часы переводятся вперёд на летнее время, представляют собой 23-часовой период, а даты, когда часы переводятся назад, — 25-часовой период. This is a core dimension and is subject to the Deprecation Policy .

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

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

playback_location_type
Это измерение определяет тип страницы или приложения, где произошла активность пользователя. Значения измерения приведены в следующей таблице:
Ценности
0 Данные относятся к активности, которая имела место на странице просмотра видео на YouTube или в официальном приложении YouTube, например в приложении YouTube для Android.
1 Данные относятся к активности, которая имела место на другом веб-сайте или в другом приложении, где видео было встроено с помощью <iframe> или <object> .
2 Данные относятся к активности, произошедшей на странице канала YouTube.
5 Данные относятся к показателям, которые нельзя отнести ни к одному из перечисленных типов местоположений.
7 Данные относятся к просмотрам, которые были выполнены на домашней странице или главном экране YouTube, в ленте подписок пользователя или в другой функции просмотра YouTube.
8 Данные относятся к просмотрам, которые были сделаны непосредственно на странице результатов поиска YouTube.
10 Данные относятся к просмотрам в ленте YouTube Shorts.
playback_location_detail
Это измерение указывает URL-адрес или приложение, где произошло воспроизведение. Это измерение поддерживается только для просмотров, выполненных во встроенных проигрывателях, что означает, что значение измерения заполняется только в строках, где оно равно 1 В остальных строках значение этого измерения пустое.

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

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

В следующей таблице перечислены значения измерений:
Ценности
live Данные строки описывают активность пользователя, имевшую место во время прямой трансляции.
onDemand Данные строки описывают активность пользователя, которая не имела места во время прямой трансляции.
subscribed_status
Это измерение указывает, связаны ли метрики активности пользователей в строке данных со зрителями, подписавшимися на канал видео или плейлиста. Возможные значения: subscribed и unsubscribed .

Обратите внимание, что значение параметра актуально на момент совершения пользователем действия. Например, предположим, что пользователь не подписан на канал и смотрит одно из видео на этом канале, затем подписывается на канал и смотрит другое видео, и всё это в один и тот же день. В отчёте канала указано, что одно представление имеет значение subscribed_status , равное subscribed , а другое — значение subscribed_status , равное unsubscribed .

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

traffic_source_type
Это измерение определяет тип реферера, связанный с метриками активности пользователя. Тип реферера описывает способ, которым пользователи перешли на видео или канал, связанный со строкой данных в отчёте. В следующей таблице перечислены значения измерения:
Ценности
0 Прямой или неизвестный
Это значение охватывает как прямой трафик на страницу, так и страницы, для которых реферер неизвестен. В отчётах по запросам этот тип источника трафика обозначается как NO_LINK_OTHER или UNKNOWN_MOBILE_OR_DIRECT .
1 Реклама на YouTube
Зритель перешёл на видео по рекламе. Если в отчёте по источнику трафика значение этого параметра равно 1 , то параметр traffic_source_detail определяет тип рекламы, показанной зрителю. В отчётах по запросам этот тип источника трафика определяется как ADVERTISING . Возможные значения:
Ценности
ctp_engagement_ad Реклама с функцией воспроизведения по клику
engagement_ad Реклама для вовлечения
googlemediaads Реклама в Google Поиске
insearch_display TrueView в поиске и на дисплее
instream TrueView в потоке
instream-select Зарезервированный пропускаемый поток
unknown Реклама на YouTube без рубрики
video_wall Видеостена
yva Видеореклама на главной странице
3 Обзор функций
Зритель перешёл со страницы YouTube, ведущей на видео или каналы. Если в отчёте по источникам трафика значение этого параметра равно 3 , то параметр traffic_source_detail определяет объект, с которого был перенаправлен трафик. В отчётах по запросам этот тип источника трафика определяется как SUBSCRIBER . Возможные значения:
Ценности
explore Дети: исследуйте
learning Дети: обучение
music Музыкальная лента
my-history История часов
my-subscriptions Мои подписки
my-uploads Мои загрузки
podcasts Страница назначения подкастов
shows Дети: шоу
watch-later Посмотреть позже
what-to-watch Что смотреть
4 Каналы YouTube
Зрители были перенаправлены со страницы канала YouTube. Если в отчёте по источнику трафика значение этого параметра равно 4 , то параметр traffic_source_detail указывает идентификатор канала. В отчётах по запросам этот тип источника трафика обозначается как YT_CHANNEL .
5 поиск на YouTube
Зрители были перенаправлены из результатов поиска YouTube. Если в отчёте по источникам трафика значение этого параметра равно 5 , то параметр traffic_source_detail указывает соответствующий поисковый запрос. В отчётах по запросам этот тип источника трафика обозначается как YT_SEARCH .
7 Рекомендуемые видео
Зрители перешли со страницы просмотра похожего видео на другой странице просмотра видео. Если в отчёте по источнику трафика значение этого параметра равно 7 , то параметр traffic_source_detail определяет идентификатор видео для этого видео. В отчётах по запросам этот тип источника трафика обозначается как RELATED_VIDEO или YT_RELATED .
8 Другие функции YouTube
Зрители были перенаправлены со страницы YouTube, которая не относится ни к одному из перечисленных типов источников трафика. Если в отчёте по источникам трафика значение этого параметра равно 8 , то параметр traffic_source_detail идентифицирует URL страницы. В отчётах по запросам этот тип источника трафика определяется как YT_OTHER_PAGE . Возможные значения:
Ценности
g-crec Рекомендуемые каналы
offline Оффлайн
promotion Партнерское продвижение
unknown Неизвестный
widget Виджет для домашнего экрана Android
youtu.be youtu.be
ytremote YouTube Remote
9 Внешний
Посетители перешли по ссылке с другого сайта. Этот источник трафика включает переходы из результатов поиска Google. В отчёте по источникам трафика, если значение этого параметра равно 9 , параметр traffic_source_detail идентифицирует внешнюю веб-страницу. В отчётах по запросам этот тип источника трафика обозначается как EXT_URL .
11 Видеокарты и аннотации
Зрители перешли на сайт, нажав на аннотацию или карточку в другом видео. В отчётах по запросам этот тип источника трафика обозначается как ANNOTATION .
14 Плейлисты
Просмотры происходили во время воспроизведения видео в составе плейлиста. В отчётах по запросам этот тип источника трафика обозначается как PLAYLIST .

Обратите внимание, что этот источник трафика отличается от типа источника 18 , который указывает на то, что просмотры исходили со страницы, на которой перечислены все видео в плейлисте.
17 Уведомления
Зрители были перенаправлены по электронной почте или с помощью уведомления от YouTube. В отчётах по запросам этот тип источника трафика обозначается как NOTIFICATION . Возможные значения:
Ценности
inbox
push
sdig Просмотры были получены из уведомлений, которые были частью дайджеста подписчика
uploaded_other Просмотры были получены из неpush-уведомлений, таких как уведомления по электронной почте или входящие сообщения, отправленные подписчикам при загрузке видео.
uploaded_push Просмотры были получены из push-уведомлений, отправленных подписчикам при загрузке видео.
18 Страницы плейлистов
Просмотры были получены со страницы, содержащей список всех видео в плейлисте. В отчётах по запросам этот тип источника трафика обозначается как YT_PLAYLIST_PAGE .

Обратите внимание, что этот источник трафика отличается от типа источника 14 , который указывает на то, что просмотры происходили во время воспроизведения видео в рамках плейлиста.
19 Программирование из заявленного контента
Просмотры были получены из заявленных видео, загруженных пользователями, которые владелец контента использовал для продвижения просмотренного контента. В отчётах по запросам этот источник трафика обозначается как CAMPAIGN_CARD . Этот источник трафика поддерживается только в отчётах владельца контента.
20 Интерактивный видеоконец-экран
Просмотры, инициированные конечной заставкой другого видео. В отчётах по запросам этот тип источника трафика обозначается как END_SCREEN .
23 Истории
Зритель перенаправлялся на страницу, просматривая предыдущее видео вертикальным свайпом в разделе «Истории».
24 Шорты
Зритель перенаправлялся на него, проводя по вертикали от предыдущего видео в режиме просмотра коротких видео.
25 Страницы продуктов
Видеоролики на странице продукта перенаправляли зрителей на другой канал.
26 Страницы хэштегов
Просмотры происходят со страниц хэштегов VOD или опорных страниц хэштегов Shorts.
27 Звуковые страницы
Просмотры происходят со страниц звуковых роликов Shorts.
28 Живое перенаправление
Просмотры, полученные с помощью Live Redirects .
29 Подкасты
Просмотры были получены со страницы YouTube Podcasts .
30 Ремикс видео
Просмотры были получены из ссылки на ремикшированное видео в проигрывателе Shorts.
31 Вертикальная прямая трансляция
Просмотры были получены из вертикальной прямой трансляции.
32 Похожие видео
Просмотры были получены по ссылке на соответствующее видео в проигрывателе Shorts.
traffic_source_detail
Это измерение предоставляет дополнительную информацию об источнике трафика, указанную в значении параметра traffic_source_type строки. Это значение измерения заполняется для следующих значений параметра traffic_source_type :
  • 1 – Значение параметра определяет тип рекламы, показанной зрителю. Список возможных значений см. в определении параметра traffic_source_type .
  • 3 – Значение параметра определяет функцию YouTube, которая привела к перенаправлению трафика. Список возможных значений см. в определении параметра traffic_source_type .
  • 4 – Значение параметра указывает идентификатор канала, с которого был осуществлен переход зрителя.
  • 5 – Значение параметра определяет поисковой запрос, который привел к направленному трафику.
  • 7 – Значение параметра определяет видео, с которого был осуществлен переход зрителя.
  • 8 – Значение параметра определяет тип страницы YouTube, с которой был перенаправлен трафик. Список возможных значений см. в определении параметра traffic_source_type .
  • 9 – Значение параметра определяет внешнюю страницу, с которой был направлен трафик.
  • 17 – Значение параметра определяет тип уведомления, приведшего к указанному трафику. Список возможных значений см. в определении параметра traffic_source_type .
  • 19 – Значение параметра определяет видео, с которого был осуществлен переход зрителя.
  • 20 – Значение параметра определяет видео, с которого был осуществлен переход зрителя.
  • 25 – Значение параметра определяет идентификатор продукта, который является идентификатором Google Knowledge Graph.
  • 26 – Значение параметра определяет хэштег, который привел к направленному трафику.
  • 27 – Значение параметра определяет видео, с которого был осуществлен переход зрителя.
  • 28 – Значение параметра указывает идентификатор канала, с которого зритель был перенаправлен с помощью Live Redirects .
  • 30 – Значение параметра определяет видео, с которого был осуществлен переход зрителя.

Устройства

device_type
Этот параметр определяет физический форм-фактор устройства, на котором был выполнен просмотр. В следующей таблице перечислены допустимые значения параметра:
Ценности
100 Неизвестный
101 Компьютер
102 ТВ
103 Игровая консоль
104 Мобильный телефон
105 Планшет
operating_system
Это измерение определяет программную систему устройства, на котором был выполнен просмотр. В следующей таблице перечислены допустимые значения измерения:
Ценности
1 Другой
2 Окна
3 Windows Mobile
4 Андроид
5 iOS
6 Симбиан
7 Ежевика
9 Макинтош
10 PlayStation
11 Бада
12 WebOS
13 Линукс
14 Хиптоп
15 MeeGo
16 Wii
17 Xbox
18 PlayStation Vita
19 Смарт ТВ
20 Нинтендо 3DS
21 Chromecast
22 Тизен
23 Firefox
24 RealMedia
25 KaiOS
26 Року
27 Nintendo Switch
28 Apple tvOS
29 Fire OS
30 ChromeOS
31 Видаа
32 ВегаОС

Демография

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

age_group (core dimension)
Это измерение определяет возрастную группу вошедших в систему пользователей, связанных с данными отчёта. API использует следующие возрастные группы:
  • AGE_13_17
  • AGE_18_24
  • AGE_25_34
  • AGE_35_44
  • AGE_45_54
  • AGE_55_64
  • AGE_65_
This is a core dimension and is subject to the Deprecation Policy .
gender (core dimension)
Это измерение определяет пол вошедших в систему пользователей, связанных с данными отчёта. Допустимые значения: FEMALE , MALE и GENDER_OTHER . This is a core dimension and is subject to the Deprecation Policy .

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

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

В следующей таблице перечислены допустимые значения размеров:
Ценности
0 Неизвестный
1 Дигг
4 реддит
5 StumbleUpon
6 микс
7 Yahoo! Япония
8 идти
9 Амеба
10 Фейсбук
11 Майспейс
12 Нуджидж
18 Туэнти
20 menéame
21 Выкоп
22 Скайрок
25 Фотка
28 привет5
31 Твиттер
32 Cyworld
34 Блогер
36 ВКонтакте (ВКонтакте)
37 Ракутен (楽天市場)
38 Живой Журнал
39 Одноклассники (Одноклассники)
40 тамблер.
42 Линкедин
43 Google+
44 Вейбо
45 Пинтерест
46 Электронная почта
47 Фейсбук Мессенджер
49 WhatsApp
50 Hangouts
51 Gmail
52 Какао (Kakao Talk)
53 Другой
55 Копировать в буфер обмена
59 Встроить
60 Текстовое сообщение
61 Android-сообщения
62 Сообщения Verizon
63 Текстовое сообщение HTC
64 Беседы с Sony
65 Отправьте СМС
66 Электронная почта LGE
67 Линия
68 Вайбер
69 Кик
70 Скайп
71 BlackBerry Messenger
72 WeChat
73 История КАКАО
74 Дропбокс
75 Телеграмма
76 Страницы Facebook
77 GroupMe
78 Электронная почта Android
79 Motorola Сообщения
80 Поделиться поблизости
81 Навер
82 Диалог активности системы iOS
83 Входящие Google
84 Android-мессенджер
85 YouTube Музыка
86 YouTube Гейминг
87 YouTube Дети
88 YouTube ТВ

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

Аннотации

annotation_type
Этот параметр определяет способ отображения аннотации во время видео. В следующей таблице перечислены возможные значения параметра:
Ценности
0 Неизвестный
1 Примечание
3 В центре внимания
4 Заголовок
8 Речевой пузырь
9 Этикетка
10 Брендинговый водяной знак
11 Рекомендуемое видео
12 Рекомендуемый плейлист
30 Призыв к действию
Справочный центр YouTube предоставляет более подробную информацию о различных типах аннотаций, а также о процессе добавления аннотаций к вашим видео.
annotation_id
Идентификатор, который YouTube использует для уникальной идентификации аннотации.

Карты

card_type
Этот параметр определяет тип карты, показанной пользователю. В следующей таблице перечислены возможные значения параметра:
Ценности
0 Неизвестный
60 Связь
61 Сбор средств
62 Видео
63 Плейлист
65 Финансирование от фанатов
66 Товары
68 Связанный веб-сайт
69 Канал
Справочный центр YouTube предоставляет более подробную информацию о различных типах карточек, а также о процессе добавления карточек в ваши видео.
card_id
Идентификатор, который YouTube использует для уникальной идентификации карты.

Конечные экраны

end_screen_element_type
Это измерение определяет тип элемента конечной заставки, отображаемого пользователю. В следующей таблице перечислены типы элементов конечной заставки и их значения:
Ценности
501 Видео - элемент продвигает другое видео YouTube.
502 Плейлист - Элемент продвигает плейлист YouTube.
503 Веб-сайт — элемент ссылается на ваш связанный веб-сайт.
504 Канал — элемент ссылается на другой канал.
505 Подписаться - элемент поощряет подписку на ваш канал.
506 Ассоциированный
507 Краудфандинг — элемент ссылается на одобренный сайт краудфандинга.
508 Товары - элемент ссылается на одобренный сайт с товарами.
509 Последняя загрузка. Элемент ссылается на последнее загруженное видео вашего канала.
510 Лучшее для зрителя
end_screen_element_id
Идентификатор, который YouTube использует для уникальной идентификации элемента конечной заставки.

Субтитры

subtitle_language
Этот параметр определяет язык субтитров, использовавшийся дольше всего во время просмотра. Просмотры, в которых субтитры были в основном отключены, не учитываются. Подробнее об отчётах, содержащих этот параметр, см. в документации по отчётам по каналам или отчётам владельцев контента .
subtitle_language_autotranslated
Этот параметр определяет язык автоматически переведенных субтитров, который использовался дольше всего во время просмотра. Просмотры, в которых субтитры были в основном отключены, не учитываются. Подробнее об отчётах, содержащих этот параметр, см. в документации по отчётам по каналам или отчётам владельцев контента .

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

ad_type
Параметр ad_type используется в отчётах об эффективности рекламы и агрегирует запрошенные показатели на основе типов рекламы, показанной во время воспроизведения видео. В следующей таблице перечислены возможные значения параметра. Подробнее о форматах рекламы на YouTube см. в Справочном центре YouTube .
Ценить Описание Значение в отчетах по запросам
1 Пропускаемые видеорекламы (Аукцион) auctionTrueviewInstream
2 Рекламные объявления (Аукцион) auctionDisplay
3 Видеореклама без возможности пропуска (Аукцион) auctionInstream
5 Показывать рекламу (зарезервировано) reservedDisplay
6 Видеореклама без возможности пропуска (зарезервировано) reservedInstream
13 Неизвестный unknown
15 Пропускаемые видеорекламы (зарезервировано) reservedInstreamSelect
19 Рекламные объявления (аукцион) auctionBumperInstream
20 Рекламные объявления (зарезервировано) reservedBumperInstream

Примечание: отчеты по запросам могут содержать информацию о некоторых дополнительных типах рекламы, которые ранее использовались на YouTube.

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

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

claimed_status (only used in content owner reports)
Это измерение указывает, что строка данных содержит только метрики для заявленного контента. Единственное допустимое значение для этого измерения — claimed . Таблица в определении измерения uploader_type содержит более подробную информацию об использовании этого измерения.
uploader_type (core dimension) (only used in content owner reports)
Это измерение указывает, содержит ли строка данных метрики для контента, загруженного указанным владельцем контента, и/или контента, загруженного третьими лицами, например, видео, загруженных пользователями. Допустимые значения: self и thirdParty . Это основное измерение, подпадающее под действие Политики устаревания .

В таблице ниже показаны поддерживаемые комбинации для claimed_status и uploader_type :

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