ResponsiveSearchAdBuilder
本文內容
包含定義和建立回應式搜尋廣告的方法。 如需產生器的相關資訊，請參閱 建立器 。
範例使用方式：
var operation = adGroup.newAd().responsiveSearchAdBuilder()
.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`);
}
}
方法
addDescription (字串描述，字串釘選)
將提供的描述新增至目前的描述清單。 至少必須使用這個 或 addDescription () 方法指定 2 個描述。
引數
名稱
類型
說明
Description
字串
要新增的廣告描述。 如需限制和包含動態文字字串的資訊，請參閱 Bing 廣告 API 。
寄託
字串
選擇性釘選的位置。
文字
字串
此資產的文字。
傳回
addHeadline (字串標題，字串釘選)
將提供的標題新增至目前的標題清單。 至少必須使用這個 或 addHeadline () 方法指定 3 個標題。
引數
名稱
類型
說明
標題
字串
要新增的廣告標題。 如需限制和包含動態文字字串的資訊，請參閱 Bing 廣告 API 。
寄託
字串
選擇性釘選的位置。
傳回
建立
建立廣告，並傳回用來檢查腳本是否成功新增廣告的工作物件。
如需您可以新增至廣告群組的廣告數目限制，請參閱 實體階層限制 。
傳回
withCustomParameters (Object customParameters)
設定廣告的自訂參數。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數 。
引數
名稱
類型
說明
customParameters
物件
最多可套用至廣告最終 URL 之自訂參數的對應。 例如，其中 {key1: 'value1', key2: 'value2', key3: 'value3'} 索引鍵是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，且值最多可包含 200 個 8 位元組字元。
傳回
withDescriptions (object[] descriptions)
設定廣告的描述。
引數
傳回
withFinalUrl (字串 finalUrl)
設定廣告的登陸頁面 URL。
引數
名稱
類型
說明
finalUrl
字串
廣告的登陸頁面 URL。 如需 URL 限制的相關資訊，請參閱 Bing 廣告 API 。
傳回
withFinalUrlSuffix (字串 finalUrlSuffix)
設定廣告的最終 URL 尾碼。
引數
名稱
類型
說明
finalUrl
字串
廣告的最後一個 URL 尾碼。 如需 URL 限制的相關資訊，請參閱 Bing 廣告 API 。
傳回
withHeadlines (object[] 標題
設定廣告的標題。
引數
傳回
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
字串
要與此廣告搭配使用的追蹤範本。
傳回