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。预算 ID 可在不同的广告系列之间共享;然后,系统会在不同的广告系列之间分配广告系列预算,以获得较佳结果。

name

string

广告系列预算的名称。

通过 CampaignBudgetService 创建广告系列预算时,每个明确共享的广告系列预算都必须具有一个非 null、非空的名称。未明确共享的广告系列预算的名称取自附加的广告系列的名称。

此字符串的长度必须介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。

amountMicros

string (int64 format)

预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为此金额的 30.4 倍。

totalAmountMicros

string (int64 format)

预算的生命周期金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。

explicitlyShared

boolean

指定预算是否明确共享。如果在创建操作中未指定此参数,则默认为 true。

如果为 true,则表明创建预算的目的是在一个或多个广告系列之间共享。

如果为 false,则创建预算的意图是仅用于一个广告系列。预算的名称和状态会与广告系列的名称和状态保持同步。尝试与第二个广告系列共享预算会导致错误。

非共享预算可以成为明确共享的预算。此外,此操作还必须为预算指定名称。

共享的广告系列预算绝不能成为非共享预算。

referenceCount

string (int64 format)

仅供输出。正在使用预算的广告系列的数量。

此字段为只读字段。

recommendedBudgetAmountMicros

string (int64 format)

仅供输出。建议的预算金额。如果没有建议,则此字段设置为预算金额。金额以微单位指定,即一百万等同于一个货币单位。

此字段为只读字段。

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 自定义预算,在 V5 中重新添加。自定义预算可与 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 的广告系列支持此类型。