Method: customers.recommendations.generate

Genera consigli in base ai recommendationTypes richiesti.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente che genera i consigli.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
Campi
recommendationTypes[]

enum (RecommendationType)

Obbligatorio. Elenco di RecommendationsType idonei da generare. Se i criteri caricati non sono sufficienti per fornire un consiglio o se la campagna è già nello stato consigliato, non verrà restituito alcun consiglio per quel tipo. In genere, viene restituito un suggerimento se tutti i campi obbligatori per questo tipo di suggerimento vengono caricati, ma in alcuni casi questo non è ancora sufficiente.

Per la generazione di consigli sono supportati i seguenti tipi di consigli: 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)

Obbligatorio. Tipo di canale pubblicitario della campagna. I seguenti tipi di canali pubblicitari sono supportati per la generazione di suggerimenti: PERFORMANCE_MAX e SEARCH
adGroupInfo[]

object (AdGroupInfo)

(Facoltativo) Informazioni correnti del gruppo di annunci. Supporta le informazioni di un singolo gruppo di annunci. Questo campo è facoltativo per i seguenti RecommendationsType: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

(Facoltativo) Stato attuale del monitoraggio delle conversioni. Questo campo è necessario per i seguenti tipi di consigli: 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)

(Facoltativo) Informazioni sulle offerte correnti della campagna. Questo campo è necessario per i seguenti tipi di suggerimenti: 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)

(Facoltativo) Informazioni iniziali per le parole chiave. Questo campo è necessario per i seguenti RecommendationsType: KEYWORD

Corpo della risposta

Messaggio di risposta per RecommendationService.GenerateRecommendations.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
Campi
recommendations[]

object (Recommendation)

Elenco dei consigli generati dall'insieme di recommendationTypes richiesti passati. Se non sono disponibili dati sufficienti per generare un suggerimento per i RecommendationsType richiesti, il set di risultati non conterrà un suggerimento per quel tipo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

BiddingInfo

Informazioni sulle offerte correnti della campagna. Fornisce un wrapper per gli indicatori relativi alle offerte che forniscono consigli utili.

Rappresentazione 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.
}
Campi
biddingStrategyType

enum (BiddingStrategyType)

Strategia di offerta attuale. Questo campo è necessario per i seguenti tipi di suggerimenti: 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
Campo unione bidding_strategy_target_info. Dettagli facoltativi relativi a bidding_strategy_type. bidding_strategy_target_info può essere solo uno dei seguenti:
targetCpaMicros

string (int64 format)

Attuale CPA target in micro. Può essere compilato per le campagne con un tipo di strategia di offerta TARGET_CPA o MAXIMIZE_CONVERSIONS.
targetRoas

number

ROAS target attuale. Può essere compilato per le campagne con un tipo di strategia di offerta TARGET_ROAS o MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

Informazioni correnti sul gruppo di annunci della campagna.

Rappresentazione JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
Campi
keywords[]

object (KeywordInfo)

(Facoltativo) Parole chiave attuali. Questo campo è facoltativo per i seguenti RecommendationsTypes se adGroupInfo è impostato: KEYWORD
adGroupType

enum (AdGroupType)

(Facoltativo) Tipo di gruppo di annunci del gruppo di annunci. Questo campo è necessario per i seguenti tipi di consigli se adGroupInfo è impostato: PAROLA CHIAVE

SeedInfo

Un seme di parole chiave e un URL specifico da cui generare le parole chiave.

Rappresentazione JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
Campi
keywordSeeds[]

string

(Facoltativo) Parole chiave o frasi da cui trarre idee, ad esempio auto o "concessionario auto vicino a me".
urlSeed

string

Un URL specifico da cui generare idee, ad esempio: www.example.com/auto.