Статистика по аудиториям

Важно! Эта функция доступна только для аккаунтов из белого списка. Если вам нужен доступ к этой функции, обратитесь к представителю Google.

Для всех запросов к AudienceInsightsService действует ограничение частоты запросов. Для методов generateAudienceCompositionInsights и generateSuggestedTargetingInsights разрешено меньше запросов в день, чем для других методов статистики аудитории. Подробнее о квотах API…

AudienceInsightsService позволяет интегрировать данные статистики аудитории Google в ваши инструменты планирования. Эти данные помогают рекламным агентствам и менеджерам по медиапланированию лучше понять свою целевую аудиторию, включая демографические характеристики, интересы и поведение в интернете.

Статистика аудитории позволяет вам быстро и на высоком уровне анализировать характеристики потенциальных клиентов, а также данные о категориях, темах и брендах. Анализируя поведение пользователей в статьях по теме, можно использовать статистику аудитории, чтобы выявить взаимосвязи и представления потребителей, а также определить новые сегменты аудитории.

API поддерживает три основных варианта использования:

• Уточнение и выявление аудиторий. Понимание уникальных интересов и поведения потребителей позволяет выявлять новые аудитории для бренда, разрабатывать типичных представителей аудитории и уточнять стратегии сегментации аудитории.
• Планирование кампаний. Преобразуйте данные в целевые аудитории YouTube, чтобы планировать кампании, оценивать потенциальный охват целевых аудиторий и измерять пересечение между сегментами аудитории, чтобы максимально увеличить охват кампании.
• Разрабатывайте рекламные сообщения. Адаптируйте рекламные сообщения для целевой аудитории с учетом тем и интересов, которые привлекают ее больше всего.

Требования

Чтобы получить статус AudienceInsightsService, партнеры должны соответствовать следующим условиям:

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

За дополнительной информацией обращайтесь к представителю Google.

Даты, за которые доступна статистика

Обычно рабочий процесс начинается с проверки того, какие календарные месяцы и диапазоны дат доступны для анализа. Метод listInsightsEligibleDates возвращает объект ListInsightsEligibleDatesResponse, в поле data_months которого перечислены месяцы (в формате YYYY-MM), за которые доступна статистика аудитории.

Поле last_thirty_days в ответе содержит точный диапазон дат, который generateAudienceCompositionInsights использует, если в запросе не задано значение data_month.

Как получить список атрибутов статистики аудитории

Прежде чем запрашивать показатели состава или пересечения аудитории, найдите действительные идентификаторы атрибутов с помощью listAudienceInsightsAttributes. Этот метод возвращает объект ListAudienceInsightsAttributesResponse, содержащий доступные атрибуты для запрошенных параметров.

Например, если в запросе в качестве параметра выбран AFFINITY_USER_INTEREST, метод возвращает поддерживаемые аудитории по интересам, такие как "Любители спорта" или "Меломаны". Другие поддерживаемые параметры интересов пользователей: IN_MARKET_USER_INTEREST и LIFE_EVENT_USER_INTEREST. В одном запросе можно задать несколько параметров. Полный список поддерживаемых параметров приведен в справочнике по полям dimensions.

При поиске объектов сети знаний (тем) с помощью параметра KNOWLEDGE_GRAPH необходимо указать строку запроса в поле query_text (например, "football and the World Cup").

Вы можете добавить knowledge_graph_entity_search_options, чтобы настроить поиск по темам:

• Фильтрация по возможностям. Используйте search_filter, чтобы сузить список объектов до тех, которые поддерживают определенные возможности. Например, чтобы отфильтровать темы, поддерживаемые в качестве атрибутов авторов, укажите CREATOR_ATTRIBUTE в поле entity_capability_filters. Можно указать несколько возможностей, которые будут объединены с помощью логического оператора OR.
• Получение всех атрибутов автора. Задайте для параметра get_all_creator_attributes значение true, чтобы получить все доступные объекты сети знаний, помеченные как атрибуты автора. При использовании этого варианта необходимо выбрать параметр KNOWLEDGE_GRAPH, а параметр query_text должен быть пустым. Кроме того, этот вариант нельзя сочетать с search_filter.

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

