Campaign

Una campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa della campagna. I nomi delle risorse della campagna hanno il seguente formato:

customers/{customerId}/campaigns/{campaignId}
primaryStatus

enum (CampaignPrimaryStatus)

Solo output. Lo stato principale della campagna.

Forniscono informazioni sul motivo per cui una campagna non viene pubblicata o non viene pubblicata in modo ottimale. Le modifiche alla campagna e alle relative entità potrebbero richiedere un po' di tempo per essere applicate in questo stato.
primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

Solo output. I motivi principali dello stato della campagna.

Forniscono informazioni sul motivo per cui una campagna non viene pubblicata o non viene pubblicata in modo ottimale. Questi motivi vengono aggregati per determinare uno stato complessivo della campagna (CampaignPrimaryStatus).
status

enum (CampaignStatus)

Lo stato della campagna.

Quando viene aggiunta una nuova campagna, lo stato predefinito è ABILITATO.
servingStatus

enum (CampaignServingStatus)

Solo output. Lo stato di pubblicazione degli annunci della campagna.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Solo output. Lo stato di sistema della strategia di offerta della campagna.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Lo stato di ottimizzazione della pubblicazione degli annunci della campagna.
advertisingChannelType

enum (AdvertisingChannelType)

Immutabile. Il target di pubblicazione principale per gli annunci all'interno della campagna. Le opzioni di targeting possono essere perfezionate in networkSettings.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne.

Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

Immutabile. Raffinamento facoltativo a advertisingChannelType. Deve essere un sottotipo valido del tipo di canale principale.

Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
urlCustomParameters[]

object (CustomParameter)

L'elenco delle mappature utilizzate per sostituire i tag dei parametri personalizzati in un trackingUrlTemplate, finalUrls o mobile_final_urls.
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

Le impostazioni relative alla campagna di Servizi locali.
travelCampaignSettings

object (TravelCampaignSettings)

Impostazioni per la campagna per viaggi.
demandGenCampaignSettings

object (DemandGenCampaignSettings)

Impostazioni per la campagna Demand Gen.
videoCampaignSettings

object (VideoCampaignSettings)

Impostazioni per la campagna video.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la rete Ad Exchange.
networkSettings

object (NetworkSettings)

Le impostazioni di rete per la campagna.
hotelSetting

object (HotelSettingInfo)

Immutabile. L'impostazione dell'hotel per la campagna.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA).
shoppingSetting

object (ShoppingSetting)

L'impostazione per il controllo delle campagne Shopping.
targetingSetting

object (TargetingSetting)

Impostazione per le funzionalità relative al targeting.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

L'impostazione per il targeting geografico degli annunci.
localCampaignSetting

object (LocalCampaignSetting)

L'impostazione per la campagna locale.
appCampaignSetting

object (AppCampaignSetting)

L'impostazione relativa alla campagna per app.
labels[]

string

Solo output. I nomi delle risorse delle etichette associate a questa campagna.
experimentType

enum (CampaignExperimentType)

Solo output. Il tipo di campagna: normale, bozza o sperimentale.
biddingStrategyType

enum (BiddingStrategyType)

Solo output. Il tipo di strategia di offerta.

Puoi creare una strategia di offerta impostando lo schema di offerta per creare una strategia di offerta standard o il campo biddingStrategy per creare una strategia di offerta di portafoglio.

Questo campo è di sola lettura.
accessibleBiddingStrategy

string

Solo output. Nome della risorsa AccessibleBiddingStrategy, una visualizzazione di sola lettura degli attributi senza restrizioni della strategia di offerta di portafoglio collegata identificata da "biddingStrategy". Vuoto, se la campagna non utilizza una strategia di portafoglio. Gli attributi della strategia senza limitazioni sono disponibili per tutti i clienti con cui la strategia è condivisa e vengono letti dalla risorsa AccessibleBiddingStrategy. Gli attributi con limitazioni, invece, sono disponibili solo per il cliente proprietario della strategia e per i relativi gestori. Gli attributi con limitazioni possono essere letti solo dalla risorsa BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

Un elenco che limita la frequenza con cui ogni utente vedrà gli annunci di questa campagna.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

Impostazione di sicurezza del brand a livello di singola campagna. Consente di selezionare un tipo di inventario per pubblicare gli annunci su contenuti adatti al tuo brand. Consulta la pagina https://support.google.com/google-ads/answer/7515513.
vanityPharma

object (VanityPharma)

Descrive come verranno visualizzati gli annunci farmaceutici senza brand.
selectiveOptimization

object (SelectiveOptimization)

Impostazione di ottimizzazione selettiva per questa campagna, che include un insieme di azioni di conversione in base alle quali ottimizzare la campagna. Questa funzionalità si applica solo alle campagne per app che utilizzano MULTI_CHANNEL come AdvertisingChannelType e APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT come AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

Impostazione dell'obiettivo di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.
trackingSetting

object (TrackingSetting)

Solo output. Impostazioni a livello di campagna per le informazioni di monitoraggio.
paymentMode

enum (PaymentMode)

Modalità di pagamento della campagna.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

I tipi di campi degli asset che devono essere esclusi da questa campagna. I link agli asset con questi tipi di campi non verranno ereditati da questa campagna dal livello superiore.
excludedParentAssetSetTypes[]

enum (AssetSetType)

I tipi di set di asset che devono essere esclusi da questa campagna. I link agli asset set con questi tipi non verranno ereditati da questa campagna dal livello superiore. I tipi di gruppi di località (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) sono tipi secondari di LOCATION_SYNC. Pertanto, se per questo campo è impostato LOCATION_SYNC, non è consentito collegare tutti gli insiemi di asset gruppo di località a questa campagna e tutte le estensioni di località (LE) e le estensioni di località dell'affiliato (ALE) non verranno pubblicate in questa campagna. Al momento è supportato solo LOCATION_SYNC.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

Solo output. Informazioni sulle campagne di cui è stato eseguito l'upgrade a Performance Max.
assetAutomationSettings[]

