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 di 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 di spesa del 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 questo 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 che il budget di una campagna è stato allineato 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. Un budget di campagna viene creato utilizzando l'operazione di creazione CampaignBudgetService e gli viene assegnato un ID budget. Un ID budget può essere condiviso tra più campagne; il sistema distribuirà quindi il budget tra le diverse campagne per ottenere risultati ottimali.
`name`	`string` Il nome del budget della campagna. Quando crei un budget di una campagna tramite CampaignBudgetService, ogni budget di campagna condiviso in modo esplicito deve avere un nome che non sia null e vuoto. I budget delle campagne che non vengono 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. Il limite di spesa mensile è pari 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. Se non specificato in un'operazione di creazione, il valore predefinito è true. Se il valore è true, il budget è stato creato per condividerlo tra una o più campagne. Se il valore è false, il budget è stato creato con l'intenzione di essere utilizzato solo in una singola campagna. Il nome e lo stato del budget rimarranno sincronizzati con il nome e lo stato della campagna. Se provi a condividere il budget con una seconda campagna si verifica un errore. Un budget non condiviso può diventare esplicitamente condiviso. Nella stessa operazione è necessario anche assegnare un nome al budget. Un budget condiviso di una campagna 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 è disponibile 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. 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 equivale a un'unità di valuta. Questo campo è di sola lettura.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Solo output. 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 budget limiterà la pubblicazione in modo uniforme per l'intero periodo di tempo.
`ACCELERATED`	Il server budget non limiterà la pubblicazione e gli annunci verranno pubblicati il più velocemente 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, aggiunto di nuovo nella V5. È possibile utilizzare un budget personalizzato con total_amount per specificare il limite di budget complessivo. 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.