Pacing

控制預算支出速度的設定。

JSON 表示法
{
  "pacingPeriod": enum (PacingPeriod),
  "pacingType": enum (PacingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dailyMaxMicros": string,
  "dailyMaxImpressions": string
  // End of mutually exclusive fields.
}
欄位
pacingPeriod

enum (PacingPeriod)

必填。使用預算的時間範圍。

如果透過 automationType 在廣告訂單啟用自動預算分配功能,這個欄位僅供輸出,且預設為 PACING_PERIOD_FLIGHT。

pacingType

enum (PacingType)

必填。使用速度類型,定義預算金額在pacingPeriod中的支出方式。

PACING_TYPE_ASAP與廣告訂單的pacingPeriod PACING_PERIOD_FLIGHT不相容。

pacing_period 設為 PACING_PERIOD_DAILY 時適用。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位:
dailyMaxMicros

string (int64 format)

每日最高支出金額 (以廣告主幣別的百萬分之一為單位)。

適用於以貨幣為準的預算。值必須大於 0,舉例來說,如要設定 1.5 個標準貨幣單位,請在這個欄位輸入 1500000。

系統會根據下列規則,將指派的值四捨五入至相關幣別的整數計費單位:任何小於單一計費單位的正值都會無條件進位至一個計費單位,任何大於單一計費單位的值則會無條件捨去至最接近的計費值。舉例來說,如果貨幣的可計費單位為 0.01,且這個欄位設為 10257770,系統會無條件捨去至 10250000,也就是 10.25。如果設為 505,則會無條件進位至 10000,也就是 0.01。

dailyMaxImpressions

string (int64 format)

每天放送的曝光次數上限。

適用於以曝光為依據的預算。必須大於 0。

互斥欄位結束。

PacingPeriod

可能用於支出使用速度金額的時間範圍。

列舉
PACING_PERIOD_UNSPECIFIED 未指定週期值,或這個版本不支援。
PACING_PERIOD_DAILY 系統會每天套用使用速度設定。
PACING_PERIOD_FLIGHT 使用速限設定會套用至整個檔期。

PacingType

可能的使用速度類型。

列舉
PACING_TYPE_UNSPECIFIED 未指定配速模式值,或這個版本不支援該值。
PACING_TYPE_AHEAD 僅適用於PACING_PERIOD_FLIGHT使用打底期。「超前」使用速度會嘗試用比「平均」稍快的方式支出預算,確保在檔期結束前用盡所有預算。
PACING_TYPE_ASAP 盡快用完所有預算。
PACING_TYPE_EVEN 每個時間範圍內支出固定的預算金額。