广告系列预算。
JSON 表示法 |
---|
{ "resourceName": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。广告系列预算的资源名称。广告系列预算资源名称的格式为:
|
status |
仅限输出。广告系列预算的状态。此字段为只读字段。 |
deliveryMethod |
决定广告系列预算的支出费率的投放方式。 如果在创建操作中未指定,则默认为 STANDARD。 |
period |
不可变。支出预算的时间段。如果未指定,则默认为 DAILY。 |
type |
不可变。广告系列预算的类型。 |
alignedBiddingStrategyId |
与此共享预算的广告系列预算对应的组合出价策略的 ID。当出价策略和广告系列预算一致时,它们会关联到同一组广告系列。在广告系列预算与出价策略保持一致后,添加到广告系列预算的广告系列也必须使用相符的出价策略。 |
id |
仅限输出。广告系列预算的 ID。 广告系列预算通过 CampaignBudgetService 创建操作创建,并分配有预算 ID。预算 ID 可在不同的广告系列之间共享;然后,系统会在不同的广告系列之间分配广告系列预算,以获得较佳结果。 |
name |
广告系列预算的名称。 通过 CampaignBudgetService 创建广告系列预算时,每个明确共享的广告系列预算都必须具有一个非 null、非空的名称。未明确共享的广告系列预算会从附加的广告系列的名称派生其名称。 此字符串的长度必须介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 |
amountMicros |
预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为该金额的 30.4 倍。 |
totalAmountMicros |
预算的生命周期金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。 |
explicitlyShared |
指定预算是否明确共享。如果在创建操作中未指定,则默认为 true。 如果为 true,则说明创建预算的目的是在一个或多个广告系列之间共享。 如果为 false,则创建预算的意图是仅用于一个广告系列。预算的名称和状态会与广告系列的名称和状态保持同步。尝试与另外一个广告系列共享预算将导致错误。 非共享预算可以成为明确共享的预算。此操作还必须为预算指定名称。 共享的广告系列预算绝不能成为非共享预算。 |
referenceCount |
仅限输出。当前使用该预算的广告系列的数量。 此字段为只读字段。 |
hasRecommendedBudget |
仅限输出。指明系统是否为此广告系列预算提供了建议的预算。 此字段为只读字段。 |
recommendedBudgetAmountMicros |
仅限输出。建议的预算金额。如果没有建议,则此字段设置为预算金额。金额以微单位指定,即一百万等同于一个货币单位。 此字段为只读字段。 |
recommendedBudgetEstimatedChangeWeeklyClicks |
仅限输出。采纳建议的预算后,每周点击次数的预计变化。 此字段为只读字段。 |
recommendedBudgetEstimatedChangeWeeklyCostMicros |
仅限输出。采纳建议的预算后,每周费用的估算变化(以微单位表示)。一百万个货币单位相当于一个货币单位。 此字段为只读字段。 |
recommendedBudgetEstimatedChangeWeeklyInteractions |
仅限输出。应用建议的预算后,每周互动次数的预期变化。 此字段为只读字段。 |
recommendedBudgetEstimatedChangeWeeklyViews |
仅限输出。应用建议的预算后,每周观看次数的预计变化。 此字段为只读字段。 |
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)、BidStrategyType.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 的广告系列支持此类型。 |