Method: customers.recommendations.apply

Applica i consigli forniti con i parametri di applicazione corrispondenti.

Elenco degli errori generati: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

obbligatorio. L'ID del cliente con il suggerimento.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
Campi
operations[]

object (ApplyRecommendationOperation)

obbligatorio. L'elenco delle operazioni a cui applicare i suggerimenti. SePartialFailure=false, tutti i suggerimenti devono essere dello stesso tipo. Esiste un limite di 100 operazioni per richiesta.
partialFailure

boolean

Se il valore è true, le operazioni andate a buon fine vengono eseguite e le operazioni non valide restituiranno errori. Se il valore è false, le operazioni verranno eseguite come transazione solo se sono tutte valide. Il valore predefinito è false.

Corpo della risposta

Messaggio di risposta per RecommendationService.ApplyRecommendation.

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

Rappresentazione JSON 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Campi
results[]

object (ApplyRecommendationResult)

Risultati delle operazioni per applicare i suggerimenti.
partialFailureError

object (Status)

Errori relativi agli errori delle operazioni in modalità di errore parziale. Restituito solo quando incompleteFailure = true e tutti gli errori si verificano all'interno delle operazioni. Se si verificano errori al di fuori delle operazioni (ad esempio, errori di autenticazione), restituiamo l'errore a livello di RPC.

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.

ApplyRecommendationOperation

Informazioni sull'operazione per applicare un suggerimento ed eventuali parametri per personalizzarlo.

