KeywordBuilder

發行項
11/13/2024

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

注意事項

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

範例使用方式：

    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 (double 並)	KeywordBuilder	設定關鍵字的最大一次的檢定。
withCustomParameters (Object customParameters)	KeywordBuilder	設定關鍵字的自訂參數。
withFinalUrl (字串 finalUrl)	KeywordBuilder	設定關鍵字的最終 URL。
withMobileFinalUrl (字串 mobileFinalUrl)	KeywordBuilder	設定行動裝置的關鍵字最終 URL。
withText (字串文字)	KeywordBuilder	設定關鍵字的文字。
withTrackingTemplate (字串 trackingTemplate)	KeywordBuilder	設定關鍵字的追蹤範本。

建立

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

傳回

類型	說明
KeywordOperation	用來檢查關鍵字是否已成功加入的工作物件。

withCpc (double 並)

設定關鍵字的最大一次的檢定。

指定關鍵字符合使用者的搜尋字詞時所要使用的約定金額。只有在廣告群組的廣告策略設定為 [MANUAL_CPC時才適用。

若要使用廣告群組層級指定的約定金額，請勿呼叫此方法。

如需有關約價金額的詳細資訊，請參閱 Bid 和相關架構。

引數

名稱	類型	說明
中國共產黨	double	要套用至關鍵字的最大一個要執行的一次。帳戶的貨幣會決定最小值和最大報價值。如需詳細資訊，請參閱 Bid 和 budget 貨幣。

傳回

類型	說明
KeywordBuilder	套用了一個已套用了一個已套用了一個與之一起使用之許可權的關鍵字產生器。

withCustomParameters (Object customParameters)

設定關鍵字的自訂參數。

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

引數

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

傳回

類型	說明
KeywordBuilder	已套用自訂參數的關鍵字產生器。

withFinalUrl (字串 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 (字串追蹤範本)

設定關鍵字的追蹤範本。

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

引數

名稱	類型	說明
trackingTemplate	字串	要與這個關鍵字搭配使用的追蹤範本。

傳回

類型	說明
KeywordBuilder	已套用追蹤範本的關鍵字產生器。

共用方式為