object (AssetAutomationSetting)

Contiene lo stato di attivazione/disattivazione di ogni AssetAutomationType. Consulta la documentazione di ogni enum del tipo di automazione delle risorse per il comportamento predefinito di attivazione/disattivazione.
keywordMatchType

enum (CampaignKeywordMatchType)

Tipo di corrispondenza delle parole chiave della campagna. Imposta su AMPIA per impostare la corrispondenza generica per tutte le parole chiave di una campagna.
id

string (int64 format)

Solo output. L'ID della campagna.
name

string

Il nome della campagna.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne.

Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
trackingUrlTemplate

string

Il modello di URL per la creazione di un URL di monitoraggio.
audienceSetting

object (AudienceSetting)

Immutabile. Impostazione per le funzionalità correlate al pubblico.
baseCampaign

string

Solo output. Il nome della risorsa della campagna di base di una bozza o di una campagna sperimentale. Per le campagne di base, questo valore è pari a resourceName.

Questo campo è di sola lettura.
campaignBudget

string

Il nome della risorsa del budget della campagna.
startDate

string

La data di inizio della pubblicazione della campagna nel fuso orario del cliente nel formato AAAA-MM-GG.
campaignGroup

string

Il nome della risorsa del gruppo di campagne a cui appartiene questa campagna.
endDate

string

L'ultimo giorno della campagna nel fuso orario del cliente in formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 30-12-2037, il che significa che la campagna verrà pubblicata a tempo indeterminato. Per impostare una campagna esistente in modo che venga pubblicata a tempo indeterminato, imposta questo campo su 30-12-2037.
finalUrlSuffix

string

Suffisso utilizzato per aggiungere parametri di query alle pagine di destinazione pubblicate con il monitoraggio parallelo.
optimizationScore

number

Solo output. Punteggio di ottimizzazione della campagna.

Il punteggio di ottimizzazione è una stima del livello di efficacia del rendimento di una campagna. Varia da 0% (0,0) a 100% (1,0), dove 100% indica che la campagna sta raggiungendo il massimo del suo potenziale. Questo campo è nullo per le campagne senza punteggio.

Consulta "Informazioni sul punteggio di ottimizzazione" all'indirizzo https://support.google.com/google-ads/answer/9061546.

Questo campo è di sola lettura.
urlExpansionOptOut

boolean

Rappresenta la disattivazione dell'espansione dell'URL a URL più mirati. Se la disattivazione è attiva (true), vengono scelti come target solo gli URL finali nel gruppo di asset o gli URL specificati in Google Merchant Center o nei feed di dati aziendali dell'inserzionista. Se l'opzione è attivata (false), verrà scelto come target l'intero dominio. Questo campo può essere impostato solo per le campagne Performance Max, in cui il valore predefinito è false.
hotelPropertyAssetSet

string

Immutabile. Il nome della risorsa per un insieme di hotel per le campagne Performance Max per gli obiettivi di viaggio.
listingType

enum (ListingType)

Immutabile. Tipo di scheda degli annunci pubblicati per questa campagna. Il campo è limitato per l'utilizzo con le campagne Performance Max.

Campo unione campaign_bidding_strategy. La strategia di offerta per la campagna.

Deve essere di tipo portafoglio (creata tramite il servizio BiddingStrategy) o standard, incorporata nella campagna. campaign_bidding_strategy può essere solo uno dei seguenti:
biddingStrategy

string

Il nome della risorsa della strategia di offerta di portafoglio utilizzata dalla campagna.
commission

object (Commission)

La strategia di offerta basata sulle commissioni è una strategia di offerta automatica in cui l'inserzionista paga una determinata parte del valore di conversione.
manualCpa

object (ManualCpa)

Strategia di offerta manuale basata sul CPA standard. Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta in base all'azione specificata dall'inserzionista. Supportato solo per le campagne di Servizi locali.
manualCpc

object (ManualCpc)

Strategia di offerta manuale basata su CPC standard. Offerte manuali basate sui clic in cui l'utente paga per clic.
manualCpm

object (ManualCpm)

Strategia di offerta CPM manuale standard. Offerte manuali basate sulle impressioni in cui l'utente paga per mille impressioni.
manualCpv

object (ManualCpv)

Una strategia di offerta che prevede il pagamento di un importo configurabile per ogni visualizzazione di video.
maximizeConversions

object (MaximizeConversions)

Strategia di offerta Massimizza le conversioni standard che massimizza automaticamente il numero di conversioni rispettando il budget.
maximizeConversionValue

object (MaximizeConversionValue)

Strategia di offerta Massimizza il valore di conversione standard che imposta automaticamente le offerte per massimizzare le entrate rispettando il budget.
targetCpa

object (TargetCpa)

Strategia di offerta basata su CPA target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target che hai definito.
targetImpressionShare

object (TargetImpressionShare)

Strategia di offerta basata sulla Quota impressioni target. Una strategia di offerte automatiche che imposta le offerte in modo da raggiungere una percentuale scelta di impressioni.
targetRoas

object (TargetRoas)

Strategia di offerta ROAS target standard che massimizza automaticamente le entrate, calcolando al contempo la media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
targetSpend

object (TargetSpend)

Strategia di offerta basata sulla spesa target standard che imposta automaticamente le offerte in modo da farti ottenere il maggior numero possibile di clic in base al tuo budget.
percentCpc

object (PercentCpc)

Strategia di offerta basata sul CPC percentuale standard in cui le offerte sono una frazione del prezzo pubblicizzato per un determinato bene o servizio.
targetCpm

object (TargetCpm)

Una strategia di offerta che ottimizza automaticamente il costo per mille impressioni.
fixedCpm

object (FixedCpm)

Una strategia di offerta manuale con un CPM fisso.
targetCpv

object (TargetCpv)

Una strategia di offerta automatica che imposta le offerte in modo da ottimizzare il rendimento in base al CPV target impostato.

CampaignPrimaryStatus

