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 (字串描述、字串釘選) ResponsiveSearchAdBuilder 將提供的描述新增至目前的描述清單。 必須使用 this 或 addDescription () 方法指定至少 2 個描述。
addHeadline (字串標題,字串釘選) ResponsiveSearchAdBuilder 將提供的標題新增至目前的標題清單。 必須使用 this 或 addHeadline () 方法指定至少 3 個標題。
組建 AdOperation 建立廣告並傳回用來檢查指令碼是否成功新增廣告的作業物件。
withCustomParameters (物件 customParameters) ResponsiveSearchAdBuilder 設定廣告的自訂參數。
withDescriptions (object[] 描述) ResponsiveSearchAdBuilder 設定廣告的描述。
withFinalUrl (字串 finalUrl) ResponsiveSearchAdBuilder 設定廣告的登陸頁面 URL。
withFinalUrlSuffix (string finalUrlSuffix) ResponsiveSearchAdBuilder 設定廣告的最終 URL 尾碼。
withHeadlines (object[] 標題) ResponsiveSearchAdBuilder 設定廣告標題。
withMobileFinalUrl (字串 mobileFinalUrl) ResponsiveSearchAdBuilder 設定適用於行動裝置的廣告最終 URL。
withPath1 (字串 urlPath1) ResponsiveSearchAdBuilder 設定要附加到廣告顯示 URL 的第一個選擇性路徑。
withPath2 (字串 urlPath2) ResponsiveSearchAdBuilder 設定要附加到廣告顯示 URL 的第二個選擇性路徑。
withTrackingTemplate (字串 trackingTemplate) ResponsiveSearchAdBuilder 設定廣告的追蹤範本。

addDescription (字串描述、字串釘選)

將提供的描述新增至目前的描述清單。 必須使用 this 或 addDescription () 方法指定至少 2 個描述。

引數

名稱 類型 說明
Description 字串 要新增的廣告說明。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。
釘選 字串 選擇性的釘選位置。

描述的可能值為:DESCRIPTION_1、DESCRIPTION_2
文字 字串 此資產的文字。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用說明的廣告建立器。

addHeadline (字串標題,字串釘選)

將提供的標題新增至目前的標題清單。 必須使用 this 或 addHeadline () 方法指定至少 3 個標題。

引數

名稱 類型 描述
標題 字串 要新增的廣告標題。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。
釘選 字串 選擇性的釘選位置。

標題可能的值為:HEADLINE_1、HEADLINE_2、HEADLINE_3

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用標題的廣告建立器。

組建

建立廣告並傳回用來檢查指令碼是否成功新增廣告的作業物件。

如需廣告群組中可新增廣告數目的限制,請參閱實體 階層限制。

傳回

類型 描述
AdOperation 用來檢查指令碼是否成功新增廣告的作業物件。

withCustomParameters (物件 customParameters)

設定廣告的自訂參數。

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

引數

名稱 類型 描述
customParameters 物件 最多要套用至廣告最終 URL 的自訂參數對應。 例如, {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自訂參數的名稱,而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元,而值最多可包含 200 個 8 位元組字元。

傳回

類型 描述
ResponsiveSearchAdBuilder 套用自訂參數的廣告建立器。

withDescriptions (object[] 描述)

設定廣告的描述。

引數

名稱 類型 描述
說明 AdTextAsset[] 廣告的描述。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用描述的廣告建立器。

withFinalUrl (string finalUrl)

設定廣告的登陸頁面 URL。

引數

名稱 類型 描述
finalUrl 字串 廣告的登陸頁面 URL。 如需 URL 限制的相關資訊,請參閱 Bing 廣告 API。

傳回

類型 描述
ResponsiveSearchAdBuilder 套用最終 URL 的廣告建立器。

withFinalUrlSuffix (字串 finalUrlSuffix)

設定廣告的最終 URL 尾碼。

引數

名稱 類型 描述
finalUrl 字串 廣告的最終 URL 尾碼。 如需 URL 限制的相關資訊,請參閱 Bing 廣告 API。

傳回

類型 描述
ResponsiveSearchAdBuilder 套用最終 URL 的廣告建立器。

withHeadlines (object[] 標題

設定廣告標題。

引數

名稱 類型 描述
標題 AdTextAsset[] 廣告的標題。 如需限制和包含動態文字字串的相關資訊,請參閱 Bing 廣告 API。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用廣告標題的廣告建立器。

withMobileFinalUrl (字串 mobileFinalUrl)

設定適用於行動裝置的廣告最終 URL。

最終 URL 用於識別使用者在點擊廣告時被帶往的網頁。 若要為行動裝置指定最終 URL,請先為非行動裝置指定最終 URL, (請參閱 withFinalUrl()) 。

如需詳細資訊,請參閱 我可以使用哪些追蹤參數或 URL 參數?

引數

名稱 類型 描述
mobileFinalUrl 字串 行動裝置的最終 URL。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用行動裝置最終 URL 的廣告建立器。

withPath1 (字串 urlPath1)

設定要附加到廣告顯示 URL 的第一個選擇性路徑。

引數

名稱 類型 描述
mobileFinalUrl 字串 要附加到廣告顯示 URL 的第一個選擇性路徑。 Microsoft 會使用中 withFinalUrl 指定的網域做為顯示 URL。 如果最終 URL 的網域為 contoso.com 且路徑為 shoes,則廣告的顯示 URL 為 contoso.com/shoes。 如需使用方式和限制,請參閱 Path1。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用路徑的廣告建立器。

withPath2 (字串 urlPath2)

設定要附加到廣告顯示 URL 的第二個選擇性路徑。

引數

名稱 類型 描述
mobileFinalUrl 字串 要附加到廣告顯示 URL 的第二個選擇性路徑。 若要指定第二個路徑,請先指定第一個路徑 (請參閱 withPath1) 。 Microsoft 會使用中 withFinalUrl 指定的網域做為顯示 URL。 如果最終 URL 的網域為 contoso.com、第一個路徑為 shoes,第二個路徑為 ladies,則廣告的顯示 URL 為 contoso.com/shoes/ladies。 如需使用方式和限制,請參閱 路徑 2。

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用路徑的廣告建立器。

withTrackingTemplate (字串 trackingTemplate)

設定廣告的追蹤範本。

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

引數

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

傳回

類型 描述
ResponsiveSearchAdBuilder 已套用追蹤範本的廣告建立器。