AdGroupUrls

包含管理廣告群組網址的方法。 如需詳細資訊，請參閱 使用升級的 URL 進行 URL 追蹤。

方法

方法名稱	傳回類型	描述
clearTrackingTemplate	void	從這個廣告群組移除追蹤範本。
getCustomParameters	物件	取得廣告群組的自訂參數。
getTrackingTemplate	字串	取得廣告群組的追蹤範本。
setCustomParameters (物件 customParameters)	void	設定廣告群組的自訂參數。
setTrackingTemplate (字串 trackingTemplate)	void	設定廣告群組的追蹤範本。

clearTrackingTemplate

從這個廣告群組移除追蹤範本。 如需追蹤範本的相關資訊，請參閱 追蹤範本。

傳回

類型	描述
void	會傳回 nothing。

getCustomParameters

取得廣告群組的自訂參數。

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

傳回

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

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。

setTrackingTemplate (字串 trackingTemplate)

設定要與此廣告群組搭配使用的追蹤範本。

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

引數

名稱	類型	描述
trackingTemplate	字串	要與此廣告群組搭配使用的追蹤範本。

傳回

類型	描述
void	會傳回 nothing。