KeywordUrls

包含用來管理關鍵字 URL、追蹤範本和自訂參數的方法。如需詳細資訊，請參閱使用升級的 URL 進行 URL 追蹤。

方法

方法名稱	傳回類型	描述
clearFinalUrl	void	移除關鍵字的最終 URL。
clearMobileFinalUrl	void	移除行動裝置關鍵字的最終 URL。
clearTrackingTemplate	void	移除關鍵字的追蹤範本。
getCustomParameters	物件	取得關鍵字的自訂參數。
getFinalUrl	字串	取得關鍵字的最終 URL。
getMobileFinalUrl	字串	取得關鍵字在行動裝置上的最終 URL。
getTrackingTemplate	字串	取得關鍵字的追蹤範本。
setCustomParameters (物件 customParameters)	void	設定關鍵字的自訂參數。
setFinalUrl (字串 finalUrl)	void	設定關鍵字的最終 URL。
setMobileFinalUrl (字串 finalUrl)	void	針對行動裝置設定關鍵字的最終 URL。
setTrackingTemplate (字串 trackingTemplate)	void	設定關鍵字的追蹤範本。

clearFinalUrl

移除關鍵字的最終 URL。

傳回

類型	描述
void	會傳回 nothing。

clearMobileFinalUrl

移除行動裝置關鍵字的最終 URL。

傳回

類型	描述
void	會傳回 nothing。

clearTrackingTemplate

移除關鍵字的追蹤範本。

傳回

類型	描述
void	會傳回 nothing。

getCustomParameters

取得關鍵字的自訂參數。

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

傳回

類型	描述
物件	關鍵字自訂參數的對應。例如， `{key1: 'value1', key2: 'value2', key3: 'value3'}`其中 key 是自訂參數的名稱，而 value 是參數的值。

getFinalUrl

取得關鍵字的最終 URL。這是使用者點擊廣告時進入的網頁 URL。

覆寫規則與其他地方一樣適用。例如，指定關鍵字的最終 URL 會覆寫廣告的最終 URL。

傳回

類型	描述
字串	關鍵字的最終 URL。

getMobileFinalUrl

取得關鍵字在行動裝置上的最終 URL。這是使用者在點選廣告時進入的行動裝置網頁 URL。

覆寫規則與其他地方一樣適用。例如，指定關鍵字的行動裝置最終 URL 會覆寫廣告的行動裝置最終 URL。

傳回

類型	描述
字串	關鍵字在行動裝置上的最終 URL。

getTrackingTemplate

取得關鍵字的追蹤範本。

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

傳回

類型	描述
字串	關鍵字的追蹤範本。

setCustomParameters (物件 customParameters)

設定關鍵字的自訂參數。如果最終 URL 或追蹤範本包含自訂替代字串，請使用此方法。

若要在最終 URL 或追蹤範本中使用客戶參數名稱，請以大括號括住名稱，並在名稱前加上底線 (_) 。例如，如果參數名稱為 foo，請在追蹤範本或最終 URL 中使用 {_foo}。定義自訂參數物件時，請勿在參數名稱中加上前置底線。

呼叫這個方法會取代關鍵字現有的自訂參數。

若要清除關鍵字中的自訂參數，請傳遞空白物件 (例如 setCustomParameters({})) 。如果您清除關鍵字的自訂參數，則關鍵字會從上層廣告群組繼承網址， (如果廣告群組指定網址) 。若要完全清除自訂參數，請在階層中的所有層級中清除它們。

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

引數

名稱	類型	描述
customParameters	物件	最多要在關鍵字中使用的三個自訂參數的對應。例如， `{key1: 'value1', key2: 'value2', key3: 'value3'}`其中 key 是自訂參數的名稱，而 value 是參數的值。參數名稱只能包含英數字元，且參數值不能包含空白字元。名稱最多可包含 16 個 8 位元組字元，而值最多可包含 200 個 8 位元組字元。

傳回

類型	描述
void	會傳回 nothing。

setFinalUrl (字串 finalUrl)

設定關鍵字的最終 URL。

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

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

如果屬性值無效，則呼叫會無訊息方式失敗。若要確認屬性是否真的已更新，請再次取得物件，然後測試屬性的值是否等於新值。如需相關資訊，請參閱處理錯誤和警告。

引數

名稱	類型	描述
finalUrl	字串	關鍵字的最終 URL。

傳回

類型	描述
void	會傳回 nothing。

setMobileFinalUrl (字串 finalUrl)

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

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

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

引數

名稱	類型	描述
finalUrl	字串	關鍵字的最終 URL：行動裝置。

傳回

類型	描述
void	會傳回 nothing。

setTrackingTemplate (字串 trackingTemplate)

設定關鍵字的追蹤範本。