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/v17/customers/{customerId}/recommendations:generate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatoria. 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)

Obbligatoria. 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, per quel tipo non verrà restituito alcun consiglio. 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.

I seguenti tipi di suggerimenti sono supportati per la generazione di suggerimenti: 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)

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

object (AdGroupInfo)

Campo 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)

Campo facoltativo. Stato attuale del monitoraggio delle conversioni. 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
biddingInfo

object (BiddingInfo)

Campo 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)

Campo facoltativo. Informazioni origine 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 di suggerimenti generati da quelli passati in un insieme di RecommendationsType richiesti. Se non sono disponibili dati sufficienti per generare un suggerimento per i vari tipi di suggerimenti 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. Questo campo può essere compilato per le campagne con un tipo di strategia di offerta di TARGET_CPA o MAXIMIZE_CONVERSIONS.
targetRoas

number

ROAS target attuale. Questo valore 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)

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

enum (AdGroupType)

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

SeedInfo

Un seed 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 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.