AdGroupBuilder

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

用法示例：

    // 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

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

返回

withBiddingStrategy (string biddingStrategy)

设置广告组的出价策略。

参数

返回

withCpc (double cpc)

设置广告组的 CPC 出价。

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

参数

返回

withCpm (double cpm)

设置广告组的 CPM 出价。

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

参数

返回

withCpv (double cpv)

设置广告组的 CPV 出价。

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

参数

返回

withCustomParameters (Object customParameters)

设置广告组的自定义参数，以用于最终 URL 或跟踪模板。

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

参数

返回

withEndDate (string endDate)

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

参数

返回

withEndDate (对象 endDate)

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

参数

返回

withLanguage (字符串语言)

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

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

参数

返回

withName (字符串名称)

设置广告组的名称。

参数

返回

withStartDate (string startDate)

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

参数

返回

withStartDate (对象 startDate)

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

参数

返回

withStatus (字符串状态)

设置广告组的状态。

参数

返回

withTrackingTemplate (string trackingTemplate)

设置广告组的跟踪模板。

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

参数

返回

另请参阅

Campaign.newAdGroupBuilder ()