Enum che descrive il possibile stato principale della campagna. Forniscono informazioni sul motivo per cui una campagna non viene pubblicata o non viene pubblicata in modo ottimale. Le modifiche alla campagna e alle relative entità potrebbero richiedere un po' di tempo per essere applicate in questo stato.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ELIGIBLE La campagna è idonea alla pubblicazione.
PAUSED Lo stato della campagna specificato dall'utente è in pausa.
REMOVED Lo stato della campagna specificato dall'utente viene rimosso.
ENDED L'ora specificata dall'utente per la fine della campagna è trascorsa.
PENDING La campagna potrebbe essere pubblicata in futuro.
MISCONFIGURED La campagna o le entità associate hanno impostazioni specificate dall'utente non corrette.
LIMITED La campagna o le entità associate sono limitate dalle impostazioni specificate dall'utente.
LEARNING Il sistema delle offerte automatiche si adegua alle modifiche specificate dall'utente alla campagna o alle entità associate.
NOT_ELIGIBLE La campagna non è idonea alla pubblicazione.

CampaignPrimaryStatusReason

Enum che descrive i possibili motivi dello stato principale della campagna. Forniscono informazioni sul motivo per cui una campagna non viene pubblicata o non viene pubblicata in modo ottimale. Questi motivi vengono aggregati per determinare lo stato principale complessivo della campagna.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
CAMPAIGN_REMOVED Lo stato della campagna specificato dall'utente viene rimosso.
CAMPAIGN_PAUSED Lo stato della campagna specificato dall'utente è in pausa.
CAMPAIGN_PENDING L'ora specificata dall'utente per l'inizio di questa campagna è nel futuro.
CAMPAIGN_ENDED L'ora specificata dall'utente per la fine della campagna è trascorsa.
CAMPAIGN_DRAFT La campagna è una bozza.
BIDDING_STRATEGY_MISCONFIGURED La strategia di offerta presenta impostazioni specificate dall'utente errate.
BIDDING_STRATEGY_LIMITED La strategia di offerta è limitata dalle impostazioni specificate dall'utente, ad esempio la mancanza di dati o simili.
BIDDING_STRATEGY_LEARNING Il sistema delle offerte automatiche si sta adeguando alle modifiche alla strategia di offerta specificate dall'utente.
BIDDING_STRATEGY_CONSTRAINED La campagna potrebbe generare un valore di conversione maggiore modificando i target CPA/ROAS.
BUDGET_CONSTRAINED Il budget sta limitando la capacità di pubblicazione della campagna.
BUDGET_MISCONFIGURED Il budget contiene impostazioni specificate dall'utente errate.
SEARCH_VOLUME_LIMITED La campagna non ha come target tutte le query pertinenti.
AD_GROUPS_PAUSED Tutti gli stati dei gruppi di annunci specificati dall'utente sono in pausa.
NO_AD_GROUPS In questa campagna non sono presenti gruppi di annunci idonei.
KEYWORDS_PAUSED Tutti gli stati delle parole chiave specificati dall'utente sono in pausa.
NO_KEYWORDS Non sono presenti parole chiave idonee in questa campagna.
AD_GROUP_ADS_PAUSED Tutti gli stati degli annunci del gruppo di annunci specificati dall'utente sono in pausa.
NO_AD_GROUP_ADS In questa campagna non sono presenti annunci di gruppo di annunci idonei.
HAS_ADS_LIMITED_BY_POLICY Almeno un annuncio in questa campagna è limitato dalle norme.
HAS_ADS_DISAPPROVED Almeno un annuncio in questa campagna non è stato approvato.
MOST_ADS_UNDER_REVIEW La maggior parte degli annunci in questa campagna è in attesa di revisione.
MISSING_LEAD_FORM_EXTENSION La campagna ha un obiettivo relativo ai moduli per i lead, ma manca l'estensione modulo per i lead.
MISSING_CALL_EXTENSION La campagna ha un obiettivo relativo alle chiamate, ma manca l'estensione di chiamata.
LEAD_FORM_EXTENSION_UNDER_REVIEW L'estensione modulo per i lead è in corso di revisione.
LEAD_FORM_EXTENSION_DISAPPROVED L'estensione per i lead non è approvata.
CALL_EXTENSION_UNDER_REVIEW L'estensione di chiamata è in corso di revisione.
CALL_EXTENSION_DISAPPROVED L'estensione di chiamata non è approvata.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA In questa campagna non sono presenti criteri per gruppo di annunci per applicazioni mobile idonei.
CAMPAIGN_GROUP_PAUSED Lo stato del gruppo di campagne specificato dall'utente è in pausa.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Le date e gli orari specificati dall'utente per tutti i budget del gruppo associati al gruppo di campagne principale sono trascorsi.
APP_NOT_RELEASED L'app associata a questa campagna ACi non è stata rilasciata nei paesi di destinazione della campagna.
APP_PARTIALLY_RELEASED L'app associata a questa campagna ACi è stata rilasciata parzialmente nei paesi di destinazione della campagna.
HAS_ASSET_GROUPS_DISAPPROVED Almeno un gruppo di asset in questa campagna non è stato approvato.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY Almeno un gruppo di asset in questa campagna è limitato dalle norme.
MOST_ASSET_GROUPS_UNDER_REVIEW La maggior parte dei gruppi di asset in questa campagna è in attesa di revisione.
NO_ASSET_GROUPS In questa campagna non sono presenti gruppi di asset idonei.
ASSET_GROUPS_PAUSED Tutti i gruppi di asset in questa campagna sono in pausa.

CampaignStatus

Possibili stati di una campagna.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ENABLED La campagna è attiva e può pubblicare annunci.
PAUSED La campagna è stata messa in pausa dall'utente.
REMOVED La campagna è stata rimossa.

CampaignServingStatus

Possibili stati di pubblicazione di una campagna.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo per la risposta.
SERVING Pubblicazione.
NONE Nessuno.
ENDED Terminata.
PENDING In attesa.
SUSPENDED Sospeso.

