KeywordBuilder

包含定義和建立關鍵字的方法。 如需建置器的相關資訊，請參閱 建置器。

注意事項

搜尋廣告的所有廣泛比對修飾詞關鍵字現在都做為廣泛比對關鍵字，而不是片語比對。 深入了解關鍵字比對類型。

使用範例：

    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`);
        }
    }

方法

方法名稱 傳回類型 描述
組建 KeywordOperation 建立關鍵字，並傳回用來檢查關鍵字是否已成功新增的作業物件。
withCpc (雙倍每次點選成本) KeywordBuilder 設定關鍵字的最高每次點選成本出價。
withCustomParameters (物件 customParameters) KeywordBuilder 設定關鍵字的自訂參數。
withFinalUrl (字串 finalUrl) KeywordBuilder 設定關鍵字的最終 URL。
withMobileFinalUrl (字串 mobileFinalUrl) KeywordBuilder 針對行動裝置設定關鍵字的最終 URL。
withText (字串文字) KeywordBuilder 設定關鍵字的文字。
withTrackingTemplate (字串 trackingTemplate) KeywordBuilder 設定關鍵字的追蹤範本。

組建

建立關鍵字，並傳回用來檢查關鍵字是否已成功新增的作業物件。

傳回

類型 描述
KeywordOperation 用來檢查關鍵字是否已成功新增的作業物件。

withCpc (雙倍每次點選成本)

設定關鍵字的最高每次點選成本出價。

指定當關鍵字符合使用者的搜尋字詞時要使用的出價金額。 僅當廣告群組的出價策略設定為MANUAL_CPC時才適用。

若要使用廣告群組層級指定的出價金額，請勿呼叫這個方法。

如需出價金額的詳細資訊，請參閱 BID 和 BiddingScheme。

引數

名稱 類型 描述
每次點選成本 double 要套用至關鍵字的最高每次點選成本出價。 最低和最高出價值會由帳戶貨幣決定。 如需詳細資訊，請參閱 出價和預算貨幣。

傳回

類型 描述
KeywordBuilder 套用了每次點選成本出價的關鍵字建立器。

withCustomParameters (物件 customParameters)

設定關鍵字的自訂參數。

自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數。

引數

名稱 類型 描述
customParameters 物件 最多要套用至關鍵字最終 URL 的自訂參數對應。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，而值最多可包含 200 個 8 位元組字元。

傳回

類型 描述
KeywordBuilder 已套用自訂參數的關鍵字建立器。

withFinalUrl (string finalUrl)

設定關鍵字的最終 URL。

最終 URL 用於識別使用者在點擊廣告時被帶往的網頁。 如果未指定，實體會繼承其上層實體的最終 URL。 例如，關鍵字實體會繼承廣告的最終 URL。 指定要覆寫廣告的最終 URL 的關鍵字最終 URL。

如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？

引數

名稱 類型 描述
finalUrl 字串 當使用者點擊廣告時，用於識別使用者進入的網頁的最終 URL。

傳回

類型 描述
KeywordBuilder 已套用最終 URL 的關鍵字建立器。

withMobileFinalUrl (字串 mobileFinalUrl)

針對行動裝置設定關鍵字的最終 URL。

最終 URL 用於識別使用者在點擊廣告時被帶往的網頁。 如果未指定，實體會繼承其上層實體的最終 URL。 例如，關鍵字實體會繼承廣告的最終 URL。 如果您想要覆寫廣告的最終 URL，請指定關鍵字的最終 URL。

如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？

若要為行動裝置指定最終 URL，請先為非行動裝置指定最終 URL， (請參閱 withFinalUrl()) 。

引數

名稱 類型 描述
mobileFinalUrl 字串 行動裝置的最終 URL。

傳回

類型 描述
KeywordBuilder 已套用行動裝置最終 URL 的關鍵字建立器。

withText (字串文字)

設定關鍵字的文字。

若要指定關鍵字的比對類型，請使用下列語法：

  • 針對廣泛比對，請使用無比對類型語法 (例如 keywordBuilder.withText("books")) 。
  • 若使用廣泛比對修飾詞，請在文字前面加上加號 (+) (，例如 keywordBuilder.withText("+books")) 。 請注意，如果您嘗試 (BMM) 關鍵字建立新的廣泛比對修飾詞，它們將會儲存並做為符合關鍵字的片語。 您現有的 BMM 關鍵字會繼續在片語比對行為底下使用。 深入了解關鍵字比對類型。
  • 針對片語比對，請在文字 (周圍加上引號，例如 keywordBuilder.withText("\"books\"")) 。
  • 若要達到完全比對，請在文字 (周圍加上方括號，例如 keywordBuilder.withText("[hardcover books]")) 。

引數

名稱 類型 描述
文字 字串 關鍵字的文字。 關鍵字的文字為必要資訊。 文字最多可以包含 100 個字元。 在廣告群組的語言值所在的地區設定中指定文字。

傳回

類型 描述
KeywordBuilder 已套用關鍵字文字的關鍵字建立器。

withTrackingTemplate (字串 trackingTemplate)

設定關鍵字的追蹤範本。

追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。 如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？

引數

名稱 類型 描述
trackingTemplate 字串 要與此關鍵字搭配使用的追蹤範本。

傳回

類型 描述
KeywordBuilder 已套用追蹤範本的關鍵字建立器。
  • Last updated on