AdGroupBuilder

包含用于定义和添加广告组的方法。 有关生成器的信息，请参阅 生成器。

示例用法：

    // Get a campaign to add the ad group to.
    var iterator = AdsApp.campaigns()
        .withIds(['CAMPAIGN ID GOES HERE'])
        .get();

    while (iterator.hasNext()) {
        var campaign = iterator.next();

        // Get the campaign's ad group builder and add an ad group.
        var operation = campaign.newAdGroupBuilder()
            .withName("AD GROUP NAME GOES HERE")
            .withStatus("ENABLED")
            .build();
    
        // See the Builders topic for performance considerations
        // when using the operation object's methods.
        if (!operation.isSuccessful()) {
            for (var error of operation.getErrors()) {
                Logger.log(`${error}\n`);
            }
        }
    }

方法

方法名称 返回类型 说明
build AdGroupOperation 创建广告组，并返回用于检查广告组是否添加成功的操作对象。
withBiddingStrategy (字符串 biddingStrategy) AdGroupBuilder 设置广告组的出价策略。
withCpc (双 cpc) AdGroupBuilder 设置广告组的最高 CPC 出价。
withCpm (双 CPM) AdGroupBuilder 设置广告组的最高每千次展示费用出价。
withCpv (双 cpv) AdGroupBuilder 设置广告组的最高 CPV 出价。
withCustomParameters (对象 customParameters) AdGroupBuilder 设置广告组的自定义参数。
withEndDate (字符串 endDate) AdGroupBuilder 设置广告组中的广告停止投放的日期。
withEndDate (对象 endDate) AdGroupBuilder 设置广告组中的广告停止投放的日期。
withLanguage (字符串语言) AdGroupBuilder 设置此广告组使用的语言。
withName (字符串名称) AdGroupBuilder 设置广告组的名称。
withStartDate (字符串 startDate) AdGroupBuilder 设置广告组中的广告开始投放的日期。
withStartDate (对象 startDate) AdGroupBuilder 设置广告组中的广告开始投放的日期。
withStatus (字符串状态) AdGroupBuilder 设置广告组的状态。
withTrackingTemplate (字符串 trackingTemplate) AdGroupBuilder 设置广告组的跟踪模板。

build

创建广告组，并返回用于检查广告组是否添加成功的操作对象。

返回

类型 说明
AdGroupOperation 用于检查广告组是否已成功添加的操作对象。

withBiddingStrategy (字符串 biddingStrategy)

设置广告组的出价策略。

参数

名称 类型 说明
biddingStrategy string 要应用于广告组的出价策略。 下面是可能的区分大小写的值。
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
有关这些策略的信息，请参阅 出价策略类型。

返回

类型 说明
AdGroupBuilder 应用出价策略的广告组生成器。

withCpc (双 cpc)

设置广告组的每次点击费用出价。

指定当关键字 (keyword) 与用户的搜索字词匹配且广告组的出价策略为MANUAL_CPC时要使用的出价金额。 如果较低级别的实体（如 关键字 (keyword) ）不覆盖它，则使用此出价。

参数

名称 类型 说明
cpc double 广告组的最高 CPC 出价。 账户的币种决定了最低和最高出价。 有关详细信息，请参阅 出价和预算货币。

返回

类型 说明
AdGroupBuilder 应用了 CPC 出价的广告组生成器。

withCpm (双 CPM)

设置广告组的每千次展示费用出价。

指定每 1,000 次观看要使用的出价金额，以及何时MANUAL_CPM广告组的出价策略。

参数

名称 类型 说明
CPM double 广告组的最高每千次展示费用出价。 账户的币种决定了最低和最高出价。 有关详细信息，请参阅 出价和预算货币。

返回

类型 说明
AdGroupBuilder 应用了 CPM 出价的广告组生成器。

withCpv (双 cpv)

设置广告组的每次观看费用出价。

指定视频广告每次观看或每次点击使用的出价金额，以及何时MANUAL_CPV广告组的出价策略。

参数

名称 类型 说明
cpv double 广告组的最高每次观看费用出价。 账户的币种决定了最低和最高出价。 有关详细信息，请参阅 出价和预算货币。

返回

