Информация для авторов YouTube

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

API имеет четыре основные функции:

  1. Поиск авторов: находите подходящих авторов по заданному набору тем, демографическим характеристикам, целевой аудитории или параметрам авторов.
  2. Анализ тематики контента: Получите информацию о соответствующих авторах, создающих контент по заданным темам.
  3. Аналитика для создателей контента: получайте информацию о конкретных каналах YouTube, такую ​​как количество подписчиков, количество просмотров и демографические данные аудитории.
  4. Анализ трендов: получайте аналитические данные о конкретных трендах на основе целевой аудитории или тем.

Поиск авторов на местном уровне (поиск авторов, которые находятся в определенной стране или публикуют контент из этой страны и просматриваются в этой стране) поддерживается при использовании поиска авторов по темам или анализа трендов путем запроса дополнительных данных.

Требования к участию

GenerateCreatorInsights — это закрытый компонент API Google Ads, предоставляемый по неисключительной, безвозмездной лицензии на использование данных. Партнеры, заключившие соглашение, могут использовать стандартные клиентские библиотеки Google Ads для анализа создателей контента и его публикаций на YouTube. Для участия партнеры должны соответствовать следующим условиям:

  • Необходимо иметь инструмент планирования или пользовательский интерфейс, который будет интегрироваться с API Google Ads.
  • Используйте API для поиска контента и авторов на YouTube с целью выявления потенциальных рекламных возможностей.
  • Пройдите предварительную оценку, чтобы убедиться в соответствии критериям.
  • Соблюдайте требования к использованию данных и будьте готовы проходить периодические проверки данных.
  • Подпишите лицензионное соглашение на использование данных, которое юридически закрепляет требования к использованию данных.
  • Примите условия использования Google Ads API.

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

Получите ценные сведения о создателях контента.

Для получения информации о создателях контента отправьте запрос методу GenerateCreatorInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS). Он принимает различные типы входных данных в зависимости от того, хотите ли вы повысить узнаваемость создателей контента, найти релевантных создателей по темам или получить информацию о создателях контента. Необходимо указать страны, из которых вы хотите получить данные.

  1. Доступность авторов: Вы можете указать список атрибутов аудитории, таких как возраст, пол и интересы пользователей (включая аудитории по интересам, аудитории, находящиеся на рынке, и аудитории, связанные с жизненными событиями). API возвращает список авторов, чья аудитория соответствует этим атрибутам. Вы также можете указать атрибуты авторов для фильтрации контента, который точно соответствует указанным вами атрибутам.

    Вы можете получить доступные атрибуты аудитории, используя ListAudienceInsightsAttributes , указав измерения, для которых вам нужны атрибуты, например, KNOWLEDGE_GRAPH для интересующих вас тем.

    Начиная с версии Google Ads API v23, вы можете указывать сложные взаимосвязи атрибутов аудитории с помощью audience_combinations . Это поле позволяет определять аудитории с использованием булевой логики (AND/OR), что невозможно с помощью audience_attributes .

    В то время как audience_attributes подходит для таргетинга на основе списка объединенных (с помощью ИЛИ) атрибутов (например, пользователи, интересующиеся «спортом» ИЛИ «путешествиями» ИЛИ ...), audience_combinations предлагает более детальный контроль. Каждая группа InsightsAudienceAttributeGroup в audience_combinations объединяет атрибуты с помощью логического ИЛИ. Затем эти группы объединяются с помощью логического И.

    Например, чтобы нацелиться на аудиторию, интересующуюся («Уход за кожей» ИЛИ «Уход за волосами») И также «Косметикой», вам нужно использовать два элемента InsightsAudienceAttributeGroup в audience_combinations . «Уход за кожей», «Уход за волосами» и «Косметика» — это темы, представляющие интерес, которые представлены сущностями Knowledge Graph (например, /m/014trl для «Косметики»). Первая группа будет содержать атрибуты сущностей Knowledge Graph для «Ухода за кожей» и «Ухода за волосами», а вторая группа будет содержать атрибут сущности Knowledge Graph для «Косметики».

    Обратите внимание, что если вы указываете сущности Графа знаний, категории товаров и услуг или интересы пользователей в audience_attributes , вы не можете использовать audience_combinations . Если вы используете audience_combinations , вы должны указать эти атрибуты внутри audience_combinations , а не в audience_attributes ; однако вы все еще можете использовать audience_attributes для других типов атрибутов, таких как демографические данные, в сочетании с audience_combinations .

  2. Информация о тематике контента от авторов: укажите список тем контента, используя поле search_topics . API вернет релевантных авторов, создающих контент по указанным темам. Полученные данные основаны на стране, указанной в country_locations . Обратите внимание, что этот параметр позволяет искать только по одной стране.

    Поддерживаемые сущности в поле SearchTopics должны быть помечены либо тегом CONTENT_TRENDING_INSIGHTS , либо CREATOR_TOPIC_INSIGHTS . Используйте метод ListAudienceInsightsAttributes для получения информации о поддерживаемых возможностях сущностей.

    Примечание: параметр search_brand был объявлен устаревшим в версии 24.2 и удален в версии 25. Используйте вместо него search_topics .

  3. Аналитика для создателей контента: укажите список идентификаторов каналов YouTube, используя поле search_channels . API вернет информацию именно об этих каналах.

