Информация для авторов 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 and local creators

По умолчанию возвращаются только основные аналитические данные. Вы можете запросить дополнительные функции и данные в ответе, установив повторяющееся поле 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 или BRAND_SENTIMENT_DATA .

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

Если ваш запрос на поиск трендов использует search_topics , установка supplemental_data в значение BRAND_SENTIMENT_DATA заполнит поле brand_sentiment_insights в возвращаемых объектах TrendInsight , если запрошенная тема сущности Knowledge Graph имеет возможность BRAND . Тема бренда — это сущность, помеченная возможностью BRAND . Вы можете получить информацию о поддерживаемых возможностях сущностей, используя метод ListAudienceInsightsAttributes .

Измерение отношения к бренду предполагает использование моделей искусственного интеллекта (на базе Gemini) для анализа видеоконтента на YouTube, связанного с брендом, с классификацией отношения как положительного, отрицательного или нейтрального. Анализируется только сам видеоконтент; комментарии пользователей не учитываются.

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

  • trend_attribute : Основные метаданные AudienceInsightsAttributeMetadata для тренда.
  • trend_metrics : Показатели тренда, например, процентное изменение за сравниваемый период.
  • trend_data_points : Исторические данные по тренду. Заполняется только для трендов, использующих search_topics .
  • related_videos : A list of AudienceInsightsAttributeMetadata objects for trending videos associated with the trend's topic. Only populated for trends using search_topics . For these attributes, the nested YouTubeVideoAttributeMetadata is populated, which contains video-level metadata (such as the video URL, thumbnail URL, and view or like counts) and channel-level metadata (such as the channel ID, name, and URL).
  • brand_sentiment_insights : Список объектов BrandSentimentInsight для тренда. Заполняется только в том случае, если запрос тренда использует search_topics , тема сущности Knowledge Graph имеет возможность BRAND , и BRAND_SENTIMENT_DATA запрашивается в supplemental_data . Каждый объект BrandSentimentInsight содержит:
    • month : Месяц, который отражает отношение к бренду в формате YYYY-MM .
    • has_insufficient_data : Указывает, недостаточно ли данных для расчета отношения к бренду.
    • sentiment_distributions : Распределение настроений между положительными, отрицательными и нейтральными, рассчитываемое как доля просмотров видеороликов, соответствующих бренду с каждым из этих настроений.
    • sentiment_summaries : Сгенерированные ИИ сводки положительных и отрицательных отзывов о контенте, связанном с брендом, а также примеры видеороликов для каждого уровня тональности. Сводки генерируются только для положительных и отрицательных отзывов, но не для нейтральных.
Назад
Статистика аудитории