类型 说明
AdGroupBuilder 应用了 CPV 出价的广告组生成器。

withCustomParameters (对象 customParameters)

设置要在最终到达 URL 或跟踪模板中使用的广告组自定义参数。

自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息，请参阅 自定义参数。

参数

名称 类型 说明
customParameters Object 最多包含三个要应用于广告组的自定义参数的映射。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自定义参数的名称，value 是参数的值。 该名称最多可包含 16 个 8 字节字符，值最多可包含 200 个 8 字节字符。

返回

类型 说明
AdGroupBuilder 应用了自定义参数的广告组生成器。

withEndDate (字符串 endDate)

设置广告组中的广告停止投放的日期。 仅当您希望组中的广告在特定日期停止投放时，才调用此方法。

参数

名称 类型 说明
endDate string 停止投放广告的日期。 以 YYYYMMDD 格式指定日期。

返回

类型 说明
AdGroupBuilder 应用了结束日期的广告组生成器。

withEndDate (对象 endDate)

设置广告组中的广告停止投放的日期。 仅当您希望组中的广告在特定日期停止投放时，才调用此方法。

参数

名称 类型 说明
endDate Object 停止投放广告的日期。 使用具有以下字段的对象指定日期：
  • year
  • month
  • day

例如：var date = {year: 2018, month: 5, day: 13};

月份为基础，其中 1 为 1 月，12 为 12 月。

返回

类型 说明
AdGroupBuilder 应用了结束日期的广告组生成器。

withLanguage (字符串语言)

设置此广告组中的广告使用的语言。

默认情况下，广告组从其父广告系列继承语言。 在广告组级别指定语言以替代在市场活动级别指定的语言，或者如果市场活动未指定语言 (则必须在市场活动和/或广告组级别指定语言) 。

参数

名称 类型 说明
language string 广告组中的广告使用的语言。 例如，英语。 字符串不区分大小写。 不要使用两个字符的语言代码。 有关受支持语言的列表，请参阅 广告语言。

返回

类型 说明
AdGroupBuilder 应用语言的广告组生成器。

withName (字符串名称)

设置广告组的名称。

参数

名称 类型 说明
name string 广告组的名称。 名称为必填项。 该名称最多可包含 256 个字符，并且必须在市场活动中的所有活动广告组中唯一。

返回

类型 说明
AdGroupBuilder 应用名称的广告组生成器。

withStartDate (字符串 startDate)

设置广告组中的广告开始投放的日期。 仅当您希望组中的广告在特定日期开始投放时，才调用此方法;否则，广告将立即开始投放。

参数

名称 类型 说明
endDate string 开始投放广告的日期。 以 YYYYMMDD 格式指定日期。

返回

类型 说明
AdGroupBuilder 应用开始日期的广告组生成器。

withStartDate (对象 startDate)

设置广告组中的广告开始投放的日期。 仅当您希望组中的广告在特定日期开始投放时，才调用此方法;否则，广告将立即开始投放。

参数

名称 类型 说明
endDate Object 开始投放广告的日期。 使用具有以下字段的对象指定日期：
  • year
  • month
  • day

例如：var date = {year: 2018, month: 5, day: 13};

月份为基础，其中 1 为 1 月，12 为 12 月。

返回

类型 说明
AdGroupBuilder 应用开始日期的广告组生成器。

withStatus (字符串状态)

设置广告组的状态。

参数

名称 类型 说明
状态 String 广告组的状态。 下面是可能的区分大小写的值。
  • 已启用
  • 已暂停
  • 已删除
默认值为“暂停”。

返回

类型 说明
AdGroupBuilder 应用状态的广告组生成器。

withTrackingTemplate (字符串 trackingTemplate)

设置广告组的跟踪模板。

跟踪模板与关键字 (keyword) 的 FinalUrl 一起使用，以创建广告使用的目标 URL。 有关详细信息，请参阅我 可以使用哪些跟踪或 URL 参数？

参数

名称 类型 说明
trackingTemplate string 用于广告组的跟踪模板。

返回

类型 说明
AdGroupBuilder 应用了跟踪模板的广告组生成器。

另请参阅

Campaign.newAdGroupBuilder ()

  • Last updated on