Method: customers.recommendations.generate

Генерирует рекомендации на основе запрошенных типов рекомендаций.

Список выброшенных ошибок: AuthenticationError AuthorizationError HeaderError InternalError QuotaError РекомендацияError RequestError

HTTP-запрос

POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate

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

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

Параметры
customerId

string

Необходимый. Идентификатор клиента, генерирующего рекомендации.

Тело запроса

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

JSON-представление
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Поля
recommendationTypes[]

enum ( RecommendationType )

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

Для создания рекомендаций поддерживаются следующие типы рекомендаций: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, SITELINK_ASSET, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.

advertisingChannelType

enum ( AdvertisingChannelType )

Необходимый. Тип рекламного канала кампании. Для формирования рекомендаций поддерживаются следующие типы рекламных каналов: PERFORMANCE_MAX и SEARCH.

adGroupInfo[]

object ( AdGroupInfo )

Необязательный. Текущая информация о группе объявлений. Поддерживает информацию из одной группы объявлений. Это поле является необязательным для следующих типов рекомендаций: KEYWORD.

conversionTrackingStatus

enum ( ConversionTrackingStatus )

Необязательный. Текущий статус отслеживания конверсий. Это поле необходимо для следующих типов рекомендаций: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.

biddingInfo

object ( BiddingInfo )

Необязательный. Текущая информация о ставках кампании. Это поле необходимо для следующих типов рекомендаций: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.

seedInfo

object ( SeedInfo )

Необязательный. Начальная информация для ключевых слов. Это поле необходимо для следующих типов рекомендаций: KEYWORD.

Тело ответа

Ответное сообщение для RecommendationService.GenerateRecommendations .

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

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

object ( Recommendation )

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

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

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

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

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

Информация о торгах

Текущая информация о ставках кампании. Предоставляет оболочку для сигналов, связанных со ставками, которые служат основой для рекомендаций.

JSON-представление
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
Поля
biddingStrategyType

enum ( BiddingStrategyType )

Текущая стратегия назначения ставок. Это поле необходимо для следующих типов рекомендаций: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.

Поле объединения bidding_strategy_target_info . Дополнительные сведения, связанные с bidding_strategy_type. bidding_strategy_target_info может иметь только одно из следующих значений:
targetCpaMicros

string ( int64 format)

Текущая целевая цена за конверсию в микрон. Его можно заполнить для кампаний со стратегией назначения ставок TARGET_CPA или MAXIMIZE_CONVERSIONS.

targetRoas

number

Текущая целевая рентабельность инвестиций. Его можно заполнить для кампаний со стратегией назначения ставок TARGET_ROAS или MAXIMIZE_CONVERSION_VALUE.

Информация о группе объявлений

Текущая информация о группе объявлений кампании.

JSON-представление
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Поля
keywords[]

object ( KeywordInfo )

Необязательный. Текущие ключевые слова. Это поле является необязательным для следующих типов рекомендаций, если задано значение adGroupInfo: KEYWORD.

adGroupType

enum ( AdGroupType )

Необязательный. AdGroup Тип группы объявлений. Это поле необходимо для следующих типов рекомендаций, если задано значение adGroupInfo: KEYWORD.

Информация о семенах

Начальное значение ключевого слова и конкретный URL-адрес для генерации ключевых слов.

JSON-представление
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Поля
keywordSeeds[]

string

Необязательный. Ключевые слова или фразы для генерации идей, например: автомобили или «автосалон рядом со мной».

urlSeed

string

Конкретный URL-адрес для генерации идей, например: www.example.com/cars.