KeywordBuilder

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

注意

搜索广告的所有广泛匹配修饰符关键字现在都用作广泛匹配关键字，而不是词组匹配。 详细了解关键字 (keyword) 匹配类型。

示例用法：

    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 KeywordOperation 创建关键字 (keyword) 并返回用于检查关键字 (keyword) 是否已成功添加的操作对象。
withCpc (双 cpc) KeywordBuilder 设置关键字 (keyword) 的最高 CPC 出价。
withCustomParameters (对象 customParameters) KeywordBuilder 设置关键字 (keyword) 的自定义参数。
withFinalUrl (字符串 finalUrl) KeywordBuilder 设置关键字 (keyword) 的最终 URL。
withMobileFinalUrl (字符串 mobileFinalUrl) KeywordBuilder 设置移动设备关键字 (keyword) 的最终 URL。
withText (字符串文本) KeywordBuilder 设置关键字 (keyword) 的文本。
withTrackingTemplate (字符串 trackingTemplate) KeywordBuilder 设置关键字 (keyword) 的跟踪模板。

build

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

返回

类型 说明
KeywordOperation 用于检查是否已成功添加关键字 (keyword) 的操作对象。

withCpc (双 cpc)

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

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

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

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

参数

名称 类型 说明
cpc double 要应用于关键字 (keyword) 的最高 CPC 出价。 账户的币种决定了最低和最高出价。 有关详细信息，请参阅 出价和预算货币。

返回

类型 说明
KeywordBuilder 应用了 CPC 出价的关键字生成器。

withCustomParameters (对象 customParameters)

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

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

参数

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

返回

类型 说明
KeywordBuilder 应用了自定义参数的关键字生成器。

withFinalUrl (string finalUrl)

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

最终 URL 标识用户点击广告时转到的网页。 如果未指定，实体将从其父实体继承最终 URL。 例如，关键字 (keyword) 实体继承广告的最终 URL。 指定关键字 (keyword) 的最终 URL 以覆盖广告的最终 URL。

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

参数

名称 类型 说明
finalUrl string 最终 URL，用于标识用户点击广告时转到的网页。

返回

类型 说明
KeywordBuilder 应用了最终 URL 的关键字生成器。

withMobileFinalUrl (字符串 mobileFinalUrl)

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

最终 URL 标识用户点击广告时转到的网页。 如果未指定，实体将从其父实体继承最终 URL。 例如，关键字 (keyword) 实体继承广告的最终 URL。 如果想要覆盖广告的最终 URL，请指定关键字 (keyword) 的最终 URL。

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

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

参数

名称 类型 说明
mobileFinalUrl string 移动设备的最终 URL。

返回

类型 说明
KeywordBuilder 应用了移动最终 URL 的关键字生成器。

withText (字符串文本)

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

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

  • 对于广泛匹配，请使用无匹配类型语法 (例如 keywordBuilder.withText("books")) 。
  • 对于广泛匹配修饰符，请在文本前面加上加号 (+) (，例如， keywordBuilder.withText("+books")) 。 注意：如果您尝试 (BMM) 关键字创建新的广泛匹配修饰符，这些关键字将被保存并作为词组匹配关键字提供。 现有的 BMM 关键字将继续在词组匹配行为下投放。 详细了解关键字 (keyword) 匹配类型。
  • 对于短语匹配，请在文本 (周围加引号，例如 keywordBuilder.withText("\"books\"")) 。
  • 为了实现精确匹配，请在文本 (（例如) ） keywordBuilder.withText("[hardcover books]") 周围括起方括号。

参数

名称 类型 说明
text string 关键字 (keyword) 的文本。 关键字 (keyword) 的文本是必需的。 文本最多可包含 100 个字符。 在广告组的语言值所在的区域设置中指定文本。

返回

类型 说明
KeywordBuilder 应用了关键字 (keyword) 文本的关键字生成器。

withTrackingTemplate (字符串 trackingTemplate)

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

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

参数

名称 类型 说明
trackingTemplate string 要与此关键字 (keyword) 一起使用的跟踪模板。

返回

类型 说明
KeywordBuilder 应用了跟踪模板的关键字生成器。
  • Last updated on