Method: customers.generateSuggestedTargetingInsights

Возвращает коллекцию данных о таргетинге (например, целевых аудиториях), которые имеют отношение к запрошенной аудитории.

Список выброшенных ошибок: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateSuggestedTargetingInsights

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор клиента.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Поля
audience

object ( InsightsAudience )

Необходимый. Аудитория, представляющая интерес, для которой запрашивается информация.

baselineAudience

object ( InsightsAudience )

Необязательный. Базовая аудитория. По умолчанию, если оно не указано, все люди находятся в той же стране, что и интересующая аудитория.

dataMonth

string

Необязательный. Диапазон исторических данных за один месяц, используемый для анализа, в формате «гггг-мм». Если этот параметр не установлен, будет возвращена информация за последние тридцать дней.

customerInsightsGroup

string

Необязательный. Имя планируемого клиента. Это определяемое пользователем значение.

Тело ответа

Ответное сообщение для AudienceInsightsService.GenerateSuggestedTargetingInsights .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Поля
suggestions[]

object ( TargetingSuggestionMetrics )

Рекомендации для целевой аудитории.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

ТаргетингПредложениеМетрики

Предлагаемая целевая аудитория, соответствующая запрошенной аудитории.

JSON-представление
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Поля
locations[]

object ( AudienceInsightsAttributeMetadata )

Рекомендуемый геотаргетинг. Все эти атрибуты имеют измерение GEO_TARGET_COUNTRY или SUB_COUNTRY_LOCATION.

ageRanges[]

object ( AgeRangeInfo )

Рекомендуемый возрастной таргетинг; может быть пустым, что указывает на отсутствие таргетинга по возрасту.

gender

object ( GenderInfo )

Рекомендуемый гендерный таргетинг. Если этот атрибут присутствует, он имеет измерение ПОЛ.

userInterests[]

object ( AudienceInsightsAttributeMetadata )

Рекомендуемые сегменты аудитории для таргетинга. Все эти атрибуты имеют измерение AFFINITY_USER_INTEREST или IN_MARKET_USER_INTEREST.

coverage

number

Доля (от 0 до 1 включительно) запрашиваемой аудитории, которую можно охватить с помощью предложенного таргетинга.

index

number

Отношение охвата к охвату базовой аудитории или ноль, если это соотношение неопределенно или не имеет смысла.

potentialYoutubeReach

string ( int64 format)

Примерное предполагаемое количество людей, которых можно охватить на YouTube с помощью этого таргетинга.