Dimensions

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

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

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

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

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

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

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

Размеры

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

Ресурсы

Эти размеры соответствуют ресурсам, которыми на 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. Вы также можете получить их с помощью 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 для заявленного и невостребованного контента, загруженного владельцем контента.
claimedself В строке содержатся данные о заявленном контенте, загруженном владельцем контента.
claimedthirdParty В строке содержатся данные о заявленном контенте, загруженном третьим лицом.