Dimensions

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

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

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

Основные измерения

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

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

• age_group
• channel_id
• country_code
• date
• gender
• sharing_service
• uploader_type
• video_id

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

Размеры

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

Ресурсы

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

• video_id
• playlist_id
• channel_id
• asset_id

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 Content ID YouTube .

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

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

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 , а у другого unsubscribed subscribed_status

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

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	Истории Перейти к видео в Stories можно было, проведя пальцем вертикально от предыдущего видео.
24	Шорты В режиме просмотра короткометражных роликов зритель мог перейти к следующему видео, проведя пальцем вертикально от предыдущего ролика.
25	Страницы товаров Видеоролики на странице товара перенаправляли зрителей на другой канал.
26	Страницы с хэштегами Просмотры поступают со страниц с хэштегами VOD или страниц с подборкой контента по хэштегам Shorts.
27	Звуковые страницы Представленные данные были получены с помощью сводных страниц Shorts sound.
28	Перенаправление в реальном времени Представленные данные были получены с помощью перенаправлений в реальном времени .
29	Подкасты Просмотры были взяты со страницы подкастов на YouTube .
30	Ремикс видео Просмотры были получены из ремикса видеоролика в плеере Shorts.
31	Вертикальная прямая трансляция Изображения получены из вертикальной прямой трансляции.
32	Видео по теме Источником просмотров послужила ссылка на видеоролик в плеере "Короткие видео".

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 – Значение параметра указывает идентификатор канала, с которого зритель перешел на сайт через перенаправления в реальном времени .
• 30 – Значение параметра указывает, с какого видео пользователь перешел по ссылке.

Устройства

device_type

Этот параметр определяет физический форм-фактор устройства, на котором произошло наблюдение. В следующей таблице приведены допустимые значения параметров:

Ценности
100	Неизвестный
101	Компьютер
102	ТВ
103	Игровая консоль
104	Мобильный телефон
105	Планшет

operating_system

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

Ценности
1	Другой
2	Windows
3	Windows Mobile
4	Android
5	iOS
6	Symbian
7	Ежевика
9	Макинтош
10	PlayStation
11	Бада
12	WebOS
13	Linux
14	Хиптоп
15	MeeGo
16	Wii
17	Xbox
18	PlayStation Vita
19	Смарт-телевизор
20	Nintendo 3DS
21	Chromecast
22	Тизен
23	Firefox
24	RealMedia
25	КайОС
26	Року
27	Nintendo Switch
28	Apple tvOS
29	Fire OS
30	ChromeOS
31	Видаа
32	VegaOS

Демографические данные

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

age_group (core dimension)

Этот параметр определяет возрастную группу авторизованных пользователей, связанных с данными отчета, и включает пользователей, которых YouTube оценивает как лиц моложе 18 лет. 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	Myspace
12	НУджидж
18	Туэнти
20	менеаме
21	Вайкоп
22	Скайрок
25	Фотка
28	hi5
31	Твиттер
32	Cyworld
34	Блогер
36	ВКонтакте (ВКонтакте)
37	Ракутен (楽天市場)
38	LiveJournal
39	Одноклассники (Одноклассники)
40	tumblr.
42	LinkedIn
43	Google+
44	Вейбо
45	Пинтерест
46	Электронная почта
47	Facebook Messenger
49	WhatsApp
50	Hangouts
51	Гмайл
52	Какао (Kakao Talk)
53	Другой
55	Скопировать в буфер обмена
59	Встроить
60	Текстовое сообщение
61	обмен сообщениями на Android
62	сообщения Verizon
63	текстовое сообщение HTC
64	Беседы с Sony
65	Перейти SMS
66	Электронная почта LGE
67	Линия
68	Вибер
69	Кик
70	Skype
71	Blackberry Messenger
72	WeChat
73	История Какао
74	Dropbox
75	Телеграмма
76	Страницы Facebook
77	GroupMe
78	Электронная почта Android
79	Сообщения Motorola
80	Рядом Поделиться
81	Навер
82	Диалоговое окно активности системы iOS
83	Входящие сообщения Google
84	Android Messenger
85	Музыка YouTube
86	YouTube Gaming
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 по заявленному и незаявленному контенту, загруженному владельцем контента.
claimed	self	В строке содержатся данные о контенте, заявленном владельцем и загруженном им.
claimed	thirdParty	В строке содержатся данные о заявленном контенте, загруженном третьей стороной.