包含定義和建立回應式搜尋廣告的方法。 如需建置器的相關資訊,請參閱 建置器。
使用範例:
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 (字串描述、字串釘選)
將提供的描述新增至目前的描述清單。 必須使用 this 或 addDescription () 方法指定至少 2 個描述。
引數
| 名稱 |
類型 |
說明 |
| Description |
字串 |
要新增的廣告說明。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。 |
| 釘選 |
字串 |
選擇性的釘選位置。
描述的可能值為:DESCRIPTION_1、DESCRIPTION_2 |
| 文字 |
字串 |
此資產的文字。 |
傳回
addHeadline (字串標題,字串釘選)
將提供的標題新增至目前的標題清單。 必須使用 this 或 addHeadline () 方法指定至少 3 個標題。
引數
| 名稱 |
類型 |
描述 |
| 標題 |
字串 |
要新增的廣告標題。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。 |
| 釘選 |
字串 |
選擇性的釘選位置。
標題可能的值為:HEADLINE_1、HEADLINE_2、HEADLINE_3 |
傳回
組建
建立廣告並傳回用來檢查指令碼是否成功新增廣告的作業物件。
如需廣告群組中可新增廣告數目的限制,請參閱實體 階層限制。
傳回
withCustomParameters (物件 customParameters)
設定廣告的自訂參數。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊,請參閱 自訂參數。
引數
| 名稱 |
類型 |
描述 |
| customParameters |
物件 |
最多要套用至廣告最終 URL 的自訂參數對應。 例如, {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自訂參數的名稱,而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元,而值最多可包含 200 個 8 位元組字元。 |
傳回
withDescriptions (object[] 描述)
設定廣告的描述。
引數
傳回
withFinalUrl (string 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 且路徑為 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 |
字串 |
要與此廣告搭配使用的追蹤範本。 |
傳回