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/v14/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. Se parzialiFailure=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 riuscite verranno eseguite e quelle non valide restituiranno errori. Se è impostato su 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 a errori delle operazioni in modalità di errore parziale. Errore restituito solo quando partialFailure = 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), viene restituito 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 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)
  }
  // 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 quando applichi un consiglio sul budget della campagna.
textAd

object (TextAdParameters)

Parametri facoltativi da utilizzare quando applichi 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 quando applichi il consiglio di attivazione del CPA target.
targetRoasOptIn

object (TargetRoasOptInParameters)

Parametri facoltativi da utilizzare quando applichi il 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 quando applichi il consiglio per il trasferimento del budget inutilizzato.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

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

object (UseBroadMatchKeywordParameters)

Parametri da utilizzare quando viene applicato un consiglio sulle parole chiave a corrispondenza generica.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Parametri da utilizzare quando applichi un consiglio sugli asset per gli 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 applichi 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 durante l'applicazione di un consiglio sul ROAS target impostato per la previsione.
calloutAsset

object (CalloutAssetParameters)

Parametri da utilizzare quando applichi il consiglio sugli asset callout.
callAsset

object (CallAssetParameters)

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

object (RaiseTargetCpaParameters)

Parametri da utilizzare quando applichi il consiglio sull'aumento del CPA target.
lowerTargetRoas

object (LowerTargetRoasParameters)

Parametri da utilizzare quando applichi un consiglio sul ROAS target più basso.

CampaignBudgetParameters

Parametri da utilizzare quando applichi 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 target. Questo campo è obbligatorio.

TextAdParameters

Parametri da utilizzare quando applichi un consiglio per gli 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 applichi 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 impostata, la parola chiave utilizzerà l'offerta basata sulla strategia di offerta utilizzata dal gruppo di annunci target.

TargetCpaOptInParameters

Parametri da utilizzare quando applichi 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 applichi 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 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)

Estensioni callout da aggiungere. 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 applichi il consiglio sui sitelink.

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

MoveUnusedBudgetParameters

Parametri da utilizzare quando applichi il consiglio per il trasferimento del budget inutilizzato.

Rappresentazione JSON 
{
  "budgetMicrosToMove": string
}
Campi
budgetMicrosToMove

string (int64 format)

Importo del budget per passare dal budget in eccesso a un budget vincolato. Questo campo è obbligatorio.

ResponsiveSearchAdParameters

Parametri da utilizzare quando applichi 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 viene applicato 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 target.

ResponsiveSearchAdAssetParameters

Parametri da utilizzare quando applichi un consiglio sugli asset per gli 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 applichi 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 applichi un consiglio sul ROAS target impostato per una previsione.

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

number

Nuovo ROAS (entrate per unità di spesa) target 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 della campagna.

CalloutAssetParameters

Parametri da utilizzare quando applichi 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. Questo asset può essere combinato con asset esistenti nella stessa chiamata.
existingAssets[]

string

I nomi delle risorse degli asset esistenti da collegare a un ambito. Questa opzione può essere combinata con 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 quelli associati all'ambito cliente.

ApplyScope

L'ambito a cui applicare le risorse.

Enum
UNSPECIFIED L'ambito Applica non è stato specificato.
UNKNOWN Sconosciuto.
CUSTOMER Applica a livello di cliente.
CAMPAIGN Applica a livello di campagna.

CallAssetParameters

Parametri da utilizzare quando applichi i 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 durante l'applicazione per aumentare i consigli sul CPA target.

Rappresentazione JSON 
{
  "targetCpaMultiplier": number
}
Campi
targetCpaMultiplier

number

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

LowerTargetRoasParameters

Parametri da utilizzare quando applichi i consigli per un ROAS target più basso.

Rappresentazione JSON 
{
  "targetRoasMultiplier": number
}
Campi
targetRoasMultiplier

number

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

ApplyRecommendationResult

Il risultato dell'applicazione di un suggerimento.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Restituito per applicazione corretta.