Attenzione: stai visualizzando la documentazione per l'interfaccia REST dell'API. La maggior parte delle nostre librerie client ufficiali utilizza gRPC. Per informazioni dettagliate, consulta la Introduzione a REST.

Questa pagina è stata tradotta dall'API Cloud Translation.

CampaignBudget

Rappresentazione JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Il budget di una campagna.

Rappresentazione JSON

Rappresentazione JSON
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

Campi
`resourceName`	`string` Immutabile. Il nome della risorsa del budget della campagna. I nomi delle risorse del budget della campagna hanno il seguente formato: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Solo output. Lo stato del budget di questa campagna. Questo campo è di sola lettura.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Il metodo di pubblicazione che determina la frequenza con cui viene speso il budget della campagna. Se non specificato in un'operazione di creazione, il valore predefinito è STANDARD.
`period`	`enum (BudgetPeriod)` Immutabile. Periodo durante il quale spendere il budget. Se non specificato, il valore predefinito è DAILY.
`type`	`enum (BudgetType)` Immutabile. Il tipo di budget della campagna.
`alignedBiddingStrategyId`	`string (int64 format)` ID della strategia di offerta di portafoglio a cui è allineato il budget condiviso della campagna. Quando una strategia di offerta e il budget di una campagna sono allineati, vengono associati allo stesso insieme di campagne. Dopo aver allineato il budget di una campagna a una strategia di offerta, anche le campagne aggiunte al budget della campagna devono utilizzare la strategia di offerta allineata.
`id`	`string (int64 format)` Solo output. L'ID del budget della campagna. Il budget di una campagna viene creato utilizzando l'operazione di creazione CampaignBudgetService e viene assegnato un ID budget. Un ID budget può essere condiviso tra più campagne; il sistema distribuirà quindi il budget della campagna tra più campagne per ottenere risultati ottimali.
`name`	`string` Il nome del budget della campagna. Quando crei un budget di campagna tramite CampaignBudgetService, ogni budget di campagna esplicitamente condiviso deve avere un nome con valore non null e non vuoto. I budget delle campagne che non sono condivisi esplicitamente derivano dal nome della campagna associata. La lunghezza di questa stringa deve essere compresa tra 1 e 255 (inclusi) in byte UTF-8 (tagliati).
`amountMicros`	`string (int64 format)` L'importo del budget nella valuta locale dell'account. L'importo è specificato in micro, dove un milione equivale a un'unità di valuta. La spesa mensile è limitata a 30,4 volte questo importo.
`totalAmountMicros`	`string (int64 format)` L'importo complessivo del budget nella valuta locale dell'account. L'importo è specificato in micro, dove un milione equivale a un'unità di valuta.
`explicitlyShared`	`boolean` Specifica se il budget è condiviso esplicitamente. Il valore predefinito è true se non specificato in un'operazione di creazione. Se è impostato su true, il budget è stato creato con lo scopo di condividerlo tra una o più campagne. Se è impostato su false, il budget è stato creato con l'intento di utilizzarlo solo per una singola campagna. Il nome e lo stato del budget rimarranno sincronizzati con il nome e lo stato della campagna. Se si tenta di condividere il budget con una seconda campagna, si verifica un errore. Un budget non condiviso può diventare esplicitamente condiviso. La stessa operazione deve anche assegnare un nome al budget. Un budget di campagna condiviso non può mai diventare non condiviso.
`referenceCount`	`string (int64 format)` Solo output. Il numero di campagne che utilizzano attivamente il budget. Questo campo è di sola lettura.
`hasRecommendedBudget`	`boolean` Solo output. Indica se è presente un budget consigliato per questo budget della campagna. Questo campo è di sola lettura.
`recommendedBudgetAmountMicros`	`string (int64 format)` Solo output. L'importo del budget consigliato. Se non sono disponibili consigli, verrà impostato l'importo del budget. L'importo è specificato in micro, dove un milione equivale a un'unità di valuta. Questo campo è di sola lettura.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Solo output. La variazione stimata dei clic settimanali se viene applicato il budget consigliato. Questo campo è di sola lettura.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Solo output. Variazione stimata del costo settimanale in micro se viene applicato il budget consigliato. Un milione è equivalente a un'unità di valuta. Questo campo è di sola lettura.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Solo output. La variazione stimata delle interazioni settimanali se viene applicato il budget consigliato. Questo campo è di sola lettura.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Solo output. La variazione stimata delle visualizzazioni settimanali se viene applicato il budget consigliato. Questo campo è di sola lettura.

BudgetStatus

Possibili stati di un budget.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`ENABLED`	Il budget è attivato.
`REMOVED`	Il budget è stato rimosso.

BudgetDeliveryMethod

Possibili metodi di pubblicazione di un budget.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`STANDARD`	Il server del budget limiterà la pubblicazione in modo uniforme per tutto il periodo di tempo.
`ACCELERATED`	Il server di budget non limiterà la pubblicazione e gli annunci verranno pubblicati il più rapidamente possibile.

BudgetPeriod

Possibile periodo di un budget.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`DAILY`	Budget giornaliero.
`CUSTOM_PERIOD`	Budget personalizzato, riaggiunto nella V5. Il budget personalizzato può essere utilizzato con total_amount per specificare il limite di budget per tutta la durata. Per saperne di più, consulta la pagina https://support.google.com/google-ads/answer/6385083.

BudgetType

Possibili tipi di budget.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`STANDARD`	Tipo di budget per l'utilizzo standard di Google Ads. Limita la spesa giornaliera al doppio dell'importo del budget specificato. Dettagli completi: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Tipo di budget con costo per acquisizione fisso (conversione). Dettagli completi: https://support.google.com/google-ads/answer/7528254 Questo tipo è supportato solo dalle campagne con AdvertisingChannelType.DISPLAY (escluse AdvertisingChannelSubType.DISPLAY_Gmail), BiddingStrategyType.TARGET_CPA e PaymentMode.CONVERSION.
`SMART_CAMPAIGN`	Tipo di budget per la campagna intelligente. Dettagli completi: https://support.google.com/google-ads/answer/7653509 Questo tipo è supportato solo dalle campagne con AdvertisingChannelType.SMART e AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Tipo di budget per la campagna di Servizi locali. Dettagli completi: https://support.google.com/localservices/answer/7434558 Questo tipo è supportato solo dalle campagne con AdvertisingChannelType.LOCAL_SERVICE.