В этом документе определяются измерения, которые поддерживает API YouTube Analytics . Этот API поддерживает целевые запросы в реальном времени для создания пользовательских отчетов YouTube Analytics.
Параметры — это общие критерии, которые используются для агрегирования данных, например, дата, когда произошла активность пользователя, или страна, в которой находились пользователи.
Каждый отчет запроса определяет измерения, которые он поддерживает. Например, при извлечении активности пользователя по времени вы выбираете период времени, за который будут представлены данные: день или месяц . В любом отчете каждая строка данных имеет уникальную комбинацию значений измерений.
Чтобы получить отчет по запросу, вызовите метод reports.query
API YouTube Analytics. В своем запросе используйте параметр dimensions
, чтобы указать измерения, которые YouTube будет использовать для расчета значений метрик в отчетах.
Размеры сердечника
В то время как API YouTube Analytics подчиняется Политике устаревания, определенной в Условиях обслуживания , неосновные измерения (и неосновные метрики) не подчиняются этой политике. В определениях на этой странице любое измерение, являющееся основным, явно идентифицируется как таковое.
В следующем списке указаны основные параметры API.
Более подробную информацию см. в списке API YouTube, на которые распространяется Политика устаревания .
Фильтры
Все отчеты по запросам поддерживают фильтры. Фильтры определяют значения измерений, которые должны присутствовать в извлеченном наборе данных. Таким образом, они ограничивают ответ API, включая только данные, соответствующие определенному значению или набору значений. Например, вместо того, чтобы извлекать метрики активности пользователей для всех стран, вы можете использовать фильтр, чтобы извлекать данные только для определенной страны.
В запросе на получение отчета по запросу необязательный параметр запроса filters
указывает значения измерений, для которых вы хотите фильтровать данные. Например, чтобы получить показатели активности пользователей для Европы, вы должны установить значение параметра filters
на continent==150
.
Важно: запросы API для получения отчетов о владельце контента должны фильтровать данные, используя либо одно из измерений отчетной сущности, либо поддерживаемую комбинацию измерений claimedStatus
и uploaderType
.
Размеры
В следующих разделах определяются измерения, которые используются в отчетах по запросам API YouTube Analytics. Если не указано иное, эти измерения используются в отчетах как о канале , так и о владельце контента . Также определяются измерения, которые могут использоваться только в качестве фильтров.
Ресурсы
Эти параметры соответствуют ресурсам, которыми управляют владельцы каналов и контента на YouTube:
Примечание: API позволяет указать несколько значений для измерений video
, playlist
и channel
, когда они используются в качестве фильтров. Для этого установите значение параметра filters
в виде разделенного запятыми списка идентификаторов видео, плейлиста или канала, для которых должен быть отфильтрован ответ API. Значение параметра может указывать до 500 идентификаторов.
- video (core dimension)
- Идентификатор видео YouTube. В API данных YouTube это значение свойства
id
video
. This is a core dimension and is subject to the Deprecation Policy . - playlist
- Идентификатор плейлиста YouTube. В API данных YouTube это значение свойства
id
ресурсаplaylist
. - channel (core dimension) (only used in content owner reports)
- Идентификатор канала YouTube. В API данных YouTube это значение свойства
id
ресурсаchannel
. This is a core dimension and is subject to the Deprecation Policy .
Параметрchannel
часто используется в отчетах владельцев контента, поскольку эти отчеты обычно агрегируют данные по нескольким каналам. - group (filter only)
- Идентификатор группы YouTube Analytics. Вы можете получить это значение с помощью метода
groups.list
API YouTube Analytics. При использовании фильтраgroup
ответ API содержит данные для всех видео, плейлистов или каналов в этой группе.
Примеры
В следующих примерах запросов используются измерения или фильтры отчетных сущностей:
Примеры каналов
- Основная статистика
- Топ 10 – Самые просматриваемые видео на канале
- Топ-10 – Показатели кликабельности аннотаций для самых просматриваемых видео канала
- Статистика по конкретному плейлисту
- Топ 10 – Самые просматриваемые плейлисты на канале
- Географический
- Топ 10 – самые просматриваемые видео в определенной стране
- Топ-10 – Самые просматриваемые видео в Европе
- Основная статистика
Примеры владельцев контента
- Основная статистика
- Топ-10 — самые просматриваемые видео владельца контента
- Топ-10 — самые просматриваемые видео владельца контента
- Топ-10 — самые просматриваемые видео на канале владельца контента
- Топ-10 – Показатели кликабельности аннотаций для самых просматриваемых видео канала
- Топ-10 – Самые просматриваемые плейлисты владельца контента
- Географический
- Топ-10 — самые просматриваемые видео в Европе для владельца контента
- Топ-10 – Самые запускаемые плейлисты в США
- Основная статистика
Географические области
Эти измерения определяют географический регион, связанный с активностью пользователей, эффективностью рекламы или предполагаемыми показателями дохода.
- country (core dimension)
- Страна, связанная с метриками в строке отчета. Значение измерения — двухбуквенный код страны ISO-3166-1, например
US
,CN
(Китай) илиFR
(Франция). Код страныZZ
используется для отчетов о метриках, для которых YouTube не удалось определить связанную страну. This is a core dimension and is subject to the Deprecation Policy . - province
- Штат или территория США, связанная с метриками в строке отчета. Значением измерения является код ISO 3166-2 , который идентифицирует штат США или округ Колумбия, например
US-MI
(Мичиган) илиUS-TX
(Техас). Код провинцииUS-ZZ
используется для отчета о метриках, для которых YouTube не удалось идентифицировать связанный штат США. Когда запрос API включаетprovince
в значение параметраdimensions
, запрос также должен ограничивать данные Соединенными Штатами, включивcountry==US
в значение параметраfilters
.Примечание: Это измерение не поддерживает значения ISO 3166-2, которые идентифицируют отдаленные районы США, поскольку эти территории также имеют свои собственные коды стран ISO 3166-1. Оно также не поддерживает подразделения стран, отличных от Соединенных Штатов.
- dma
- Трехзначный идентификатор, который Nielsen использует для определения выделенной рыночной зоны (DMA), связанной с просмотренными событиями, описанными в строке данных.
- city
- Предполагаемый город, связанный с метриками в строке отчета. Данные для этого измерения доступны для дат, начинающихся с 1 января 2022 года.
- continent (filter only)
- Статистический код региона Организации Объединенных Наций (ООН). API поддерживает следующие значения:
Это измерение можно использовать только для фильтрации данных. Чтобы использовать это измерение, установите значение параметраЦенности 002
Африка 019
Америка (Северная Америка, Латинская Америка, Южная Америка и страны Карибского бассейна) 142
Азия 150
Европа 009
Океания filters
наcontinent==REGION_CODE
, указав значениеREGION_CODE
из таблицы. - subContinent (filter only)
- Статистический код региона ООН, который идентифицирует географический субрегион. Статистический отдел ООН перечисляет субрегионы, а также страны, которые он ассоциирует с каждым регионом.
Это измерение можно использовать только для фильтрации данных. Чтобы использовать это измерение, установите значение параметра
filters
наsubContinent==REGION_CODE
, указав значениеREGION_CODE
из списка UN.
Примеры
В следующих примерах запросов используются географические измерения или фильтры:
Примеры каналов
- Базовая статистика : количество просмотров канала по странам (и многое другое)
- Географический
- Показатели времени просмотра видео на канале по странам
- Метрики аннотаций для видео канала по странам
- Показатели по провинциям США и округу Колумбия
- Показатели времени просмотра плейлистов канала по странам
- Топ-10 – Самые запускаемые плейлисты в США
- Место воспроизведения : количество просмотров за день и время просмотра из разных мест воспроизведения.
- Источник трафика : количество просмотров и время просмотра из разных источников трафика в стране.
- Демографические данные : демографические данные зрителей в Калифорнии (возрастная группа и пол)
- Лучшие видео
- Топ 10 – самые просматриваемые видео в определенной стране
- Топ-10 – Самые просматриваемые видео в Европе
Примеры владельцев контента
- Основная статистика : количество просмотров по странам (и многое другое) для всех самостоятельно загруженных видео
- Географический
- Показатели времени просмотра самостоятельно загруженного контента по странам
- Метрики аннотаций для самостоятельно загруженного контента по странам
- Показатели по провинциям США и округу Колумбия
- Показатели времени просмотра для плейлистов владельца контента по странам
- Топ-10 – Самые запускаемые плейлисты в США
- Место воспроизведения : количество просмотров за день и время просмотра из разных мест воспроизведения.
- Демографические данные : демографические данные зрителей в Калифорнии (возрастная группа и пол)
- Лучшие видео : Топ-10 – Самые просматриваемые видео в Европе для владельца контента
- Доход/Эффективность рекламы : показатели дохода и эффективности рекламы по конкретной стране
Периоды времени
Эти измерения указывают, что отчет должен агрегировать данные на основе периода времени, например дня, недели или месяца. Параметры запроса startDate
и endDate
указывают период времени, за который отчет включает данные. Обратите внимание, что отчет фактически возвращает данные вплоть до последнего дня, для которого все указанные в запросе показатели доступны на момент выполнения запроса. В отчетах даты указаны в формате YYYY-MM-DD
.
Важно: Все даты относятся к периоду времени, начинающемуся в 12:00 по тихоокеанскому времени (UTC-7 или UTC-8) и заканчивающемуся в 11:59 по тихоокеанскому времени указанного дня, месяца и года. В результате даты, когда часы переводятся вперед на летнее время, представляют собой 23-часовой период, а даты, когда часы переводятся назад, представляют собой 25-часовой период.
Месяц относится к периоду времени, начинающемуся в 12:00 по тихоокеанскому времени (UTC-7 или UTC-8) в первый день указанного месяца и года.
- day (core dimension)
- При использовании этого измерения данные в отчете агрегируются ежедневно, и каждая строка содержит данные за один день. Вы можете использовать другие измерения, чтобы еще больше разбить данные. Например, отчет об источнике трафика может агрегировать ежедневную статистику просмотров на основе способа, которым пользователи добираются до ваших видео. This is a core dimension and is subject to the Deprecation Policy .
- month (core dimension)
- Данные в отчете агрегируются по календарным месяцам. Как и в ежедневных отчетах, вы можете использовать другие фильтры для дальнейшего сегментирования данных. В отчете даты указаны в формате
YYYY-MM
.
Примечание: Если ваш запрос API использует измерениеmonth
, то параметрыstart-date
иend-date
должны быть установлены на первый день месяца. This is a core dimension and is subject to the Deprecation Policy .
Примеры
В следующих примерах запросов используются временные измерения или фильтры:
Примеры каналов
- На основе времени
- Показатели ежедневного времени просмотра видео на канале
- Ежедневные показатели аннотаций для видео канала
- Ежедневные просмотры плейлиста для канала
- Место воспроизведения : количество просмотров за день и время просмотра из разных мест воспроизведения.
- Источник трафика : ежедневное количество просмотров и время просмотра из разных источников трафика.
- Устройство/ОС
- Ежедневные показатели типов устройств для операционной системы Android
- Ежедневные показатели операционной системы для мобильных устройств
- Ежедневные показатели операционной системы и типа устройства
- На основе времени
Примеры владельцев контента
- На основе времени
- Ежедневные показатели времени просмотра самостоятельно загруженного контента
- Метрики аннотаций для заявленного контента
- Ежедневные просмотры плейлиста для владельца контента
- Место воспроизведения : количество просмотров за день и время просмотра из разных мест воспроизведения.
- Источник трафика : ежедневное количество просмотров и время просмотра из разных источников трафика.
- Устройство/ОС
- Ежедневные показатели типа устройства для заявленных видео
- Ежедневные показатели операционной системы для заявленных видео, просмотренных на мобильных устройствах
- Ежедневные показатели операционной системы и типа устройства
- Доход/Эффективность рекламы : ежедневные показатели дохода и эффективности рекламы
- На основе времени
Места воспроизведения
Эти измерения дают представление о странице или приложении, где произошла активность пользователя.
- insightPlaybackLocationType
- Данные в отчете агрегируются на основе типа страницы или приложения, где произошло воспроизведение видео. Возможные значения для этого измерения:
BROWSE
– данные описывают просмотры, которые имели место на домашней странице или главном экране YouTube, в ленте подписок пользователя или в другой функции просмотра YouTube.CHANNEL
– данные описывают просмотры, произошедшие на странице канала.EMBEDDED
– данные описывают просмотры, которые произошли на другом веб-сайте или в приложении, где видео было встроено с помощью<iframe>
или<object>
.EXTERNAL_APP
– данные описывают просмотры, которые произошли в стороннем приложении, где видео воспроизводилось с использованием метода, отличного от встраивания<iframe>
или<object>
. Например, воспроизведения в приложениях, использующих API YouTube Android Player, будут классифицироваться с использованием этого значения.MOBILE
— данные описывают просмотры, которые были совершены на мобильном сайте YouTube или на одобренных клиентах API YouTube, включая мобильные устройства.С 10 сентября 2013 года воспроизведения больше не классифицируются как
MOBILE
воспроизведения в отчетах YouTube Analytics. Значение может остаться в отчетах, поскольку устаревшие данные все еще попадают в эту категорию. Однако после этой даты мобильные воспроизведения классифицируются какWATCH
,EMBEDDED
илиEXTERNAL_APP
воспроизведения, в зависимости от типа приложения, в котором происходят воспроизведения.SEARCH
– данные описывают просмотры, которые имели место непосредственно на странице результатов поиска YouTube.WATCH
– Данные описывают просмотры, которые произошли на странице просмотра видео на YouTube или в официальном приложении YouTube, например, в приложении YouTube для Android.YT_OTHER
– Данные описывают представления, которые не классифицируются иным образом.
- insightPlaybackLocationDetail
- Данные агрегируются на основе страницы, на которой находится проигрыватель. Обратите внимание, что этот отчет поддерживается только для просмотров, которые произошли во встроенных проигрывателях, и он определяет встроенные проигрыватели, которые сгенерировали наибольшее количество просмотров для указанного видео. Таким образом, он обеспечивает более детальное представление, чем отчет о местоположении воспроизведения, путем определения URL-адресов или приложений, связанных с основными встроенными проигрывателями.
Примеры
В следующих примерах запросов используются параметры местоположения воспроизведения:
Примеры каналов
- Место воспроизведения
- Количество просмотров и время просмотра из разных мест воспроизведения
- Количество просмотров в день и время просмотра из разных мест воспроизведения
- Топ-10 – Сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео
- Количество просмотров плейлиста и время просмотра из разных мест воспроизведения
- Количество просмотров плейлиста в день и время просмотра из разных мест воспроизведения
- Место воспроизведения
Примеры владельцев контента
- Место воспроизведения
- Количество просмотров и время просмотра из разных мест воспроизведения
- Количество просмотров в день и время просмотра из разных мест воспроизведения
- Топ-10 – Сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео
- Количество просмотров плейлиста и время просмотра из разных мест воспроизведения
- Количество просмотров плейлиста в день и время просмотра из разных мест воспроизведения
- Место воспроизведения
Подробности воспроизведения
- creatorContentType
- Это измерение определяет тип контента, связанного с метриками активности пользователя в строке данных. Данные для этого измерения доступны для дат, начинающихся с 1 января 2019 года.
В следующей таблице приведены значения измерений:Ценности LIVE_STREAM
Просматриваемый контент представлял собой прямую трансляцию на YouTube . SHORTS
Просмотренный контент представлял собой короткометражный ролик YouTube . STORY
Просмотренный контент представлял собой историю YouTube . VIDEO_ON_DEMAND
Просмотренный контент представлял собой видео YouTube, которое не подпадает ни под одно из других значений измерений. UNSPECIFIED
Тип просматриваемого контента неизвестен. - liveOrOnDemand
- Это измерение указывает, связаны ли показатели активности пользователя в строке данных с просмотрами прямой трансляции. Данные для этого измерения доступны для дат, начинающихся с 1 апреля 2014 года.
В следующей таблице приведены значения измерений:Ценности LIVE
Данные строки описывают активность пользователя, произошедшую во время прямой трансляции. ON_DEMAND
Данные строки описывают активность пользователя, которая не имела места во время прямой трансляции. - subscribedStatus
- Это измерение указывает, связаны ли показатели активности пользователя в строке данных со зрителями, которые подписались на канал видео или плейлиста. Возможные значения:
SUBSCRIBED
иUNSUBSCRIBED
.
Обратите внимание, что значение измерения является точным на момент совершения пользователем действия. Например, предположим, что пользователь не подписался на канал и смотрит одно из видео этого канала, затем подписывается на канал и смотрит другое видео, все в тот же день. Отчет канала показывает, что одно представление имеетsubscribedStatus
значениеSUBSCRIBED
, а одно представление имеетsubscribedStatus
значениеUNSUBSCRIBED
. - youtubeProduct
- Это измерение определяет сервис YouTube, на котором произошла активность пользователя. Данные по этому измерению доступны по состоянию на 18 июля 2015 г.
В следующей таблице приведены значения измерений:Ценности CORE
Активность пользователя, которая не произошла ни в одном из специализированных приложений YouTube (YouTube Gaming, YouTube Kids или YouTube Music). Исключение: активность пользователя, которая произошла в YouTube Music до 1 марта 2021 года, включена в CORE
.GAMING
Активность пользователя произошла в YouTube Gaming. KIDS
Активность пользователя наблюдалась в YouTube Kids. MUSIC
Активность пользователя произошла в YouTube Music 1 марта 2021 года или позже. Данные до 1 марта 2021 года включены в CORE
. Данные в реальном времени не регистрируются.UNKNOWN
Активность пользователя имела место до 18 июля 2015 года.
Источники трафика
- insightTrafficSourceType
- Данные в отчете агрегируются на основе типа реферера, который описывает способ, которым пользователи достигли видео. Возможные значения для этого измерения:
-
ADVERTISING
– Зритель перешел на видео по рекламе. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
определяет тип рекламы. -
ANNOTATION
– Зрители перешли на видео, нажав на аннотацию в другом видео. -
CAMPAIGN_CARD
– Просмотры, полученные из заявленных, загруженных пользователем видео, которые владелец контента использовал для продвижения просмотренного контента. Этот источник трафика поддерживается только для отчетов владельца контента. -
END_SCREEN
– Просмотры были получены с конечного экрана другого видео. -
EXT_URL
– просмотры видео были направлены по ссылке на другом веб-сайте. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
идентифицирует веб-страницу. Этот источник трафика включает переходы из результатов поиска Google. -
HASHTAGS
– Просмотры, полученные со страниц хэштегов VOD или опорных страниц хэштегов Shorts. -
LIVE_REDIRECT
— просмотры видео были перенаправлены с помощью Live Redirects . -
NO_LINK_EMBEDDED
– Видео было встроено на другой веб-сайт во время просмотра. -
NO_LINK_OTHER
– YouTube не определил реферер для трафика. Эта категория охватывает прямой трафик на видео, а также трафик на мобильные приложения. -
NOTIFICATION
– Просмотры видео были получены из электронного письма или уведомления от YouTube. -
PLAYLIST
– Просмотры видео произошли, когда видео воспроизводилось как часть плейлиста. Он включает трафик, поступающий со страницы плейлиста. -
PRODUCT_PAGE
— просмотры видео были осуществлены со страницы продукта. -
PROMOTED
– просмотры видео были получены с помощью неоплачиваемого продвижения на YouTube, например со страницы YouTube «Видео в центре внимания». -
RELATED_VIDEO
– Просмотры видео были направлены из связанного списка видео на другой странице просмотра видео. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
указывает идентификатор видео для этого видео. -
SHORTS
– Зритель перешел на этот сайт, проведя пальцем по вертикали от предыдущего видео в разделе Shorts. -
SOUND_PAGE
– Просмотры, полученные со страниц со звуком Shorts. -
SUBSCRIBER
– просмотры видео были направлены из каналов на главной странице YouTube или из функций подписки YouTube. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
указывает элементы канала на главной странице или другую страницу, с которой были направлены просмотры. -
YT_CHANNEL
– Просмотры видео произошли на странице канала. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
указывает идентификатор канала для этого канала. -
YT_OTHER_PAGE
– просмотры видео были направлены по ссылке, отличной от результата поиска или ссылки на связанное видео, которая появилась на странице YouTube. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
идентифицирует страницу. -
YT_SEARCH
– Просмотры видео были получены из результатов поиска YouTube. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
указывает поисковый термин. -
VIDEO_REMIXES
– просмотры видео были направлены по ссылке на ремиксованное видео в проигрывателе Shorts. Если вы фильтруете на основе этого источника трафика, полеinsightTrafficSourceDetail
указывает видео, с которого был направлен зритель.
-
- insightTrafficSourceDetail
- Данные в отчете агрегируются на основе рефереров, которые сгенерировали наибольшее количество просмотров для указанного видео и указанного типа источника трафика. Следующий список определяет источники трафика , для которых доступен этот отчет. Для каждого источника трафика список определяет информацию, которую предоставляет измерение
insightTrafficSourceDetail
.-
ADVERTISING
– Тип рекламы, которая привела к просмотрам. Возможные значения:- Реклама для вовлечения по клику
- Реклама для вовлечения
- Реклама в поиске Google
- Видеореклама на домашней странице
- Зарезервировано для пропуска в потоке
- TrueView в поиске и на дисплее
- TrueView в потоке
- Реклама на YouTube без рубрики
- Видеостена
-
CAMPAIGN_CARD
– заявленное видео, которое привело зрителей к видео, указанному в отчете. -
END_SCREEN
– Видео, которое привело зрителей к видео, указанному в отчете. -
EXT_URL
– веб-сайт, с которого зрители перешли на видео. -
HASHTAGS
— хэштег, который привел к просмотрам. -
NOTIFICATION
– электронное письмо или уведомление, на которое был направлен трафик. -
RELATED_VIDEO
– связанное видео, которое привело зрителей к видео, упомянутому в отчете. -
SOUND_PAGE
– Видео, которое привело к просмотрам. -
SUBSCRIBER
– элемент фида домашней страницы или функция подписки YouTube, которая привела зрителей к видео, о котором идет речь в отчете. Допустимые значения:-
activity
— просмотры элементов в лентах подписок на главной странице, которые возникли в результате активности канала, не связанной с загрузкой и социальными сетями, включая отметки «Нравится», избранное, сообщения в бюллетенях и добавления в плейлисты. -
blogged
– Просмотры элементов в лентах подписок на главной странице, которые появились в результате переходов по ссылкам из популярных блогов. -
mychannel
– просмотры элементов в других лентах, перечисленных на главной странице, таких как «Нравится», «История просмотра» и «Посмотреть позже». -
podcasts
– Просмотры, происходящие из элементов на целевой странице Подкасты. -
sdig
– Просмотры, полученные из писем об обновлении подписки. -
uploaded
– просмотрыuploaded
элементов в лентах подписки на главной странице. -
/
– Другие просмотры с домашней страницы YouTube. -
/my_subscriptions
– Просмотры со страниц « Мои подписки» пользователей на YouTube.
-
-
YT_CHANNEL
– Страница канала, на котором зрители посмотрели видео. -
YT_OTHER_PAGE
– Страница YouTube, с которой зрители перешли на видео. -
YT_SEARCH
– поисковый запрос, который привел зрителей к видео. -
VIDEO_REMIXES
– Видео, которое привело к просмотрам.
-
Примеры
В следующих примерах запросов используются параметры источника трафика:
Примеры каналов
- Источник трафика
- Количество просмотров и время просмотра из разных источников трафика в стране
- Ежедневное количество просмотров и время просмотра из разных источников трафика
- Топ-10 – поисковые запросы на YouTube, которые генерируют больше всего трафика для видео
- Топ-10 – поисковые запросы Google, которые генерируют больше всего трафика для видео
- Количество просмотров плейлиста и время просмотра из разных источников трафика в стране
- Ежедневное количество просмотров плейлиста и время просмотра из разных источников трафика
- Источник трафика
Примеры владельцев контента
- Источник трафика
- Количество просмотров и время просмотра из разных источников трафика
- Ежедневное количество просмотров и время просмотра из разных источников трафика
- Топ-10 – поисковые запросы на YouTube, которые генерируют больше всего трафика для видео
- Топ-10 – поисковые запросы Google, которые генерируют больше всего трафика для видео
- Количество просмотров плейлиста и время просмотра из разных источников трафика в стране
- Ежедневное количество просмотров плейлиста и время просмотра из разных источников трафика
- Источник трафика
Устройства
- deviceType
- Это измерение определяет физический форм-фактор устройства, на котором произошло представление. Следующий список определяет типы устройств, для которых API возвращает данные. Вы также можете использовать измерение
deviceType
в качестве фильтра, чтобы ограничить отчет операционной системы, чтобы он содержал только данные для определенного типа устройства.-
DESKTOP
-
GAME_CONSOLE
-
MOBILE
-
TABLET
-
TV
-
UNKNOWN_PLATFORM
-
- operatingSystem
- Это измерение определяет программную систему устройства, на котором произошло представление. Следующий список определяет операционные системы, для которых API возвращает данные. Вы также можете использовать
operatingSystem
в качестве фильтра, чтобы ограничить отчет о типе устройства, чтобы он содержал только данные для определенной операционной системы.-
ANDROID
-
BADA
-
BLACKBERRY
-
CHROMECAST
-
DOCOMO
-
FIREFOX
-
HIPTOP
-
IOS
-
KAIOS
-
LINUX
-
MACINTOSH
-
MEEGO
-
NINTENDO_3DS
-
OTHER
-
PLAYSTATION
-
PLAYSTATION_VITA
-
REALMEDIA
-
SMART_TV
-
SYMBIAN
-
TIZEN
-
VIDAA
-
WEBOS
-
WII
-
WINDOWS
-
WINDOWS_MOBILE
-
XBOX
-
Примеры
В следующих примерах запросов используются размеры устройства:
Примеры каналов
- Устройство/ОС
- Ежедневные показатели типов устройств для операционной системы Android
- Ежедневные показатели операционной системы для мобильных устройств
- Ежедневные показатели операционной системы и типа устройства
- Ежедневные показатели типов устройств для просмотров плейлистов на операционной системе Android
- Ежедневные показатели операционной системы по просмотрам плейлистов на мобильных устройствах
- Устройство/ОС
Примеры владельцев контента
- Устройство/ОС
- Ежедневные показатели типа устройства для заявленных видео
- Ежедневные показатели операционной системы для заявленных видео, просмотренных на мобильных устройствах
- Ежедневные показатели операционной системы и типа устройства
- Ежедневные показатели типов устройств для просмотров плейлистов на операционной системе Android
- Ежедневные показатели операционной системы по просмотрам плейлистов на мобильных устройствах
- Устройство/ОС
Демография
Демографические измерения помогают вам понять возрастной диапазон и гендерное распределение вашей аудитории. Справочный центр YouTube содержит дополнительную информацию о демографических данных в отчетах YouTube Analytics .
- ageGroup (core dimension)
- Это измерение определяет возрастную группу вошедших в систему пользователей, связанных с данными отчета. API использует следующие возрастные группы:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (core dimension)
- Это измерение определяет пол вошедших в систему пользователей, связанных с данными отчета. Допустимые значения:
female
,male
иuser_specified
. This is a core dimension and is subject to the Deprecation Policy .
Примеры
В следующих примерах запросов используются демографические параметры:
Примеры каналов
- Демографический
- Демографические данные зрителей в Калифорнии (возрастная группа и пол)
- Демографические данные зрителей плейлиста в Калифорнии (возрастная группа и пол)
- Демографический
Примеры владельцев контента
- Демографический
- Демографические данные зрителей в Калифорнии (возрастная группа и пол)
- Демографические данные зрителей плейлиста в Калифорнии (возрастная группа и пол)
- Демографический
Взаимодействие и обмен контентом
- Это измерение определяет службу, которая использовалась для распространения видео. Видео можно распространять на YouTube (или через проигрыватель YouTube) с помощью кнопки «Поделиться». This is a core dimension and is subject to the Deprecation Policy .
В следующей таблице перечислены допустимые значения размеров:Совместное использование услуг Значение API Амеба AMEBA
Электронная почта Android ANDROID_EMAIL
Android-мессенджер ANDROID_MESSENGER
Android-сообщения ANDROID_MMS
BlackBerry Messenger BBM
Блоггер BLOGGER
Копировать в буфер обмена COPY_PASTE
Cyworld CYWORLD
Дигг DIGG
Дропбокс DROPBOX
Встроить EMBED
Электронная почта MAIL
Фейсбук FACEBOOK
Фейсбук Мессенджер FACEBOOK_MESSENGER
Страницы Facebook FACEBOOK_PAGES
Фотка FOTKA
Gmail GMAIL
идти GOO
Гугл+ GOOGLEPLUS
Отправьте СМС GO_SMS
ГруппаЯ GROUPME
Тусовки HANGOUTS
привет5 HI5
Текстовое сообщение HTC HTC_MMS
Входящие Google INBOX
Диалоговое окно активности системы iOS IOS_SYSTEM_ACTIVITY_DIALOG
История КАКАО KAKAO_STORY
Какао (Kakao Talk) KAKAO
Кик KIK
Электронная почта LGE LGE_EMAIL
Линия LINE
Линкедин LINKEDIN
Живой Журнал LIVEJOURNAL
менеаме MENEAME
микс MIXI
Сообщения Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Навер NAVER
Поделиться поблизости NEARBY_SHARE
Нуджидж NUJIJ
Одноклассники (Одноклассники) ODNOKLASSNIKI
Другой OTHER
Пинтерест PINTEREST
Ракутен (楽天市場) RAKUTEN
реддит REDDIT
скайп SKYPE
Скайрок SKYBLOG
Беседы Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Телеграмма TELEGRAM
Текстовое сообщение TEXT_MESSAGE
Туэнти TUENTI
тамблер. TUMBLR
Твиттер TWITTER
Неизвестный UNKNOWN
Сообщения Verizon VERIZON_MMS
Вайбер VIBER
ВКонтакте (ВКонтакте) VKONTAKTE
WeChat WECHAT
Вейбо WEIBO
WhatsApp WHATS_APP
Выкоп WYKOP
Yahoo! Япония YAHOO
YouTube-гейминг YOUTUBE_GAMING
YouTube Дети YOUTUBE_KIDS
YouTube Музыка YOUTUBE_MUSIC
Ютуб ТВ YOUTUBE_TV
Более подробную информацию смотрите в справочной документации .
Примеры
В следующих примерах запросов используются социальные измерения:
Примеры каналов
- Социальные сети : показатели распространения, агрегированные по сервисам, на которых были распространены видео.
Примеры владельцев контента
- Социальные сети : показатели распространения, агрегированные по сервисам, на которых были распространены видео.
Удержание аудитории
- elapsedVideoTimeRatio
- Это измерение определяет отношение прошедшей части видео к его длине. Измерения и метрики удержания используются для измерения удержания аудитории с течением времени, а измерение
elapsedVideoTimeRatio
является измерением времени. Например, значение0.4
указывает, что соответствующие данные отчета показывают данные удержания после того, как прошло 40 процентов видео.
API возвращает 100 точек данных для каждого видео со значениями отношения в диапазоне от0.01
до1.0
. Время, в которое данные измеряются во время воспроизведения видео, одинаково распределено для каждого видео. Это означает, что для двухминутного видео интервал между точками данных составляет 1,2 секунды. Однако для двухчасового видео интервал между точками данных составляет 72 секунды. Значение измерения обозначает исключительный конец интервала. - audienceType (filter only)
- Значение измерения определяет тип трафика, связанного с данными отчета. Поддерживаемые значения:
ORGANIC
,AD_INSTREAM
иAD_INDISPLAY
. См. Справочный центр YouTube для объяснений этих типов источников трафика.
Обратите внимание, что данные для фильтраaudienceType
доступны по состоянию на 25 сентября 2013 г. API не возвращает данные для запросов, которые используют фильтр для попытки извлечь данные из более ранних дат. Запросы, которые не используют фильтр, работают для любой даты после 1 июля 2008 г.
Примеры
В следующих примерах запросов используются параметры удержания аудитории:
Примеры каналов
- Удержание аудитории : показатели удержания аудитории для видео
Примеры владельцев контента
- Удержание аудитории : показатели удержания аудитории для видео
Прямая трансляция
- livestreamPosition
- Это измерение определяет конкретную минуту во время прямой трансляции видео. Метрики отчета показывают, сколько пользователей смотрели прямую трансляцию в это время.
Аннулирование членства
- membershipsCancellationSurveyReason
- Количество опросов, завершенных пользователями YouTube, которые отменили свое членство на указанном канале в течение отчетного периода. В следующей таблице перечислены допустимые значения измерений:
Значение API Объяснение UNKNOWN
Пользователь не завершил опрос. DISLIKE_PERKS
Пользователю не понравились преимущества членства. PERKS_NOT_DELIVERED
Пользователь сообщил, что обещанные привилегии членства не были предоставлены. CANNOT_ACCESS_PERKS
Пользователь не смог получить доступ к льготам. NO_LONGER_INTERESTED
Пользователь больше не заинтересован в членстве на канале. FEEL_UNAPPRECIATED
Пользователь чувствовал себя недооцененным как участник канала. FINANCIAL_REASONS
Пользователь отменил подписку по финансовым причинам. JOIN_LIMITED_TIME
Пользователь намеревался присоединиться только на ограниченное время. OTHER
У пользователя была другая причина отмены.
Эффективность рекламы
- adType
- Измерение
adType
используется в отчетах об эффективности рекламы и объединяет запрошенные метрики на основе типов объявлений, которые показывались во время воспроизведения видео. В следующем списке объясняются возможные значения измерения. Дополнительную информацию о форматах рекламы YouTube см. в Справочном центре YouTube .auctionBumperInstream
– видеореклама без возможности пропуска, размещаемая через аукцион, продолжительностью до 6 секунд, которую необходимо просмотреть перед просмотром видео.auctionDisplay
– мультимедийная или графическая реклама, которая отображается либо как наложение в нижней части видеоплеера, либо как рекламный блок 300x250 на странице просмотра видео, либо как комбинация того и другого. Когда наложение запускается, оно автоматически закрывается после отображения в течение определенного времени, и пользователь может закрыть наложение. Если наложение и баннер отображаются вместе, каждое объявление считается отдельным показом.auctionInstream
– видеореклама без возможности пропуска, которая показывается до, во время или после основного видео.auctionTrueviewInslate
– Зритель выбирает одну из нескольких видеореклам из набора вариантов, отображаемых перед видео. See the TrueView documentation for more information.auctionTrueviewInstream
– Видеореклама с возможностью пропуска, которая показывается до или во время основного видео. Подробнее см. в документации TrueView .auctionUnknown
– объявление, купленное на аукционе AdWords, но не отнесенное ни к одному из других типов объявлений.reservedBumperInstream
– видеореклама без возможности пропуска, продается на условиях резервирования, длительностью до 6 секунд, которую необходимо просмотреть перед просмотром видео.reservedClickToPlay
– Видеореклама, которую пользователь должен нажать, чтобы начать воспроизведение. Показ рекламы регистрируется каждый раз, когда отображается рекламный блок click-to-play, независимо от того, инициировал ли пользователь воспроизведение. Они продаются на зарезервированной основе.reservedDisplay
– мультимедийная или графическая реклама, которая отображается либо как наложение в нижней части видеоплеера, либо как рекламный блок 300x250 на странице просмотра видео, либо как комбинация того и другого. Когда наложение запускается, оно автоматически закрывается после отображения в течение определенного времени, и пользователь также может закрыть наложение. Если наложение и баннер отображаются вместе, каждое объявление считается отдельным показом.reservedInstream
– непропускаемые видеообъявления, которые вставляются до, во время или после основного видео.reservedInstreamSelect
reservedMasthead
– большое рекламное объявление, которое может включать видео и графические элементы, отображаемое на главной странице.reservedUnknown
– объявление, проданное на зарезервированной основе, которое не может быть отнесено ни к одному из других типов объявлений.unknown
– YouTube не смог классифицировать этот тип рекламы.
Примеры
Следующие пример отчетов о получении рекламы или показателей доходов:
Примеры канала
- Доход/реклама
- Метрики доходов от канала и производительность рекламы
- Ежедневные доходы и показатели эффективности рекламы
- Страновые доходы и показатели эффективности рекламы
- Топ -10 - видео с самым высоким доходом
- Метрики производительности рекламы для разных типов рекламы
- Доход/реклама
Примеры владельца контента
- Доход/реклама
- Метрики доходов и производительности рекламы для заявленного контента
- Ежедневные доходы и показатели эффективности рекламы
- Страновые доходы и показатели эффективности рекламы
- Топ -10 - видео с самым высоким доходом
- Метрики производительности рекламы для разных типов рекламы
- Доход/реклама
Размеры владельца контента
Следующие измерения поддерживаются только для отчетов владельца контента.
- claimedStatus (only used in content owner reports)
- Это измерение позволяет указать, что ответ API должен содержать только метрики только для заявленного контента. Единственное действительное значение для этого измерения
claimed
. Если параметрfilters
ограничивает запросclaimedStatus==claimed
, API получит только данные только для заявленного контента. Таблица в определении измеренияuploaderType
дает более подробную информацию о том, как использовать это измерение.
- uploaderType (core dimension) (only used in content owner reports)
- Это измерение позволяет указать, должен ли ответ API содержать метрики для контента, загруженного указанным владельцем контента и/или контентом, загруженным третьими лицами, такими как видеопогруженные видео. Допустимые значения являются
self
иthirdParty
. Это основное измерение и подлежит политике снижения .
В таблице ниже показаны поддерживаемые комбинации для измеренийclaimedStatus
иuploaderType
, которые оба используются в параметреfilters
:claimedStatus
стоимостьuploaderType
значениеОписание [Не установлен] self Получает данные YouTube Analytics для заявленного и невостребованного контента, загруженного владельцем контента. claimed [Не установлен] Получает данные для заявленного контента, загруженного владельцем контента или третьей стороной. claimed self Получает данные для заявленного контента, загруженного владельцем контента. claimed thirdParty Получает данные для заявленного контента, загруженного третьей стороной.
Примеры
Многие из запросов API выборки для отчетов владельца контента используют поддерживаемую комбинацию измерений claimedStatus
и uploaderType
для фильтрации данных.