BiddingStrategySystemStatus

I possibili stati di sistema di una strategia di offerta.

Enum
UNSPECIFIED Indica che si è verificato un errore imprevisto, ad esempio non è stato trovato alcun tipo di strategia di offerta o non sono state trovate informazioni sullo stato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ENABLED La strategia di offerta è attiva e AdWords non è in grado di individuare problemi specifici nella strategia.
LEARNING_NEW La strategia di offerta è in fase di apprendimento perché è stata creata o riattivata di recente.
LEARNING_SETTING_CHANGE La strategia di offerta è in fase di apprendimento a causa di una modifica recente delle impostazioni.
LEARNING_BUDGET_CHANGE La strategia di offerta è in fase di apprendimento a causa di una recente modifica del budget.
LEARNING_COMPOSITION_CHANGE La strategia di offerta è in fase di apprendimento a causa di una recente modifica del numero di campagne, gruppi di annunci o parole chiave associati.
LEARNING_CONVERSION_TYPE_CHANGE La strategia di offerta dipende dai report sulle conversioni e dai tipi di conversione modificati di recente dal cliente e pertinenti alla strategia di offerta.
LEARNING_CONVERSION_SETTING_CHANGE La strategia di offerta dipende dai report sulle conversioni e il cliente ha modificato di recente le impostazioni di conversione.
LIMITED_BY_CPC_BID_CEILING La strategia di offerta è limitata dal relativo limite di offerta.
LIMITED_BY_CPC_BID_FLOOR La strategia di offerta è limitata dal prezzo minimo dell'offerta.
LIMITED_BY_DATA La strategia di offerta è limitata perché nelle ultime settimane non è stato generato traffico di conversione sufficiente.
LIMITED_BY_BUDGET Una parte significativa delle parole chiave in questa strategia di offerta è limitata dal budget.
LIMITED_BY_LOW_PRIORITY_SPEND La strategia di offerta non può raggiungere la spesa target perché la sua priorità è stata ridotta.
LIMITED_BY_LOW_QUALITY Una parte significativa delle parole chiave in questa strategia di offerta presenta un punteggio di qualità basso.
LIMITED_BY_INVENTORY La strategia di offerta non può spendere completamente il budget a causa di un targeting ristretto.
MISCONFIGURED_ZERO_ELIGIBILITY Monitoraggio delle conversioni mancante (nessun ping presente) e/o elenchi per il remarketing per le campagne Shopping intelligenti.
MISCONFIGURED_CONVERSION_TYPES La strategia di offerta dipende dai report sulle conversioni e il cliente non dispone dei tipi di conversione che potrebbero essere registrati in base a questa strategia.
MISCONFIGURED_CONVERSION_SETTINGS La strategia di offerta dipende dai report sulle conversioni e le impostazioni di conversione del cliente non sono configurate correttamente.
MISCONFIGURED_SHARED_BUDGET Esistono campagne esterne alla strategia di offerta che condividono i budget con le campagne incluse nella strategia.
MISCONFIGURED_STRATEGY_TYPE La campagna ha un tipo di strategia non valido e non viene pubblicata.
PAUSED La strategia di offerta non è attiva. Alla strategia di offerta non sono associate campagne, gruppi di annunci o parole chiave attivi. In alternativa, non sono presenti budget attivi collegati alla strategia di offerta.
UNAVAILABLE Al momento questa strategia di offerta non supporta i report sullo stato.
MULTIPLE_LEARNING Durante il periodo in questione sono stati registrati più stati di sistema LEARNING_* per questa strategia di offerta.
MULTIPLE_LIMITED Durante il periodo in questione sono stati registrati più stati di sistema LIMITED_* per questa strategia di offerta.
MULTIPLE_MISCONFIGURED Durante il periodo in questione sono stati registrati più stati di sistema MISCONFIGURED_* per questa strategia di offerta.
MULTIPLE Durante il periodo in questione sono stati registrati più stati di sistema per questa strategia di offerta.

AdServingOptimizationStatus

Enum che descrive i possibili stati di pubblicazione.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo per la risposta.
OPTIMIZE La pubblicazione degli annunci viene ottimizzata in base al CTR della campagna.
CONVERSION_OPTIMIZE La pubblicazione degli annunci viene ottimizzata in base al CTR * Conversione per la campagna. Se la campagna non utilizza la strategia di offerta dello strumento per ottimizzare le conversioni, per impostazione predefinita viene selezionata l'opzione OTTIMIZZATA.
ROTATE Gli annunci vengono ruotati in modo uniforme per 90 giorni, poi ottimizzati per i clic.
ROTATE_INDEFINITELY Mostra gli annunci con rendimento più scarso in modo più uniforme insieme ad annunci con rendimento più elevato e non ottimizzare.
UNAVAILABLE Lo stato di ottimizzazione della pubblicazione degli annunci non è disponibile.

LocalServicesCampaignSettings

Impostazioni per la risorsa secondaria LocalServicesCampaign.

Rappresentazione JSON 
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
Campi
categoryBids[]

object (CategoryBid)

Offerte a livello di categoria associate alla strategia di offerta MANUAL_CPA.

CategoryBid

Offerte per categoria in LocalServicesReportingCampaignSettings.

Rappresentazione JSON 
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
Campi
categoryId

string

Categoria a cui verrà associata l'offerta. Ad esempio, xcat:service_area_business_plumber.
manualCpaBidMicros

string (int64 format)

Offerta CPA manuale per la categoria. L'offerta deve essere superiore al prezzo di riserva associato per la categoria in questione. Il valore è in micro e nella valuta dell'inserzionista.

TravelCampaignSettings

Impostazioni per la campagna per viaggi.

Rappresentazione JSON 
{
  "travelAccountId": string
}
Campi
travelAccountId

string (int64 format)

Immutabile. L'ID account per i viaggi associato alla campagna per i viaggi.

DemandGenCampaignSettings

Impostazioni per la campagna Demand Gen.

