Method: customers.recommendations.generate

Gera recomendações com base nos RecommendationsTypes solicitados.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente que gera recomendações.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Campos
recommendationTypes[]

enum (RecommendationType)

Obrigatório. Lista de RecommendationsTypes qualificados a serem gerados. Se os critérios enviados não forem suficientes para fazer uma recomendação ou se a campanha já estiver no estado recomendado, nenhuma recomendação será retornada para esse tipo. Geralmente, uma recomendação é retornada se todos os campos obrigatórios desserecommendType forem enviados, mas há casos em que isso ainda não é suficiente.

Os tipos de recomendação a seguir são compatíveis com a geração de recomendações: KEYWORD, MAXIMIZE_FORMATTED_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)

Obrigatório. Tipo de canal de publicidade da campanha. Os seguintes AdvertisingChannelTypes são compatíveis com a geração de recomendações: PERFORMANCE_MAX e SEARCH
adGroupInfo[]

object (AdGroupInfo)

Opcional. Informações atuais do grupo de anúncios. Oferece suporte a informações de um único grupo de anúncios. Esse campo é opcional para os seguintes recommendationsTypes: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Opcional. Status atual do acompanhamento de conversões. Esse campo é necessário para os seguintes tipos de recomendação: MAXIMIZE_PUBLISH_OPT_IN, MAXIMIZE_PLACEMENT_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

Opcional. Informações de lances atuais da campanha. Esse campo é necessário para os seguintes tipos de recomendação: MAXIMIZE_PUBLISH_OPT_IN, MAXIMIZE_PLACEMENT_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

Opcional. Informações de semente para palavras-chave. Esse campo é necessário para os seguintes recommendationsTypes: KEYWORD

Corpo da resposta

Mensagem de resposta para RecommendationService.GenerateRecommendations.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Campos
recommendations[]

object (Recommendation)

Lista de recomendações geradas com base no conjunto de recomendaçõesTypes solicitadas. Se não houver dados suficientes para gerar uma recomendação para osrecommendTypes solicitados, o conjunto de resultados não conterá uma recomendação para esse tipo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

BiddingInfo

Informações de lances atuais da campanha. Fornece um wrapper para indicadores relacionados a lances que informam as recomendações.

Representação 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.
}
Campos
biddingStrategyType

enum (BiddingStrategyType)

Estratégia de lances atual. Esse campo é necessário para os seguintes tipos de recomendação: MAXIMIZE_PUBLISH_OPT_IN, MAXIMIZE_PLACEMENT_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
Campo de união bidding_strategy_target_info. Detalhes opcionais relacionados ao bidder_strategy_type. bidding_strategy_target_info pode ser apenas de um dos tipos a seguir:
targetCpaMicros

string (int64 format)

CPA desejado atual em micros. Esse campo pode ser preenchido para campanhas com um tipo de estratégia de lances de TARGET_CPA ou MAXIMIZE_conversions.
targetRoas

number

targetRoas atual. Pode ser preenchido para campanhas com um tipo de estratégia de lances de TARGET_ROAS ou MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Informações atuais do grupo de anúncios da campanha.

Representação JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Campos
keywords[]

object (KeywordInfo)

Opcional. Palavras-chave atuais. Esse campo é opcional para os seguintesrecommendTypes se adGroupInfo estiver definido: KEYWORD
adGroupType

enum (AdGroupType)

Opcional. Tipo de grupo de anúncios do grupo de anúncios. Esse campo é necessário para os seguintesrecommendTypes se adGroupInfo estiver definido: KEYWORD

SeedInfo

Uma seed de palavra-chave e um URL específico a partir do qual gerar palavras-chave.

Representação JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Campos
keywordSeeds[]

string

Opcional. Palavras-chave ou frases para gerar ideias, por exemplo: carros ou "concessionária perto de mim".
urlSeed

string

Um URL específico para gerar ideias, por exemplo: www.example.com/carros.