- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- ТаргетингПредложениеМетрики
- Попробуйте!
Возвращает коллекцию данных о таргетинге (например, целевых аудиториях), которые имеют отношение к запрошенной аудитории.
Список выброшенных ошибок: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v17/customers/{customerId}:generateSuggestedTargetingInsights
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "audience": { object ( |
Поля | |
---|---|
audience | Необходимый. Аудитория, представляющая интерес, для которой запрашивается информация. |
baselineAudience | Необязательный. Базовая аудитория. По умолчанию, если оно не указано, все люди находятся в той же стране, что и интересующая аудитория. |
dataMonth | Необязательный. Диапазон исторических данных за один месяц, используемый для анализа, в формате «гггг-мм». Если этот параметр не установлен, будет возвращена информация за последние тридцать дней. |
customerInsightsGroup | Необязательный. Имя планируемого клиента. Это определяемое пользователем значение. |
Тело ответа
Ответное сообщение для AudienceInsightsService.GenerateSuggestedTargetingInsights
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"suggestions": [
{
object ( |
Поля | |
---|---|
suggestions[] | Рекомендации для целевой аудитории. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
ТаргетингПредложениеМетрики
Предлагаемая целевая аудитория, соответствующая запрошенной аудитории.
JSON-представление |
---|
{ "locations": [ { object ( |
Поля | |
---|---|
locations[] | Рекомендуемый геотаргетинг. Все эти атрибуты имеют измерение GEO_TARGET_COUNTRY или SUB_COUNTRY_LOCATION. |
ageRanges[] | Рекомендуемый возрастной таргетинг; может быть пустым, что указывает на отсутствие таргетинга по возрасту. |
gender | Рекомендуемый гендерный таргетинг. Если этот атрибут присутствует, он имеет измерение ПОЛ. |
userInterests[] | Рекомендуемые сегменты аудитории для таргетинга. Все эти атрибуты имеют измерение AFFINITY_USER_INTEREST или IN_MARKET_USER_INTEREST. |
coverage | Доля (от 0 до 1 включительно) запрашиваемой аудитории, которую можно охватить с помощью предложенного таргетинга. |
index | Отношение охвата к охвату базовой аудитории или ноль, если это соотношение неопределенно или не имеет смысла. |
potentialYoutubeReach | Примерное предполагаемое количество людей, которых можно охватить на YouTube с помощью этого таргетинга. |