Rappresentazione JSON 
{
  "upgradedTargeting": boolean
}
Campi
upgradedTargeting

boolean

Immutabile. Specifica se questa campagna utilizza le opzioni di targeting di cui è stato eseguito l'upgrade. Quando questo campo è impostato su true, puoi utilizzare il targeting per località e lingua a livello di gruppo di annunci anziché il targeting standard a livello di campagna. Il valore predefinito di questo campo è false e può essere impostato solo durante la creazione di una campagna.

VideoCampaignSettings

Impostazioni per la campagna video.

Rappresentazione JSON 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Campi
videoAdInventoryControl

object (VideoAdInventoryControl)

Controllo dell'inventario per i contenitori degli annunci adattabili nelle campagne di copertura.

VideoAdInventoryControl

Per le campagne che utilizzano i controlli dell'inventario dei contenitori degli annunci adattabili, determinano su quali inventari possono essere pubblicati gli annunci. Questo vale solo per le campagne con le strategie di offerta TARGET_CPM e FIXED_CPM.

Rappresentazione JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Campi
allowInStream

boolean

Determina se VideoResponsiveAds può essere utilizzato per gli annunci video in-stream.
allowInFeed

boolean

Determina se VideoResponsiveAds può essere utilizzato per gli annunci video in-feed.
allowShorts

boolean

Determina se gli annunci video adattabili possono essere utilizzati come formato di Shorts.

RealTimeBiddingSetting

Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la rete Ad Exchange.

Rappresentazione JSON 
{
  "optIn": boolean
}
Campi
optIn

boolean

Indica se le offerte in tempo reale sono state attivate per la campagna.

NetworkSettings

Le impostazioni di rete per la campagna.

Rappresentazione JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
Campi
targetSearchNetwork

boolean

Indica se gli annunci devono essere pubblicati sui siti partner della rete di ricerca di Google (è necessario che targetGoogleSearch sia anche true).
targetContentNetwork

boolean

Indica se gli annunci verranno pubblicati in posizionamenti specifici della Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.
targetPartnerSearchNetwork

boolean

Se gli annunci verranno pubblicati sulla Rete partner di Google. Questa funzionalità è disponibile solo per alcuni account partner di Google selezionati.
targetYoutube

boolean

Se gli annunci verranno pubblicati su YouTube.
targetGoogleTvNetwork

boolean

Se gli annunci verranno pubblicati sulla rete Google TV.

HotelSettingInfo

Impostazioni a livello di campagna per gli annunci per hotel.

Rappresentazione JSON 
{
  "hotelCenterId": string
}
Campi
hotelCenterId

string (int64 format)

Immutabile. L'account Hotel Center collegato.

DynamicSearchAdsSetting

L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA).

Rappresentazione JSON 
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
Campi
domainName

string

Obbligatorio. Il nome di dominio internet rappresentato da questa impostazione, ad esempio "google.com" o "www.google.com".
languageCode

string

Obbligatorio. Il codice lingua che specifica la lingua del dominio, ad esempio "it".
feeds[]

string

L'elenco dei nomi delle risorse degli asset del feed di pagine associati alla campagna.
useSuppliedUrlsOnly

boolean

Indica se la campagna utilizza esclusivamente gli URL forniti dall'inserzionista.

ShoppingSetting

L'impostazione per le campagne Shopping. Definisce l'universo di prodotti che possono essere pubblicizzati dalla campagna e il modo in cui questa campagna interagisce con altre campagne Shopping.

Rappresentazione JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
Campi
feedLabel

string

L'etichetta del feed dei prodotti da includere nella campagna. È possibile impostare solo uno tra feedLabel o sales_country. Se utilizzato al posto di sales_country, il campo feedLabel accetta i codici paese nello stesso formato, ad esempio: "XX". In caso contrario, può essere qualsiasi stringa utilizzata per l'etichetta del feed in Google Merchant Center.
useVehicleInventory

boolean

Immutabile. Indica se scegliere come target l'inventario delle schede di veicoli. Questo campo è supportato solo nelle campagne Shopping intelligenti. Per impostare l'inventario delle schede di veicoli nelle campagne Performance Max, utilizza listingType.
advertisingPartnerIds[]

string (int64 format)

Immutabile. Gli ID account Google Ads dei partner pubblicitari che collaborano all'interno della campagna.
merchantId

string (int64 format)

ID dell'account Merchant Center. Questo campo è obbligatorio per le operazioni di creazione. Questo campo è immutabile per le campagne Shopping.
campaignPriority

integer

Priorità della campagna. Le campagne con priorità numeriche più elevate hanno la precedenza su quelle con priorità più basse. Questo campo è obbligatorio per le campagne Shopping e i valori devono essere compresi tra 0 e 2, inclusi. Questo campo è facoltativo per le campagne Shopping intelligenti, ma deve essere uguale a 3 se impostato.
enableLocal

boolean

Se includere i prodotti locali.
disableProductFeed

boolean

Disattiva il feed dei prodotti facoltativo. Al momento questo campo è supportato solo per le campagne Demand Gen. Per scoprire di più su questa funzionalità, visita la pagina https://support.google.com/google-ads/answer/13721750.

AudienceSetting

Impostazioni per il targeting per pubblico.

Rappresentazione JSON 
{
  "useAudienceGrouped": boolean
}
Campi
useAudienceGrouped

boolean

Immutabile. Se il valore è true, questa campagna utilizza una risorsa Segmento di pubblico per il targeting per pubblico. Se è false, questa campagna potrebbe utilizzare i criteri del segmento di pubblico.

GeoTargetTypeSetting

Rappresenta una raccolta di impostazioni relative al targeting geografico degli annunci.

Rappresentazione JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Campi
positiveGeoTargetType

enum (PositiveGeoTargetType)

L'impostazione utilizzata per il targeting geografico positivo in questa campagna specifica.
negativeGeoTargetType

enum (NegativeGeoTargetType)

L'impostazione utilizzata per il targeting geografico escluso in questa campagna specifica.

PositiveGeoTargetType

