Функция анализа контента позволяет получать ценную информацию о создателях контента на YouTube. Это может быть полезно для агентств и рекламодателей, которые хотят найти авторов, соответствующих их целевой аудитории.
API имеет четыре основные функции:
- Поиск авторов: найдите лучших авторов по заданному набору тем, демографическим характеристикам, целевой аудитории или параметрам авторов.
- Аналитика брендов среди создателей контента: получите информацию о создателях контента, связанных с конкретным брендом.
- Аналитика для создателей контента: получайте информацию о конкретных каналах YouTube, такую как количество подписчиков, количество просмотров и демографические данные аудитории.
- Анализ трендов: получайте аналитические данные о конкретных трендах на основе целевой аудитории или тем.
Требования к участию
ContentCreatorInsightsService.GenerateCreatorInsights — это закрытый компонент API Google Ads, предоставляемый по неисключительной, безвозмездной лицензии на использование данных. Партнеры, заключившие соглашение, могут использовать стандартные клиентские библиотеки Google Ads для анализа контента и деятельности авторов на YouTube. Для участия партнеры должны соответствовать следующим условиям:
- Необходимо иметь инструмент планирования или пользовательский интерфейс, который будет интегрироваться с API Google Ads.
- Используйте API для поиска контента и авторов на YouTube с целью выявления потенциальных рекламных возможностей.
- Пройдите предварительную оценку, чтобы убедиться в соответствии критериям.
- Соблюдайте требования к использованию данных и будьте готовы проходить периодические проверки данных.
- Подпишите лицензионное соглашение на использование данных, которое юридически закрепляет требования к использованию данных.
- Примите условия использования Google Ads API.
Для получения дополнительной информации обратитесь к представителю Google.
Получите ценные сведения о создателях контента.
Для получения аналитических данных о создателях контента отправьте запрос методу ContentCreatorInsightsService.GenerateCreatorInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS) и принимает три типа входных данных в зависимости от того, хотите ли вы получить данные о видимости создателей контента, аналитические данные о бренде создателей или аналитические данные о самих создателях контента. Необходимо указать страны, из которых вы хотите получить данные.
Доступность авторов: Вы можете указать список атрибутов аудитории, таких как возраст, пол и интересы пользователей (включая аудитории по интересам, аудитории, находящиеся на рынке, и аудитории, связанные с жизненными событиями). API возвращает список авторов, чья аудитория соответствует этим атрибутам. Вы также можете указать атрибуты авторов для фильтрации контента, который точно соответствует указанным вами атрибутам.
Вы можете получить доступные атрибуты аудитории, используя
AudienceInsightsService.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.Аналитика брендов авторов: укажите бренд для поиска ведущих авторов. API предоставляет информацию о соответствующих каналах.
Аналитика для авторов: Укажите список идентификаторов каналов YouTube. API предоставит информацию именно об этих каналах.
Метод generateCreatorInsights возвращает объект GenerateCreatorInsightsResponse . Этот объект содержит список объектов YouTubeCreatorInsights . Каждый объект YouTubeCreatorInsights содержит следующую информацию о создателе контента:
- Имя создателя
- YouTube-канал
- Общие показатели создателей контента
- Список аналитических данных YouTube-каналов
Объект YouTubeMetrics содержит следующие метрики:
- Количество подписчиков
- Количество просмотров
- Количество видео
- Активный создатель коротких видеороликов.
- Возможности для партнерства (начиная с версии 23)
Объект YouTubeChannelInsights содержит следующую информацию о канале YouTube:
- Название канала
- Идентификатор канала
- URL канала
- Описание канала
- Показатели канала
Атрибуты аудитории канала (такие как возраст, пол и интересы пользователей)
авария)
Лучшие видео
Тип канала
Языки, связанные с контентом канала.
Показатель релевантности (только для поиска по трендам тем)
Получайте аналитические данные о тенденциях.
Для получения аналитических данных о тенденциях отправьте запрос методу ContentCreatorInsightsService.GenerateTrendingInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS) и принимает два типа входных данных в зависимости от того, хотите ли вы получить тенденции аудитории или тенденции тем. Необходимо указать конкретную страну, из которой вы хотите получить тенденции.
Тенденции аудитории: Вы можете указать список атрибутов аудитории, таких как возраст, пол и интересы пользователей (включая аудитории по интересам, заинтересованные в покупке и аудитории, связанные с жизненными событиями). API возвращает список аналитических данных о тенденциях для этих аудиторий, включая такие показатели, как процентное изменение значения тренда за сравниваемый период.
Вы можете получить доступные атрибуты аудитории, используя
AudienceInsightsService.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.Тенденции по темам: Укажите список тем контента. API вернет список аналитических данных о тенденциях по этим темам, включая такие показатели, как процентное изменение значения тренда за сравниваемый период.