包含定義和建立延展型文字廣告的方法。 如需建置器的相關資訊，請參閱 建置器。
注意事項
- 在 2023 年 2 月 1 日之前，將延展型文字廣告升級為回應式搜尋廣告。 在此日期之後，您就無法再建立新項目或編輯現有的延展型文字廣告。 如需詳細資訊，請參閱 關於回應式搜尋廣告。
- 現有的延展型文字廣告會繼續刊登，而且您將可以檢視其成效報告。
- 您仍然可以暫停、啟用或移除延展型文字廣告。 否則，嘗試新增或更新延展型文字廣告
CampaignServiceAdTypeInvalid 會導致錯誤。
-
深入了解此變更。
使用範例：
var operation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
.withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
.withDescription('AD TEXT GOES HERE')
.withFinalUrl('LANDING PAGE URL GOES HERE')
.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`);
}
}
方法
組建
建立廣告並傳回用來檢查指令碼是否成功新增廣告的作業物件。
如需廣告群組中可新增廣告數目的限制，請參閱實體 階層限制。
傳回
withCustomParameters (物件 customParameters)
設定廣告的自訂參數。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數。
引數
| 名稱 |
類型 |
描述 |
| customParameters |
物件 |
最多要套用至廣告最終 URL 的自訂參數對應。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，而值最多可包含 200 個 8 位元組字元。 |
傳回
withDescription (字串描述)
設定廣告的第一個說明。 此方法已被取代，取而代之的是 withDescription1 (字串 description1) 。
引數
| 名稱 |
類型 |
說明 |
| Description |
字串 |
廣告的第一個描述。 如需複製限制和包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withDescription1 (字串 description1)
設定廣告的第一個說明。 這個方法會設定與 withDescription 相同的欄位 (字串描述) 。
引數
| 名稱 |
類型 |
描述 |
| 說明 1 |
字串 |
廣告的第一個描述。 如需複製限制和包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withDescription2 (字串 description2)
設定廣告的第二個說明。
引數
| 名稱 |
類型 |
描述 |
| 說明 2 |
字串 |
廣告的第二個說明。 如需複製限制和包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withFinalUrl (string finalUrl)
設定廣告的登陸頁面 URL。
引數
| 名稱 |
類型 |
描述 |
| finalUrl |
字串 |
廣告的登陸頁面 URL。 如需 URL 限制的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withHeadlinePart1 (字串 headlinePart1)
設定廣告標題的第一部分。
引數
| 名稱 |
類型 |
描述 |
| headlinePart1 |
字串 |
廣告標題的第一部分。 當 Microsoft 使用標題的第 1、2 和 3 部分產生廣告標題時，它會使用 “ - ” 將各個部分串連起來。 請勿在任何標題部分指定破折號。 標題的每一部分都必須包含至少一個單字。 如需其他標題限制和在標題中包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withHeadlinePart2 (字串 headlinePart2)
設定廣告標題的第二部分。
引數
| 名稱 |
類型 |
描述 |
| headlinePart2 |
字串 |
廣告標題的第二部分。 當 Microsoft 使用標題的第 1、2 和 3 部分產生廣告標題時，它會使用 “ - ” 將各個部分串連起來。 請勿在任何標題部分指定破折號。 標題的每一部分都必須包含至少一個單字。 如需其他標題限制和在標題中包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withHeadlinePart3 (字串 headlinePart3)
設定廣告標題的第三部分。
引數
| 名稱 |
類型 |
描述 |
| headlinePart3 |
字串 |
廣告標題的第三部分。 當 Microsoft 使用標題的第 1、2 和 3 部分產生廣告標題時，它會使用 “ - ” 將各個部分串連起來。 請勿在任何標題部分指定破折號。 標題的每一部分都必須包含至少一個單字。 如需其他標題限制和在標題中包含動態文字字串的相關資訊，請參閱 Bing 廣告 API。 |
傳回
withMobileFinalUrl (字串 mobileFinalUrl)
設定適用於行動裝置的廣告最終 URL。
最終 URL 用於識別使用者在點擊廣告時被帶往的網頁。 若要為行動裝置指定最終 URL，請先為非行動裝置指定最終 URL， (請參閱 withFinalUrl()) 。
如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？
引數
| 名稱 |
類型 |
描述 |
| mobileFinalUrl |
字串 |
行動裝置的最終 URL。 |
傳回
withPath1 (字串 urlPath1)
設定要附加到廣告顯示 URL 的第一個選擇性路徑。
引數
| 名稱 |
類型 |
描述 |
| mobileFinalUrl |
字串 |
要附加到廣告顯示 URL 的第一個選擇性路徑。 Microsoft 會使用中 withFinalUrl 指定的網域做為顯示 URL。 如果最終 URL 的網域為 contoso.com 且路徑為 shoes，則廣告的顯示 URL 為 contoso.com/shoes。 如需使用方式和限制，請參閱 Path1。 |
傳回
withPath2 (字串 urlPath2)
設定要附加到廣告顯示 URL 的第二個選擇性路徑。
引數
| 名稱 |
類型 |
描述 |
| mobileFinalUrl |
字串 |
要附加到廣告顯示 URL 的第二個選擇性路徑。 若要指定第二個路徑，請先指定第一個路徑 (請參閱 withPath1) 。 Microsoft 會使用中 withFinalUrl 指定的網域做為顯示 URL。 如果最終 URL 的網域為 contoso.com、第一個路徑為 shoes，第二個路徑為 ladies，則廣告的顯示 URL 為 contoso.com/shoes/ladies。 如需使用方式和限制，請參閱 路徑 2。 |
傳回
withTrackingTemplate (字串 trackingTemplate)
設定廣告的追蹤範本。
追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。 如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？
引數
| 名稱 |
類型 |
描述 |
| trackingTemplate |
字串 |
要與此廣告搭配使用的追蹤範本。 |
傳回