Дополнительные данные и местные авторы

По умолчанию возвращаются только основные аналитические данные. Вы можете запросить дополнительные функции и данные в ответе, установив повторяющееся поле supplemental_data .

Например, вы можете запросить данные о местных авторах, добавив значение перечисления LOCAL_CREATOR_DATA в поле supplemental_data . Если вы ищете авторов с помощью search_topics (и тема является сущностью Knowledge Graph, помеченной возможностью CREATOR_TOPIC_INSIGHTS ), API заполнит поле local_creator_insights в ответе данными о местных авторах, которые дали согласие на предоставление данных о своем местоположении.

Обратите внимание на следующие параметры для локального обнаружения создателей контента:

  • Определение: «Местные авторы» — это авторы, которые проживают в выбранной стране или публикуют контент из этой страны, и их работы просматриваются в этой стране.
  • Ограничение: Локальное обнаружение создателей контента не поддерживается, если в запросе задан sub_country_locations .
  • Возможности: Вы можете получить список поддерживаемых сущностей Графа знаний и их возможностей, используя ListAudienceInsightsAttributes .

Метод generateCreatorInsights возвращает объект GenerateCreatorInsightsResponse . Этот объект содержит следующие поля:

  • creator_insights : Список объектов YouTubeCreatorInsights , соответствующих вашим основным критериям.
  • local_creator_insights : Список объектов YouTubeCreatorInsights для локальных авторов. Этот список заполняется только в том случае, если был запрошен LOCAL_CREATOR_DATA , а в качестве критерия использовался search_topics .

Каждый объект YouTubeCreatorInsights содержит следующую информацию о создателе контента:

  • Имя создателя
  • YouTube-канал
  • Общие показатели создателей контента
  • Список аналитических данных YouTube-каналов

Объект YouTubeMetrics содержит следующие метрики:

  • Количество подписчиков
  • Количество просмотров
  • Количество видео
  • Активный создатель коротких видеороликов.
  • Возможности для партнерства (начиная с версии 23)

Чтобы определить, имеет ли автор право на сотрудничество в создании оригинального брендированного контента, проверьте partnership_opportunities ; автор имеет право на участие, если в списке присутствует значение CREATOR_PARTNERSHIPS .

Объект YouTubeChannelInsights содержит следующую информацию о канале YouTube:

  • Название канала
  • Идентификатор канала
  • URL канала
  • Описание канала
  • Показатели канала
  • Атрибуты аудитории канала (такие как возраст, пол и распределение интересов пользователей)
  • Лучшие видео
  • Тип канала
  • Языки, связанные с контентом канала.
  • Показатель релевантности (только для поиска по трендам тем)
  • Дал ли создатель согласие на передачу непубличных метрик?