I possibili tipi di target geografico positivo.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
PRESENCE_OR_INTEREST Specifica che un annuncio viene attivato se l'utente si trova nelle località scelte come target dall'inserzionista o mostra interesse per queste località.
SEARCH_INTEREST Specifica che un annuncio viene attivato se l'utente cerca le località target dell'inserzionista. Questa funzionalità può essere utilizzata solo con le campagne sulla rete di ricerca e Shopping standard.
PRESENCE Specifica che un annuncio viene attivato se l'utente si trova o si trova regolarmente nelle località target dell'inserzionista.

NegativeGeoTargetType

I possibili tipi di target geografico esclusi.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
PRESENCE_OR_INTEREST Specifica che un utente non può visualizzare l'annuncio se si trova nelle località escluse dell'inserzionista o se mostra interesse per queste località.
PRESENCE Specifica che un utente non può visualizzare l'annuncio se si trova nelle località escluse dell'inserzionista.

LocalCampaignSetting

Impostazione della campagna per le campagne locali.

Rappresentazione JSON 
{
  "locationSourceType": enum (LocationSourceType)
}
Campi
locationSourceType

enum (LocationSourceType)

Il tipo di origine località per questa campagna locale.

LocationSourceType

I possibili tipi di un'origine località.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
GOOGLE_MY_BUSINESS Sedi associate al profilo dell'attività collegato del cliente.
AFFILIATE Sedi dei negozi (catene) degli affiliati. Ad esempio, le sedi dei negozi Best Buy.

AppCampaignSetting

Impostazioni a livello di campagna per le campagne per app.

Rappresentazione JSON 
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
Campi
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

Rappresenta l'obiettivo in base al quale deve essere ottimizzata la strategia di offerta di questa campagna per app.
appStore

enum (AppCampaignAppStore)

Immutabile. Lo store che distribuisce questa app specifica.
appId

string

Immutabile. Una stringa che identifica in modo univoco un'applicazione mobile.

AppCampaignBiddingStrategyGoalType

Tipo di obiettivo della strategia di offerta della campagna per app.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Cerca di massimizzare il numero di installazioni di app. L'offerta CPA è il costo per installazione target.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Cerca di massimizzare il numero a lungo termine delle conversioni in-app selezionate generate dalle installazioni di app. L'offerta CPA è il costo per installazione target.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Cerca di massimizzare il numero a lungo termine delle conversioni in-app selezionate generate dalle installazioni di app. L'offerta CPA è il costo per conversione in-app target. Tieni presente che all'inizio il CPA effettivo potrebbe sembrare superiore al CPA target, poiché le conversioni a lungo termine non si sono ancora verificate.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Mira a massimizzare il valore di tutte le conversioni, ad esempio le installazioni e le conversioni in-app selezionate, raggiungendo o superando il ritorno sulla spesa pubblicitaria target.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Cerca di massimizzare la preregistrazione dell'app.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Cerca di massimizzare l'installazione dell'app senza un costo per installazione target.

AppCampaignAppStore

Enum che descrive lo store della campagna per app.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
APPLE_APP_STORE Apple App Store.
GOOGLE_APP_STORE Google Play.

CampaignExperimentType

Indica se questa campagna è normale, una bozza o un esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
BASE Si tratta di una campagna standard.
DRAFT Questa è una versione di bozza di una campagna. Presenta alcune modifiche rispetto a una campagna di base, ma non pubblica né accumula metriche.
EXPERIMENT Questa è una versione sperimentale di una campagna. Presenta alcune modifiche rispetto a una campagna di base e una percentuale di traffico viene dirottata dalla campagna BASE a questa campagna sperimentale.

FrequencyCapEntry

Una regola che specifica il numero massimo di volte in cui un annuncio (o un insieme di annunci) può essere mostrato a un utente in un determinato periodo di tempo.

Rappresentazione JSON 
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
Campi
key

object (FrequencyCapKey)

La chiave di una determinata quota limite. Non può esistere più di una quota limite con la stessa chiave.
cap

integer

Numero massimo di eventi consentiti durante l'intervallo di tempo da questo limite.

FrequencyCapKey

Un gruppo di campi utilizzati come chiavi per una quota limite. Non può esistere più di una quota limite con la stessa chiave.

Rappresentazione JSON 
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
Campi
level

enum (FrequencyCapLevel)

Il livello a cui applicare il limite (ad es. annuncio del gruppo di annunci, gruppo di annunci). Il limite viene applicato a tutte le entità di questo livello.
eventType

enum (FrequencyCapEventType)

Il tipo di evento a cui si applica il limite (ad es. impressione).
timeUnit

enum (FrequencyCapTimeUnit)

Unità di tempo in cui è definito il limite (ad es. giorno, settimana).
timeLength

integer

Numero di unità di tempo di durata del limite.

FrequencyCapLevel

Il livello a cui applicare il limite (ad es.annuncio del gruppo di annunci, gruppo di annunci). Il limite viene applicato a tutte le risorse di questo livello.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
AD_GROUP_AD Il limite viene applicato a livello di annuncio del gruppo di annunci.
AD_GROUP Il limite viene applicato a livello di gruppo di annunci.
CAMPAIGN Il limite viene applicato a livello di campagna.

FrequencyCapEventType

Il tipo di evento a cui si applica il limite (ad es. impressione).

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
IMPRESSION Il limite si applica alle impressioni degli annunci.
VIDEO_VIEW Il limite si applica alle visualizzazioni degli annunci video.

VanityPharma

Descrive come verranno visualizzati gli annunci farmaceutici senza brand.

Rappresentazione JSON 
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
Campi
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

La modalità di visualizzazione per gli URL vanity farmaceutici.
vanityPharmaText

enum (VanityPharmaText)

Il testo che verrà visualizzato nell'URL di visualizzazione dell'annuncio di testo quando la descrizione del sito web è la modalità di visualizzazione selezionata per gli URL vanity per i prodotti farmaceutici.

VanityPharmaDisplayUrlMode

