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. Вы также можете получить их с помощью YouTube Content ID API .

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

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

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	реклама на ютубе Зрителя перенаправила на видео реклама. Если в отчете об источнике трафика значение этого измерения равно 1 , то измерение Traffic_source_detail идентифицирует тип рекламы, которая была показана зрителю. В отчетах о запросах этот тип источника трафика обозначается как ADVERTISING . Возможные значения: Ценности ctp_engagement_ad Объявление, ориентированное на взаимодействие по клику engagement_ad Объявление, ориентированное на взаимодействие googlemediaads Поисковые объявления Google insearch_display TrueView в поиске и на дисплее instream TrueView In-Stream instream-select Зарезервированная реклама In-Stream с возможностью пропуска 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. Если в отчете об источнике трафика значение этого измерения равно 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 Пульт дистанционного управления
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	Шорты Зритель перешел, проведя по вертикали от предыдущего видео в режиме просмотра Shorts.
25	Страницы продуктов Видео на странице продукта перенаправляли зрителей на другой канал.
26	Страницы с хэштегами Просмотры происходили со страниц хэштегов VOD или сводных страниц хэштегов Shorts.
27	Звуковые страницы Просмотры были получены со сводных страниц со звуком Shorts.
28	Живое перенаправление Просмотры были получены благодаря Live Redirects .
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 Мобайл
4	Андроид
5	iOS
6	Симбиан
7	Ежевика
9	Макинтош
10	PlayStation
11	Бада
12	ВебОС
13	Линукс
14	Хиптоп
15	МиГо
16	Вий
17	Xbox
18	PlayStation Вита
19	Смарт ТВ
20	Нинтендо 3DS
21	Хромкаст
22	Тизен
23	Firefox
24	РеалМедиа
25	КайОС
26	Року
27	Нинтендо Переключатель
28	Apple TVOS
29	Огненная ОС
30	ChromeOS
31	Видаа

Демография

Демографические параметры помогут вам понять возрастной диапазон и гендерное распределение вашей аудитории. Справочный центр 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	Менеам
21	Викоп
22	Скайрок
25	Фотка
28	привет5
31	Твиттер
32	Саймир
34	Блогер
36	ВКонтакте (ВКонтакте)
37	Ракутен (楽天市場)
38	Живой Журнал
39	Одноклассники (Одноклассники)
40	тамблер.
42	Линкедин
43	Гугл+
44	Вейбо
45	Пинтерест
46	Электронная почта
47	Facebook Мессенджер
49	WhatsApp
50	Hangouts
51	Gmail
52	Какао (Разговор Какао)
53	Другой
55	Копировать в буфер обмена
59	Встроить
60	Текстовое сообщение
61	Android-сообщения
62	Сообщения Verizon
63	Текстовое сообщение HTC
64	Разговоры о Sony
65	Перейти СМС
66	Электронная почта LGE
67	Линия
68	Вайбер
69	Кик
70	Скайп
71	Блэкберри Мессенджер
72	Вичат
73	История КАКАО
74	Дропбокс
75	Телеграмма
76	Страницы Facebook
77	ГруппаМе
78	Электронная почта Android
79	Обмен сообщениями Motorola
80	Поделиться поблизости
81	Навер
82	Диалоговое окно активности системы iOS
83	Google Входящие
84	Android Мессенджер
85	YouTube Музыка
86	YouTube-игры
87	YouTube Детям
88	Ютуб ТВ

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

Аннотации

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	В строке содержатся данные о заявленном контенте, загруженном третьим лицом.