Rappresentazione JSON 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "leadFormAsset": {
    object (LeadFormAssetParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
Campi
resourceName

string

Il nome della risorsa del suggerimento da applicare.
Campo di unione apply_parameters. Parametri da utilizzare durante l'applicazione del suggerimento. apply_parameters può essere solo uno dei seguenti:
campaignBudget

object (CampaignBudgetParameters)

Parametri facoltativi da utilizzare durante l'applicazione di un consiglio sul budget della campagna.
textAd

object (TextAdParameters)

Parametri facoltativi da utilizzare quando si applica un consiglio sugli annunci di testo.
keyword

object (KeywordParameters)

Parametri facoltativi da utilizzare quando applichi il consiglio sulle parole chiave.
targetCpaOptIn

object (TargetCpaOptInParameters)

Parametri facoltativi da utilizzare durante l'applicazione del consiglio di attivazione del CPA target.
targetRoasOptIn

object (TargetRoasOptInParameters)

Parametri facoltativi da utilizzare durante l'applicazione del consiglio di attivazione del ROAS target.
calloutExtension

object (CalloutExtensionParameters)

Parametri da utilizzare quando applichi il consiglio sulle estensioni callout.
callExtension

object (CallExtensionParameters)

Parametri da utilizzare quando applichi il consiglio sulle estensioni di chiamata.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Parametri da utilizzare durante l'applicazione del consiglio per il trasferimento di budget inutilizzato.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

Parametri da utilizzare quando si applica un consiglio sugli annunci adattabili della rete di ricerca.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

Parametri da utilizzare quando si applica un consiglio sulle parole chiave a corrispondenza generica.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Parametri da utilizzare quando si applica un consiglio sugli asset degli annunci adattabili della rete di ricerca.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

I parametri da utilizzare quando applichi un annuncio adattabile della rete di ricerca migliorano il consiglio sull'efficacia dell'annuncio.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

Parametri da utilizzare quando si applica un consiglio per aumentare l'offerta basata su CPA target troppo bassa. L'applicazione è asincrona e può richiedere minuti a seconda del numero di gruppi di annunci presenti nella campagna correlata.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametri da utilizzare quando si applica un consiglio per il ROAS target impostato per la previsione.
calloutAsset

object (CalloutAssetParameters)

Parametri da utilizzare durante l'applicazione del consiglio sugli asset callout.
callAsset

object (CallAssetParameters)

Parametri da utilizzare quando applichi il consiglio sugli asset di chiamata.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Parametri da utilizzare quando applichi il consiglio per aumentare il CPA target.
lowerTargetRoas

object (LowerTargetRoasParameters)

Parametri da utilizzare quando si applica un consiglio sul ROAS target più basso.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametri da utilizzare durante l'applicazione della previsione imposta il consiglio relativo al CPA target.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametri da utilizzare quando si applica il consiglio del CPA target impostato.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametri da utilizzare durante l'applicazione del consiglio per il ROAS target impostato.
leadFormAsset

object (LeadFormAssetParameters)

Parametri da utilizzare quando applichi il consiglio sugli asset modulo per i lead.

CampaignBudgetParameters

Parametri da utilizzare quando si applica un consiglio sul budget della campagna.

Rappresentazione JSON 
{
  "newBudgetAmountMicros": string
}
Campi
newBudgetAmountMicros

string (int64 format)

Nuovo importo del budget da impostare per la risorsa di budget di destinazione. Questo campo è obbligatorio.

TextAdParameters

Parametri da utilizzare quando si applica un consiglio sugli annunci di testo.

Rappresentazione JSON 
{
  "ad": {
    object (Ad)
  }
}
Campi
ad

object (Ad)

Nuovo annuncio da aggiungere al gruppo di annunci consigliato. Tutti i campi necessari devono essere impostati in questo messaggio. Questo campo è obbligatorio.

KeywordParameters

Parametri da utilizzare quando si applica il consiglio sulle parole chiave.

Rappresentazione JSON 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
Campi
matchType

enum (KeywordMatchType)

Il tipo di corrispondenza della parola chiave. Questo campo è obbligatorio.
adGroup

string

La risorsa del gruppo di annunci a cui aggiungere la parola chiave. Questo campo è obbligatorio.
cpcBidMicros

string (int64 format)

Offerta CPC facoltativa da impostare per la parola chiave. Se non viene configurato, la parola chiave utilizzerà l'offerta in base alla strategia di offerta utilizzata dal gruppo di annunci target.

TargetCpaOptInParameters

Parametri da utilizzare quando si applica il consiglio sul CPA target.

Rappresentazione JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
Campi
targetCpaMicros

string (int64 format)

CPA medio da utilizzare per la strategia di offerta basata su CPA target. Questo campo è obbligatorio.
newCampaignBudgetAmountMicros

string (int64 format)

Facoltativo. Importo del budget da impostare per la campagna.

TargetRoasOptInParameters

Parametri da utilizzare quando si applica un consiglio di attivazione del ROAS target.

Rappresentazione JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
Campi
targetRoas

number

ROAS (entrate per unità di spesa) medio da utilizzare per la strategia di offerta ROAS target. Il valore è compreso tra 0,01 e 1000,0 inclusi. Questo è un campo obbligatorio, a meno che non sia impostato newCampaignBudgetAmountMicros.
newCampaignBudgetAmountMicros

string (int64 format)

Facoltativo. Importo del budget da impostare per la campagna.

CalloutExtensionParameters

Parametri da utilizzare quando applichi il consiglio sulle estensioni callout.

Rappresentazione JSON 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
Campi
calloutExtensions[]

object (CalloutFeedItem)

Aggiungere le estensioni callout. Questo campo è obbligatorio.

CallExtensionParameters

Parametri da utilizzare quando applichi il consiglio sulle estensioni di chiamata.

Rappresentazione JSON 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
Campi
callExtensions[]

object (CallFeedItem)

Estensioni di chiamata da aggiungere. Questo campo è obbligatorio.

SitelinkExtensionParameters

Parametri da utilizzare quando si applica il consiglio sui sitelink.

Rappresentazione JSON 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
Campi

MoveUnusedBudgetParameters

Parametri da utilizzare durante l'applicazione del consiglio per il trasferimento di budget inutilizzato.

Rappresentazione JSON 
{
  "budgetMicrosToMove": string
}
Campi
budgetMicrosToMove

string (int64 format)

Importo di budget per passare da un budget in eccesso a un budget limitato. Questo campo è obbligatorio.

ResponsiveSearchAdParameters

Parametri da utilizzare quando si applica un consiglio sugli annunci adattabili della rete di ricerca.

Rappresentazione JSON 
{
  "ad": {
    object (Ad)
  }
}
Campi
ad

object (Ad)

obbligatorio. Nuovo annuncio da aggiungere al gruppo di annunci consigliato.

UseBroadMatchKeywordParameters

Parametri da utilizzare quando si applica un consiglio sulle parole chiave a corrispondenza generica.

Rappresentazione JSON 
{
  "newBudgetAmountMicros": string
}
Campi
newBudgetAmountMicros

string (int64 format)

Nuovo importo del budget da impostare per la risorsa di budget di destinazione.

ResponsiveSearchAdAssetParameters

Parametri da utilizzare quando si applica un consiglio sugli asset degli annunci adattabili della rete di ricerca.

Rappresentazione JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Campi
updatedAd

object (Ad)

Annuncio aggiornato. I contenuti dell'annuncio corrente verranno sostituiti.

ResponsiveSearchAdImproveAdStrengthParameters

I parametri da utilizzare quando applichi un annuncio adattabile della rete di ricerca migliorano il consiglio sull'efficacia dell'annuncio.

Rappresentazione JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Campi
updatedAd

object (Ad)

Annuncio aggiornato. I contenuti dell'annuncio corrente verranno sostituiti.

RaiseTargetCpaBidTooLowParameters

Parametri da utilizzare quando si applica un consiglio per aumentare l'offerta basata su CPA target troppo bassa. L'applicazione è asincrona e può richiedere minuti a seconda del numero di gruppi di annunci presenti nella campagna correlata.

Rappresentazione JSON 
{
  "targetMultiplier": number
}
Campi
targetMultiplier

number

obbligatorio. Un numero maggiore di 1,0 che indica il fattore in base al quale aumentare il CPA target. Questo campo è obbligatorio.

ForecastingSetTargetRoasParameters

Parametri da utilizzare quando si applica un suggerimento per il ROAS target impostato per la previsione.

Rappresentazione JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
Campi
targetRoas

number

Nuovo ROAS target (entrate per unità di spesa) da impostare per una risorsa della campagna. Il valore è compreso tra 0,01 e 1000,0 inclusi.
campaignBudgetAmountMicros

string (int64 format)

Nuovo importo del budget della campagna da impostare per una risorsa campagna.

CalloutAssetParameters

Parametri da utilizzare quando si applicano i consigli sugli asset callout.

Rappresentazione JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campi
adAssetApplyParameters

object (AdAssetApplyParameters)

obbligatorio. Asset callout da aggiungere. Questo campo è obbligatorio.

AdAssetApplyParameters

Parametri comuni utilizzati durante l'applicazione dei consigli sugli asset annuncio.

Rappresentazione JSON 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Campi
newAssets[]

object (Asset)

Gli asset da creare e collegare a un ambito. Può essere combinato con asset esistenti nella stessa chiamata.
existingAssets[]

string

I nomi delle risorse degli asset esistenti da collegare a un ambito. Questo valore può essere combinato con il valore newAssets nella stessa chiamata.
scope

enum (ApplyScope)

obbligatorio. L'ambito in cui applicare gli asset. Gli asset a livello di ambito della campagna verranno applicati alla campagna associata al consiglio. Gli asset a livello di cliente verranno applicati all'intero account. Gli asset nell'ambito della campagna sostituiranno tutti quelli associati all'ambito cliente.

ApplyScope

Ambito a cui applicare gli asset.

Enum
UNSPECIFIED L'ambito Applica non è stato specificato.
UNKNOWN Sconosciuto.
CUSTOMER Applica in ambito cliente.
CAMPAIGN Applica nell'ambito della campagna.

CallAssetParameters

Parametri da utilizzare durante l'applicazione dei consigli sugli asset di chiamata.

Rappresentazione JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campi
adAssetApplyParameters

object (AdAssetApplyParameters)

obbligatorio. Asset di chiamata da aggiungere. Questo campo è obbligatorio.

SitelinkAssetParameters

Parametri da utilizzare quando si applicano i consigli sugli asset sitelink.

Rappresentazione JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Campi
adAssetApplyParameters

object (AdAssetApplyParameters)

obbligatorio. Asset sitelink da aggiungere. Questo campo è obbligatorio.

RaiseTargetCpaParameters

Parametri da utilizzare quando applichi i consigli per aumentare il CPA target.

Rappresentazione JSON 
{
  "targetCpaMultiplier": number
}
Campi
targetCpaMultiplier

number

obbligatorio. Target su cui impostare il moltiplicatore del CPA. Questo campo è obbligatorio.

LowerTargetRoasParameters

Parametri da utilizzare quando si applicano consigli sul ROAS target più bassi.

Rappresentazione JSON 
{
  "targetRoasMultiplier": number
}
Campi
targetRoasMultiplier

number

obbligatorio. Target su cui impostare il moltiplicatore del ROAS. Questo campo è obbligatorio.

ForecastingSetTargetCpaParameters

Parametri da utilizzare quando si applica un consiglio impostato per il CPA target.

Rappresentazione JSON 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
Campi
targetCpaMicros

string (int64 format)

CPA medio da utilizzare per la strategia di offerta basata su CPA target.
campaignBudgetAmountMicros

string (int64 format)

Nuovo importo del budget della campagna da impostare per una risorsa campagna.

LeadFormAssetParameters

Parametri da utilizzare quando applichi un consiglio sugli asset modulo per i lead.

Rappresentazione JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  },
  "setSubmitLeadFormAssetCampaignGoal": boolean
}
Campi
adAssetApplyParameters

object (AdAssetApplyParameters)

obbligatorio. Asset modulo per i lead da aggiungere. Questo campo è obbligatorio.
setSubmitLeadFormAssetCampaignGoal

boolean

Se il valore è true, l'obiettivo "Invio modulo per i lead" verrà impostato per la campagna target. Di conseguenza, gli annunci verranno visualizzati come annunci con creatività modulo per i lead. Se il valore è false, l'obiettivo "Invio modulo per i lead" non verrà impostato nella campagna e gli annunci conterranno gli asset modulo per i lead.

ApplyRecommendationResult

Il risultato dell'applicazione di un consiglio.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Restituito per esito positivo.