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

Это измерение определяет дату, связанную с метриками в каждой строке отчета. В массовых отчетах дата относится к периоду, начинающемуся в 12:00 по тихоокеанскому времени и заканчивающемуся в 11: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-пульт дистанционного управления
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 .
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	Плейстейшен
11	Бада
12	ВебОС
13	линукс
14	Хиптоп
15	MeeGo
16	Вии
17	Xbox
18	PlayStation Vita
19	Смарт ТВ
20	Нинтендо 3DS
21	Chromecast
22	Тизен
23	Firefox
24	RealMedia
25	KaiOS
26	Року
27	Нинтендо Свитч
28	Apple TVOS
29	Операционная система Fire
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	Myspace
12	Нуджидж
18	Туэнти
20	менеаме
21	Выкоп
22	Скайрок
25	Фотка
28	привет5
31	Твиттер
32	Cyworld
34	Блоггер
36	ВКонтакте (ВКонтакте)
37	Ракутен (楽天市場)
38	Живой Журнал
39	Одноклассники (Одноклассники)
40	тамблер.
42	Линкедин
43	Гугл+
44	Вейбо
45	Пинтерест
46	Электронная почта
47	Фейсбук Мессенджер
49	WhatsApp
50	Тусовки
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	Dropbox
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	Строка содержит данные о заявленном контенте, загруженном третьей стороной.