Enum che descrive le possibili modalità di visualizzazione per gli URL vanity farmaceutici.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
MANUFACTURER_WEBSITE_URL Sostituisci l'URL vanity pharma con l'URL del sito web del produttore.
WEBSITE_DESCRIPTION Sostituisci l'URL vanity pharma con la descrizione del sito web.

VanityPharmaText

Enum che descrive il testo possibile.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
PRESCRIPTION_TREATMENT_WEBSITE_EN Sito web riguardante cure con obbligo di prescrizione medica con contenuti in inglese.
PRESCRIPTION_TREATMENT_WEBSITE_ES Sito web riguardante cure con obbligo di prescrizione medica con contenuti in spagnolo (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN Sito web riguardante dispositivi con obbligo di prescrizione medica con contenuti in inglese.
PRESCRIPTION_DEVICE_WEBSITE_ES Sito web di dispositivi con obbligo di prescrizione medica con contenuti in spagnolo (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN Sito web riguardante dispositivi medici con contenuti in inglese.
MEDICAL_DEVICE_WEBSITE_ES Sito web riguardante dispositivi medici con contenuti in spagnolo (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN Sito web riguardante cure preventive con contenuti in inglese.
PREVENTATIVE_TREATMENT_WEBSITE_ES Sito web riguardante cure preventive con contenuti in spagnolo (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN Sito web riguardante contraccettivi con obbligo di prescrizione medica con contenuti in inglese.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES Sito web riguardante contraccettivi con obbligo di prescrizione medica con contenuti in spagnolo (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN Sito web riguardante vaccini con obbligo di prescrizione medica con contenuti in inglese.
PRESCRIPTION_VACCINE_WEBSITE_ES Sito web riguardante vaccini con obbligo di prescrizione medica con contenuti in spagnolo (Sitio de vacunas con receta).

SelectiveOptimization

Impostazione di ottimizzazione selettiva per questa campagna, che include un insieme di azioni di conversione in base alle quali ottimizzare la campagna. Questa funzionalità si applica solo alle campagne per app che utilizzano MULTI_CHANNEL come AdvertisingChannelType e APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT come AdvertisingChannelSubType.

Rappresentazione JSON 
{
  "conversionActions": [
    string
  ]
}
Campi
conversionActions[]

string

L'insieme selezionato di nomi di risorse per le azioni di conversione per l'ottimizzazione di questa campagna.

OptimizationGoalSetting

Impostazione dell'obiettivo di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.

Rappresentazione JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Campi
optimizationGoalTypes[]

enum (OptimizationGoalType)

L'elenco dei tipi di obiettivi di ottimizzazione.

OptimizationGoalType

Il tipo di obiettivo di ottimizzazione

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo come valore restituito. Rappresenta un valore sconosciuto in questa versione.
CALL_CLICKS Ottimizzazione per i clic sulle chiamate. Le conversioni di clic sulle chiamate corrispondono alle volte in cui gli utenti hanno selezionato "Chiama" per contattare un negozio dopo aver visualizzato un annuncio.
DRIVING_DIRECTIONS Ottimizza per le indicazioni stradali. Le conversioni di indicazioni stradali corrispondono alle volte in cui gli utenti hanno selezionato "Indicazioni stradali" per raggiungere un negozio dopo aver visualizzato un annuncio.
APP_PRE_REGISTRATION Ottimizza per la preregistrazione. Le conversioni di preregistrazione corrispondono al numero di utenti che si sono preregistrati per ricevere una notifica al momento del lancio dell'app.

TrackingSetting

Impostazioni a livello di campagna per le informazioni di monitoraggio.

Rappresentazione JSON 
{
  "trackingUrl": string
}
Campi
trackingUrl

string

Solo output. L'URL utilizzato per il monitoraggio dinamico.

PaymentMode

Enum che descrive le possibili modalità di pagamento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
CLICKS Pagamento per interazione.
CONVERSION_VALUE Pagamento per valore di conversione. Questa modalità è supportata solo dalle campagne con AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.STANDARD.
CONVERSIONS Pagamento per conversione. Questa modalità è supportata solo dalle campagne con AdvertisingChannelType.DISPLAY (escluso AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA e BudgetType.FIXED_CPA. Il cliente deve inoltre essere idoneo per questa modalità. Per maggiori dettagli, consulta Customer.eligibility_failure_reasons.
GUEST_STAY Valore del pagamento per soggiorno. Questa modalità è supportata solo dalle campagne con AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.STANDARD.

PerformanceMaxUpgrade

Informazioni sull'upgrade di una campagna a Performance Max.

Rappresentazione JSON 
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
Campi
performanceMaxCampaign

string

Solo output. Il nome della risorsa della campagna Performance Max a cui viene eseguito l'upgrade.
preUpgradeCampaign

string

Solo output. Il nome della risorsa della campagna precedente di cui è stato eseguito l'upgrade a Performance Max.
status

enum (PerformanceMaxUpgradeStatus)

Solo output. Lo stato dell'upgrade di una campagna per la quale è stato richiesto l'upgrade a Performance Max.

PerformanceMaxUpgradeStatus

Enum dello stato di upgrade a Performance Max per la campagna.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
UPGRADE_IN_PROGRESS L'upgrade a una campagna Performance Max è in corso.
UPGRADE_COMPLETE L'upgrade a una campagna Performance Max è stato completato.
UPGRADE_FAILED L'upgrade a una campagna Performance Max non è riuscito. La campagna continuerà a essere pubblicata come prima del tentativo di upgrade.
UPGRADE_ELIGIBLE La campagna è idonea per l'upgrade a una campagna Performance Max.

ListingType

Possibili tipi di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
VEHICLES Questa campagna pubblica annunci di veicoli.

AssetAutomationSetting

L'impostazione di automazione degli asset contiene una coppia di AssetAutomationType e lo stato di attivazione/disattivazione dell'automazione degli asset

Rappresentazione JSON 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
Campi
assetAutomationType

enum (AssetAutomationType)

Il tipo di automazione degli asset che l'inserzionista vuole attivare/disattivare.
assetAutomationStatus

enum (AssetAutomationStatus)

Lo stato di attivazione/disattivazione del tipo di automazione degli asset.

AssetAutomationType

Il tipo di automazione degli asset.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo come valore restituito. Rappresenta un valore sconosciuto in questa versione.
TEXT_ASSET_AUTOMATION L'automazione degli asset di testo include titoli e descrizioni. Per impostazione predefinita, gli inserzionisti attivano Performance Max e disattivano la rete di ricerca.

AssetAutomationStatus

Lo stato dell'automazione degli asset.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo come valore restituito. Rappresenta un valore sconosciuto in questa versione.
OPTED_IN Se l'opzione è attivata, sarà possibile generare e pubblicare un tipo di automazione degli asset.
OPTED_OUT Se disattivi un tipo di automazione degli asset, la generazione e la pubblicazione verranno interrotte.

CampaignKeywordMatchType

Enum che descrive il tipo di corrispondenza delle parole chiave della campagna.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
BROAD Corrispondenza generica a livello di campagna.

Commissione

La strategia di offerta basata sulle commissioni è una strategia di offerta automatica in cui l'inserzionista paga una determinata parte del valore di conversione.

Rappresentazione JSON 
{
  "commissionRateMicros": string
}
Campi
commissionRateMicros

string (int64 format)

La tariffa di commissione definisce la parte del valore di conversione che verrà fatturata all'inserzionista. Una tariffa di commissione pari a x deve essere passata a questo campo come (x * 1.000.000). Ad esempio, 106.000 rappresenta una tariffa di commissione pari a 0,106 (10,6%).

ManualCpa

Questo tipo non contiene campi.

Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta in base all'azione specificata dall'inserzionista.

ManualCpc

Offerte manuali basate sui clic in cui l'utente paga per clic.

Rappresentazione JSON 
{
  "enhancedCpcEnabled": boolean
}
Campi
enhancedCpcEnabled

boolean

Indica se le offerte devono essere migliorate in base ai dati dello Strumento per l'ottimizzazione delle conversioni.

ManualCpm

Questo tipo non contiene campi.

Offerte manuali basate sulle impressioni in cui l'utente paga per mille impressioni.

ManualCpv

Questo tipo non contiene campi.

Offerte basate sulle visualizzazioni in cui l'utente paga per ogni visualizzazione del video.

PercentCpc

Una strategia di offerta in cui le offerte sono una frazione del prezzo pubblicizzato per un determinato bene o servizio.

Rappresentazione JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Campi
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Si tratta di un campo facoltativo inserito dall'inserzionista e specificato nei micro annunci locali. Nota: un valore pari a zero viene interpretato nello stesso modo in cui il valore bid_ceiling è undefined.
enhancedCpcEnabled

boolean

Modifica l'offerta per ogni asta verso l'alto o verso il basso, a seconda della probabilità di una conversione. Le singole offerte possono superare cpcBidCeilingMicros, ma l'importo medio dell'offerta per una campagna non deve farlo.

TargetCpm

Il CPM target (costo per mille impressioni) è una strategia di offerta automatica che imposta le offerte in modo da ottimizzare il rendimento in base al CPM target impostato.

Rappresentazione JSON 
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
Campi
Campo unione goal. Informazioni aggiuntive relative all'obiettivo di offerta. goal può essere solo uno dei seguenti:
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

Dettagli sull'obiettivo di offerta con frequenza target.

TargetCpmTargetFrequencyGoal

Dettagli sull'obiettivo di offerta con frequenza target.

Rappresentazione JSON 
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
Campi
targetCount

string (int64 format)

Conteggio della frequenza target che indica quante volte vuoi raggiungere un singolo utente.
timeUnit

enum (TargetFrequencyTimeUnit)

Finestra temporale che esprime il periodo durante il quale vuoi raggiungere il targetCount specificato.

Cpm fisso

Strategia di offerta CPM (costo per mille impressioni) fisso. Una strategia di offerta manuale con un CPM fisso.

Rappresentazione JSON 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
Campi
goal

enum (FixedCpmGoal)

Obiettivo di offerta CPM fisso. Determina i parametri esatti di ottimizzazione delle offerte.
Campo unione goal_info. Informazioni aggiuntive relative all'obiettivo di offerta. goal_info può essere solo uno dei seguenti:
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

Dettagli sull'obiettivo di offerta con frequenza target.

FixedCpmGoal

Enum che descrive lo scopo della strategia di offerta CPM fisso.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
REACH Massimizzare la copertura, ovvero il numero di utenti che hanno visto gli annunci di questa campagna.
TARGET_FREQUENCY Offerenti CPM con frequenza target. Ottimizza le offerte per raggiungere un singolo utente con la frequenza richiesta.

FixedCpmTargetFrequencyGoalInfo

Dettagli dell'obiettivo di offerta basata sulla frequenza target per la strategia di offerta CPM fisso. Rilevante solo se l'obiettivo della strategia di offerta è TARGET_FREQUENCY.

Rappresentazione JSON 
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
Campi
targetCount

string (int64 format)

Il conteggio della frequenza target rappresenta il numero di volte in cui un inserzionista vuole mostrare l'annuncio per scegliere come target un singolo utente.
timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

Finestra temporale che esprime il periodo durante il quale vuoi raggiungere il targetCount specificato.

FixedCpmTargetFrequencyTimeUnit

Un enum che descrive la finestra temporale in cui le offerte vengono ottimizzate per raggiungere la frequenza target quando si utilizza la strategia di offerta CPM fisso.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
MONTHLY Ottimizza le offerte per raggiungere la frequenza target in 30 giorni.

TargetCpv

Questo tipo non contiene campi.

Strategia di offerta basata sul CPV (costo per visualizzazione) target. Una strategia di offerta automatica che imposta le offerte in modo da ottimizzare il rendimento in base al CPV target impostato.