Method: customers.recommendations.generate

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

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

HTTP-запрос

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

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

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

Параметры
customer Id

string

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

Тело запроса

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

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

enum ( RecommendationType )

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

Следующие рекомендации поддержаны для генерации рекомендаций: ключевое слово, 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_roas, sitelink_asset, target_cpa_opt_in

advertising Channel Type

enum ( AdvertisingChannelType )

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

ad Group Info[]

object ( AdGroupInfo )

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

conversion Tracking Status

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.

bidding Info

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.

seed Info

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.
}
Поля
bidding Strategy Type

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 может иметь только одно из следующих значений:
target Cpa Micros

string ( int64 format)

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

target Roas

number

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

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

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

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

object ( KeywordInfo )

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

ad Group Type

enum ( AdGroupType )

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

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

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

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

string

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

url Seed

string

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