ExpandedTextAdBuilder
本文內容
包含定義和建立展開文字廣告的方法。 如需產生器的相關資訊，請參閱 建立器 。
注意事項
在 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 (Object customParameters)
設定廣告的自訂參數。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數 。
引數
名稱
類型
說明
customParameters
物件
最多可套用至廣告最終 URL 之自訂參數的對應。 例如，其中 {key1: 'value1', key2: 'value2', key3: 'value3'} 索引鍵是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，且值最多可包含 200 個 8 位元組字元。
傳回
withDescription (字串描述)
設定廣告的第一個描述。 這個方法已被取代，而改 用 withDescription1 (字串 description1) 。
引數
名稱
類型
說明
Description
字串
廣告的第一個描述。 如需複製限制及包含動態文字字串的相關資訊，請參閱 Bing 廣告 API 。
傳回
withDescription1 (字串 description1)
設定廣告的第一個描述。 這個方法會) 設定 與 withDescription (字串描述 相同的欄位。
引數
名稱
類型
說明
description1
字串
廣告的第一個描述。 如需複製限制及包含動態文字字串的相關資訊，請參閱 Bing 廣告 API 。
傳回
withDescription2 (字串 description2)
設定廣告的第二個描述。
引數
名稱
類型
說明
description2
字串
廣告的第二個描述。 如需複製限制及包含動態文字字串的相關資訊，請參閱 Bing 廣告 API 。
傳回
withFinalUrl (字串 finalUrl)
設定廣告的登陸頁面 URL。
引數
名稱
類型
說明
finalUrl
字串
廣告的登陸頁面 URL。 如需 URL 限制的相關資訊，請參閱 Bing 廣告 API 。
傳回
withHeadlinePart1 (字串標題Part1)
設定廣告標題的第一個部分。
引數
名稱
類型
說明
標題第 1 部分
字串
廣告標題的第一個部分。 當 Microsoft 使用標題的第 1、2 和 3 部分產生廣告標題時，會使用 「 - 」 串連元件。 請勿在任何標題部分中指定虛線。 標題的每個部分至少必須包含一個字。 如需其他標題限制以及在標題中包含動態文字字串的相關資訊，請參閱 Bing 廣告 API 。
傳回
withHeadlinePart2 (字串標題Part2)
設定廣告標題的第二個部分。
引數
名稱
類型
說明
標題第 2 部分
字串
廣告標題的第二個部分。 當 Microsoft 使用標題的第 1、2 和 3 部分產生廣告標題時，會使用 「 - 」 串連元件。 請勿在任何標題部分中指定虛線。 標題的每個部分至少必須包含一個字。 如需其他標題限制以及在標題中包含動態文字字串的相關資訊，請參閱 Bing 廣告 API 。
傳回
withHeadlinePart3 (字串標題Part3)
設定廣告標題的第三個部分。
引數
名稱
類型
說明
標題第 3 部分
字串
廣告標題的第三個部分。 當 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 ，且路徑是 鞋子 ，則會 contoso.com/shoes 廣告的顯示 URL。 如需使用量和限制，請參閱 Path1 。
傳回
withPath2 (字串 urlPath2)
設定要附加至廣告顯示 URL 的第二個選擇性路徑。
引數
名稱
類型
說明
mobileFinalUrl
字串
要附加至廣告顯示 URL 的第二個選擇性路徑。 若要指定第二個路徑，請先指定第一個路徑 (請參閱 withPath1) 。 Microsoft 會使用 中 withFinalUrl 指定的網域作為顯示 URL。 如果最後一個 URL 的網域 是 contoso.com ，則第一個路徑是 鞋子 ，而第二個路徑是 小便 ，則會 contoso.com/shoes/ladies 廣告的顯示 URL。 如需使用量和限制，請參閱 Path2 。
傳回
withTrackingTemplate (字串追蹤範本)
設定廣告的追蹤範本。
追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。 如需詳細資訊，請 參閱我可以使用哪些追蹤或 URL 參數？
引數
名稱
類型
說明
trackingTemplate
字串
要與此廣告搭配使用的追蹤範本。
傳回