KeywordBuilder

包含用于定义和创建关键字 (keyword) 的方法。 有关生成器的信息，请参阅 Builders。

用法示例：

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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

创建关键字 (keyword) 并返回一个操作对象，用于检查是否已成功添加关键字 (keyword) 。

返回

withCpc (double cpc)

设置关键字 (keyword) 的最大 CPC 出价。

指定关键字 (keyword) 与用户的搜索词匹配时使用的出价金额。 仅当广告组的出价策略设置为MANUAL_CPC时才适用。

若要使用在广告组级别指定的出价金额，请不要调用此方法。

有关出价金额的详细信息，请参阅 Bid and BidScheme。

参数

返回

withCustomParameters (Object customParameters)

设置关键字 (keyword) 的自定义参数。

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

参数

返回

withFinalUrl (string finalUrl)

设置关键字 (keyword) 的最终 URL。

最后一个 URL 标识用户在单击广告时将访问的网页。 如果未指定，实体将从其父实体继承最终 URL。 例如，关键字 (keyword) 实体继承广告的最终 URL。 指定关键字 (keyword) 的最终 URL 以覆盖广告的最终 URL。

有关详细信息，请参阅 我可以使用哪些跟踪或 URL 参数？

参数

返回

withMobileFinalUrl (字符串 mobileFinalUrl)

设置移动设备关键字 (keyword) 的最终 URL。

最后一个 URL 标识用户在单击广告时将访问的网页。 如果未指定，实体将从其父实体继承最终 URL。 例如，关键字 (keyword) 实体继承广告的最终 URL。 如果要覆盖广告的最终 URL，请指定关键字 (keyword) 的最终 URL。

有关详细信息，请参阅 我可以使用哪些跟踪或 URL 参数？

若要为移动设备指定最终 URL，请先为非移动设备指定最终 URL， (请参阅 withFinalUrl()) 。

参数

返回

withText (字符串文本)

设置关键字 (keyword) 的文本。

若要指定关键字 (keyword) 的匹配类型，请使用以下语法：

• 对于广泛匹配，请使用无匹配类型语法 (例如 keywordBuilder.withText("books")) 。
• 对于广泛匹配修饰符，请在文本前面附加加号 (+) (， keywordBuilder.withText("+books") 例如) 。 注意：如果尝试 (BMM) 关键字创建新的广泛匹配修饰符，它们将保存并用作短语匹配关键字。 现有的 BMM 关键字将继续在短语匹配行为下提供。 详细了解关键字 (keyword) 匹配类型。
• 对于短语匹配，请在文本 (周围放置引号， keywordBuilder.withText("\"books\"") 例如，) 。
• 若要完全匹配，请在文本 (周围放置方括号， keywordBuilder.withText("[hardcover books]") 例如，) 。

参数

返回

withTrackingTemplate (string trackingTemplate)

设置关键字 (keyword) 的跟踪模板。

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

参数

返回