Для получения аналитических данных о тенденциях отправьте запрос методу GenerateTrendingInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS). Он принимает два типа входных данных в зависимости от того, хотите ли вы получить тенденции аудитории или тенденции тем. Необходимо указать конкретную страну, из которой вы хотите получить тенденции.

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

    Вы можете получить доступные атрибуты аудитории, используя ListAudienceInsightsAttributes , указав измерения, для которых вам нужны атрибуты, например, KNOWLEDGE_GRAPH для интересующих вас тем.

    Начиная с версии Google Ads API v23, вы можете указывать сложные взаимосвязи атрибутов аудитории с помощью audience_combinations . Это поле позволяет определять аудитории с использованием булевой логики (AND/OR), что невозможно с помощью audience_attributes .

    В то время как audience_attributes подходит для таргетинга на основе списка объединенных (с помощью ИЛИ) атрибутов (например, пользователи, интересующиеся «спортом» ИЛИ «путешествиями» ИЛИ ...), audience_combinations предлагает более детальный контроль. Каждая группа InsightsAudienceAttributeGroup в audience_combinations объединяет атрибуты с помощью логического ИЛИ. Затем эти группы объединяются с помощью логического И.

    Например, чтобы нацелиться на аудиторию, интересующуюся («Уход за кожей» ИЛИ «Уход за волосами») И также «Косметикой», вам нужно использовать два элемента InsightsAudienceAttributeGroup в audience_combinations . «Уход за кожей», «Уход за волосами» и «Косметика» — это темы, представляющие интерес, которые представлены сущностями Knowledge Graph (например, /m/014trl для «Косметики»). Первая группа будет содержать атрибуты сущностей Knowledge Graph для «Ухода за кожей» и «Ухода за волосами», а вторая группа будет содержать атрибут сущности Knowledge Graph для «Косметики».

    Обратите внимание, что если вы указываете сущности Графа знаний, категории товаров и услуг или интересы пользователей в audience_attributes , вы не можете использовать audience_combinations . Если вы используете audience_combinations , вы должны указать эти атрибуты внутри audience_combinations , а не в audience_attributes ; однако вы все еще можете использовать audience_attributes для других типов атрибутов, таких как демографические данные, в сочетании с audience_combinations .

    Атрибуты KNOWLEDGE_GRAPH будут содержать один или несколько тегов InsightsKnowledgeGraphEntityCapabilities . Атрибуты, поддерживаемые для анализа трендов, будут иметь соответствующие теги в метаданных ответа.

    Обратите внимание, что разработчики, имеющие доступ к ContentCreatorInsightsService также автоматически получат доступ к AudienceInsightsService.ListAudienceInsightsAttributes . Для других конечных точек в AudienceInsightsService требуется отдельный процесс создания списка разрешенных объектов.

    Дополнительную документацию по ListAudienceInsightsAttributes можно найти в руководстве по Audience Insights .

  2. Тенденции по темам: Укажите список тем контента. API вернет список аналитических данных о тенденциях по этим темам, включая такие показатели, как процентное изменение значения тренда за сравниваемый период.

Аналогично формированию аналитических данных о создателях контента, вы можете запросить дополнительные функции в аналитических данных о трендах, установив для повторяющегося поля supplemental_data значение LOCAL_CREATOR_DATA .

Если ваш запрос на поиск трендов использует search_topics , это заполнит поле related_local_creators в возвращаемых объектах TrendInsight информацией о связанных локальных авторах для запрошенной темы, которые дали согласие на предоставление данных о своем местоположении. Поиск локальных авторов подчиняется тем же определениям и ограничениям (например, несовместимость с sub_country_locations ).

Метод GenerateTrendingInsights возвращает список объектов TrendInsight , каждый из которых содержит:

  • trend_attribute : Основные метаданные AudienceInsightsAttributeMetadata для тренда.
  • trend_metrics : Показатели тренда, например, процентное изменение за сравниваемый период.
  • trend_data_points : Исторические данные по тренду. Заполняется только для трендов, использующих search_topics .
  • related_videos : Список объектов AudienceInsightsAttributeMetadata для трендовых видеороликов, связанных с темой тренда. Заполняется только для трендов, использующих search_topics . Для этих атрибутов заполняется вложенный объект YouTubeVideoAttributeMetadata , который содержит метаданные уровня видео (такие как URL видео, URL миниатюры и количество просмотров или лайков) и метаданные уровня канала (такие как идентификатор канала, название и URL).
Назад
Статистика аудитории