Method: customers.recommendations.generate

Genera suggerimenti in base ai RecommendationsType 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 suggerimenti.

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 suggerimentiType idonei da generare. Se i criteri caricati non sono sufficienti per creare un suggerimento o se la campagna si trova già nello stato consigliato, per quel tipo non verrà restituito alcun consiglio. In genere, viene restituito un suggerimento se vengono caricati tutti i campi obbligatori per quel tipo di suggerimento, ma in alcuni casi questo valore non è ancora sufficiente.

Per la generazione dei suggerimenti sono supportati i seguenti suggerimentiType: KEYWORD, MAXIMIZE_CLIC_OPT_IN, MAXIMIZE_CONVERSION_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. Per la generazione di suggerimenti sono supportati i seguenti tipi di advertisingChannelTypes: PERFORMANCE_MAX e SEARCH
adGroupInfo[]

object (AdGroupInfo)

Campo facoltativo. Informazioni correnti sul gruppo di annunci. Supporta le informazioni di un singolo gruppo di annunci. Questo campo è facoltativo per i seguenti suggerimentiTypes: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

Campo facoltativo. Stato attuale del monitoraggio delle conversioni. Questo campo è necessario per i seguenti RecommendationsType: MAXIMIZE_CLIC_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.
biddingInfo

object (BiddingInfo)

Campo facoltativo. Informazioni sulle offerte attuali della campagna. Questo campo è necessario per i seguenti RecommendationsType: MAXIMIZE_CLIC_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.
seedInfo

object (SeedInfo)

Campo facoltativo. Informazioni sulle origini per le parole chiave. Questo campo è necessario per i seguenti recommendationsTypes: 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 di suggerimenti generati dall'insieme di suggerimentiType 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 pagina Panoramica di OAuth 2.0.

BiddingInfo

Informazioni sulle offerte attuali della campagna. Fornisce un wrapper per gli indicatori correlati alle offerte alla base dei consigli.

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 RecommendationsType: MAXIMIZE_CLIC_OPT_IN, MAXIMIZE_CONVERSION_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN.
Campo di 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)

Cpa target attuale in micro. Questo campo può essere compilato per le campagne con un tipo di strategia di offerta TARGET_CPA o MAXIMIZE_CONVERSION.
targetRoas

number

TargetRoas attuale. Questo campo può essere compilato per le campagne con un tipo di strategia di offerta TARGET_ROAS o MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

I dati del gruppo di annunci correnti della campagna.

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

object (KeywordInfo)

Campo facoltativo. Parole chiave correnti. Questo campo è facoltativo per i seguenti RecommendationsType se è impostato adGroupInfo: KEYWORD
adGroupType

enum (AdGroupType)

Campo facoltativo. Tipo di gruppo di annunci. Questo campo è necessario per i seguenti RecommendationsType se è impostato adGroupInfo: KEYWORD

SeedInfo

Il seed di una parola chiave e un URL specifico da cui generare parole chiave.

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

string

Campo facoltativo. Parole chiave o frasi da cui generare idee, ad esempio auto o "concessionaria auto nelle vicinanze".
urlSeed

string

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