Каждый объект AudienceInsightsAttributeMetadata в ListAudienceInsightsAttributesResponse представляет собой структурированное представление атрибута аудитории, а также описательные свойства и показатели взаимодействий. В нем содержится основное определение атрибута, отображаемое название, тип параметра и расчетный охват аудитории. Определения полей приведены в справочнике по AudienceInsightsAttributeMetadata.

Создать определение аудитории

Метод generateAudienceDefinition преобразует текстовое описание аудитории в свободной форме в структурированные предложения атрибутов аудитории, которые можно передать в последующие методы статистики.

Как получить статистику по рекомендуемому таргетингу

Метод generateSuggestedTargetingInsights возвращает набор данных о таргетинге (например, сегменты аудитории, на которые можно настроить таргетинг), соответствующих запрошенной аудитории.

Вы можете указать запрашиваемую аудиторию в виде структурированного объекта InsightsAudienceDefinition или текстового описания в поле InsightsAudienceDescription.

generateAudienceCompositionInsights возвращает статистику по отдельным сегментам атрибутов, а generateSuggestedTargetingInsights – рекомендации по сегментам аудитории Google Рекламы, на которые можно настроить таргетинг. Этот метод позволяет получить ответы на такие вопросы, как "Порекомендуйте аудитории для таргетинга, в которые входят отцы в возрасте от 30 до 40 лет, увлекающиеся рыбалкой".

Как создать показатели для предложений по таргетингу

Метод generateTargetingSuggestionMetrics возвращает объект GenerateTargetingSuggestionMetricsResponse, который содержит потенциальное количество пользователей YouTube, которых можно охватить для каждого определения аудитории, запрошенного в GenerateTargetingSuggestionMetricsRequest.

Этот метод позволяет ответить на такие вопросы, как "Сколько мужчин в возрасте от 18 лет, интересующихся кемпингом в США, можно охватить на YouTube?"

Как получить статистику о составе аудитории

Метод generateAudienceCompositionInsights возвращает объект GenerateAudienceCompositionInsightsResponse, который содержит список атрибутов, представляющих запрашиваемую аудиторию, а также индекс и долю, которые сравнивают долю каждого атрибута в аудитории с базовой популяцией.

Необходимо указать целевую страну для аудитории. Список поддерживаемых параметров для получения статистики по составу аудитории приведен в поле dimensions объекта GenerateAudienceCompositionInsightsRequest.

Этот метод помогает ответить на такие вопросы, как "Какие основные интересы у моей целевой аудитории по сравнению с общей совокупностью населения и насколько выше вероятность того, что они будут взаимодействовать с этими интересами?"

Как создать статистику по пересечению аудиторий

Метод generateAudienceOverlapInsights возвращает объект GenerateAudienceOverlapInsightsResponse, который содержит список атрибутов аудитории с оценками пересечения между их потенциальным охватом на YouTube и охватом основного атрибута.

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

Этот метод позволяет ответить на такие вопросы, как "Насколько увеличится размер аудитории, если мы настроим таргетинг и на любителей спорта, и на любителей музыки в США?".

Как создать отчет Insights Finder

Метод generateInsightsFinderReport создает сохраненный отчет в Insights Finder на основе входных данных, указанных в GenerateInsightsFinderReportRequest, и возвращает GenerateInsightsFinderReportResponse, содержащий внешнюю ссылку для открытия этого отчета в интерфейсе Insights Finder.

Система отслеживания ошибок Google

Чтобы задать вопрос службе поддержки, сообщить об ошибке или запросить добавление функции, используйте систему отслеживания ошибок Google. Google отслеживает запросы, определяет их приоритет и публикует обновления прямо в системе отслеживания ошибок. Подробнее о том, как создать проблему в системе отслеживания ошибок Google…

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

• Как задать вопрос службе поддержки или отправить отзыв о документации
• Как сообщить о технической ошибке
• Отправить запрос на добавление функции API

Заполните все поля в шаблоне, указав подробную информацию, чтобы специалисты Google могли воспроизвести проблему и определить приоритет вашего запроса. Google может закрыть неполные жалобы и попросить вас отправить новую жалобу с недостающими сведениями.