CampaignBudget

廣告活動預算。

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

不可變動。廣告活動預算的資源名稱。廣告活動預算資源名稱的格式如下：

customers/{customerId}/campaignBudgets/{campaign_budget_id}
status

enum (BudgetStatus)

僅供輸出。這個廣告活動預算的狀態。這是唯讀欄位。
deliveryMethod

enum (BudgetDeliveryMethod)

這個放送方式會決定廣告活動預算支出速度。

如果建立作業中未指定，則預設值為 STANDARD。
period

enum (BudgetPeriod)

不可變動。預算的使用期間。若未指定，則預設為 DAILY。
type

enum (BudgetType)

不可變動。廣告活動預算的類型。
alignedBiddingStrategyId

string (int64 format)

此共用預算的組合出價策略 ID。出價策略和廣告活動預算一致時，兩者會附加至同一組廣告活動。根據出價策略調整廣告活動預算後，新增至廣告活動預算的廣告活動也必須採用一致的出價策略。
id

string (int64 format)

僅供輸出。廣告活動預算的 ID。

使用 CampaignBudgetService 建立作業建立廣告活動預算，並指派預算編號。同一個預算 ID 可由不同的廣告活動共用，接著系統會將廣告活動預算分配給不同的廣告活動，以爭取最佳成效。
name

string

廣告活動預算的名稱。

透過 CampaignBudgetService 建立廣告活動預算時，每個明確共用的廣告活動預算都必須使用非空值且不可空白的名稱。未明確共用的廣告活動預算會從附加的廣告活動名稱中擷取名稱。

此字串的長度必須介於 1 到 255 之間 (含首尾)，以 UTF-8 位元組為單位 (已剪輯)。
amountMicros

string (int64 format)

預算金額，以帳戶當地幣別表示。金額是以微量指定，100 萬相當於一個貨幣單位。每月支出上限為這個金額的 30.4 倍。
totalAmountMicros

string (int64 format)

預算效期內金額，以帳戶的當地幣別表示。金額是以微量指定，100 萬相當於一個貨幣單位。
explicitlyShared

boolean

指定是否明確共用預算。如果建立作業中未指定，則預設值為 true。

如果設為「true」，表示預算建立時即是與一或多個廣告活動共用。

如果設為 false，表示該預算僅用於單一廣告活動。預算的名稱和狀態會與廣告活動的名稱和狀態保持同步。如果嘗試與第二個廣告活動共用預算，就會發生錯誤。

非共用預算可明確共用。同樣地，您也必須為預算指定預算名稱。

共用預算無法設為非共用。
referenceCount

string (int64 format)

僅供輸出。正在使用該預算的廣告活動數量。

這是唯讀欄位。
recommendedBudgetAmountMicros

string (int64 format)

僅供輸出。建議的預算金額。如果沒有可用的最佳化建議，系統會將這個金額設為預算金額。金額是以微量指定，100 萬相當於一個貨幣單位。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

僅供輸出。採用建議預算後，每週點擊次數的預估變化。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

僅供輸出。採用建議預算後，每週費用的預估變化 (以百萬分之一為單位)。100 萬相當於一個貨幣單位。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

僅供輸出。採用建議預算後，每週互動次數的預估變化。

這是唯讀欄位。
recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

僅供輸出。採用建議預算後，每週觀看次數的預估變化。

這是唯讀欄位。

BudgetStatus

預算的可能狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
ENABLED 已啟用預算。
REMOVED 已移除預算。

BudgetDeliveryMethod

預算的可能放送方式。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
STANDARD 預算伺服器會監控放送期間，平均分配廣告放送時間。
ACCELERATED 預算伺服器不會節流放送，且會盡快放送廣告。

BudgetPeriod

預算可能的期間。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
DAILY 每日預算：
CUSTOM_PERIOD 自訂預算，已在第 5 版加回。自訂預算可以與 total_amount 搭配使用，藉此指定生命週期預算上限。詳情請參閱：https://support.google.com/google-ads/answer/6385083。

BudgetType

可能的預算類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
STANDARD 標準 Google Ads 用量的預算類型。將每日支出上限設為指定預算金額的兩倍。完整詳情：https://support.google.com/google-ads/answer/6385083
FIXED_CPA

採用固定單次轉換出價 (轉換) 的預算類型。完整詳情：https://support.google.com/google-ads/answer/7528254

這個類型僅適用於採用 AdvertisingChannelType.DISPLAY 的廣告活動 (不包括 AdvertisingChannelSubType.DISPLAY_gmail)、 BiddingStrategyType.TARGET_CPA 和 PaymentMode.CONVERSIONS。
SMART_CAMPAIGN

智慧廣告活動的預算類型。完整詳情：https://support.google.com/google-ads/answer/7653509

只有採用 AdvertisingChannelType.SMART 和 AdvertisingChannelSubType.SMART_CAMPAIGN 的廣告活動支援這種類型。
LOCAL_SERVICES

在地生活服務廣告活動的預算類型。完整詳細資料：https://support.google.com/localservices/answer/7434558

只有含有 AdvertisingChannelType.LOCAL_SERVICES 的廣告活動支援這種類型。