共用方式為

ResponsiveSearchAd 資料物件 - 行銷活動管理

  • 發行項

搜尋網路中文字廣告的回應式廣告格式。

注意事項

相同廣告群組中允許重複的回應式搜尋廣告。

回應式搜尋廣告可讓您在 3-15 個唯一廣告標題之間設定， (名稱「標題」) 和單一廣告內的 2-4 個廣告描述。 從該處，Bing 會為每個指定的查詢和對應的搜尋使用者選取最相關的標題和描述組合。 藉由允許Bing AI為每個查詢選取最相關的標題和描述，我們確保正確的訊息會在正確的時間到達您每個潛在客戶的所有可能意圖訊號。

向使用者顯示的回應式廣告看起來與展開的文字廣告相同，也就是透過展開的文字廣告) 最多 3 個標題 (標題元件，以及透過展開的文字廣告) (文字元件的 2 個描述。 為了將所有廣告格式的曝光率最大化，描述不一定會顯示在您的廣告中。

當您建立回應式搜尋廣告時， [描述 ] 和 [ 標題 ] 清單會儲存為文字資產，可供帳戶內任何回應式搜尋廣告共用。 例如，如果「無縫整合」是文字資產，您會發現它在連結至相同 Microsoft Advertising 帳戶中「無縫整合」的所有廣告上都有相同的資產識別碼。 資產識別碼不包含在 AddAds 或 UpdateAds 回應中 。 使用行銷活動管理服務，取得資產識別碼的唯一方法是擷取您建立的廣告。 您可以透過 GetAdsByAdGroupId在後續的服務通話中擷取廣告，以取得描述和標題的資產識別碼。 使用大量服務時，資產識別碼會包含在大量上傳結果檔中。

注意事項

回應式搜尋廣告只能在 AdGroupType 設定為 「SearchStandard」 的搜尋活動中建立。 如果 AdGroupType 設定為 「SearchDynamic」，則廣告群組不支援回應式搜尋廣告。

語法

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ResponsiveSearchAd物件具有下列元素：Descriptions、Domain、標題、Path1、Path2。

元素 說明 資料類型
描述 Bing 可用來優化廣告版面配置的描述清單。

為了將所有廣告格式的曝光率最大化，描述不一定會顯示在您的廣告中。

除非您將其中一個描述 釘選 到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。

從資料模型的觀點來看，還原連結和標題會分別儲存為文字資產，也就是每個AssetLink一個TextAsset。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產識別碼。

您必須設定 2-4 個描述。 每個描述的 文字 至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵字建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數自動自訂您的廣告。

每個描述的 文字 輸入長度上限為 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，取代之後不允許超過 90 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 90 個字元，則會使用 預設 文字。 對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 45 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

Text不能包含分行符號 (\n) 字元。

文字可以包含 IF 函式。

添加： 必填
更新： 選。 若要保留所有現有的資產連結，請將此專案設定或保留為 nil。 如果您設定此元素，則會取代先前連結至此廣告的任何描述。		 AssetLink 數 組
網域 將顯示的 URL，而不是最後一個 URL。 最終 URL 仍會用於登陸頁面 URL。

保留給有限的試驗使用量，例如，藥物客戶。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string
標題 Bing 可用來優化廣告版面配置的廣告標題清單。

除非您將其中一個標題 釘選 到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。

從資料模型的觀點來看，還原連結和標題會分別儲存為文字資產，也就是每個AssetLink一個TextAsset。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產識別碼。

您必須設定 3-15 個標題。 每個標題的 文字 至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵字建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數自動自訂您的廣告。

每個標題的 文字 輸入長度上限為 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，取代之後不允許超過 30 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 30 個字元，則會使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 15 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 15 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

Text不能包含分行符號 (\n) 字元。

文字可以包含 IF 函式。

添加： 必填
更新： 選。 若要保留所有現有的資產連結，請將此專案設定或保留為 nil。 如果您設定此元素，則會取代先前連結至此廣告的任何標題。		 AssetLink 數 組
Path1 選擇性路徑的第一個部分，將附加至顯示 URL 的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定 Path1 的值，它會附加至顯示 URL。 如果您也指定 Path2的值，則它也會附加至 Path1之後的顯示 URL。 例如，如果您 的 FinalUrls 包含 https://www.contoso.com 、 Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2 。

路徑可以包含動態參數，例如 {MatchType}。 如需支援的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為 1,000 個字元。 不能輸入超過 15 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 1,000 個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

路徑不能包含正斜線 (/) 或分行符號 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

路徑可以包含 IF 函式。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string
Path2 選擇性路徑的第二個部分，將附加至顯示 URL 的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定 Path1 的值，它會附加至顯示 URL。 如果您也指定 Path2的值，則它也會附加至 Path1之後的顯示 URL。 例如，如果您 的 FinalUrls 包含 https://www.contoso.com 、 Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2 。

如果也已設定 Path1 ，您只能指定 Path2 。

路徑可以包含動態參數，例如 {MatchType}。 如需支援的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為 1,000 個字元。 不能輸入超過 15 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 1,000 個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

路徑不能包含正斜線 (/) 或分行符號 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

路徑可以包含 IF 函式。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string

ResponsiveSearchAd物件具有Inherited Elements。

繼承的專案

從廣告繼承的元素

ResponsiveSearchAd物件衍生自Ad物件，並繼承下列元素：AdFormatPreference、DevicePreference、ApprovalStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters。 下列描述專屬於 ResponsiveSearchAd，可能不適用於從 Ad 物件繼承相同元素的其他物件。

元素 說明 資料類型
AdFormatPreference 不支援此廣告類型。 string
DevicePreference 不支援此廣告類型。 長
編輯狀態 廣告的編輯檢閱狀態，指出廣告是否擱置檢閱、已核准或已取消核准。

添加： 唯讀
更新： 唯讀		 AdEditorialStatus
FinalAppUrls 不支援此廣告類型。 AppUrl 數 組
FinalMobileUrls 行動登陸頁面 URL。

下列驗證規則適用于最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和FinalMobileUrls指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 HTTP:// 或 HTTPs:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。
- 如果裝置喜好設定設定為行動裝置，您可能無法指定 FinalMobileUrls 。

只有在 關鍵字未指定最終行動 URL 時，才會使用此 URL。

添加： 選
更新： 選		 字串數 組
FinalUrls 登陸頁面 URL。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

下列驗證規則適用于最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和FinalMobileUrls指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 HTTP:// 或 HTTPs:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。
- 如果裝置喜好設定設定為行動裝置，您可能無法指定 FinalMobileUrls 。 另請注意，如果已設定此廣告的 TrackingUrlTemplate 或 UrlCustomParameters 元素，則至少需要一個最終 URL。

只有在 關鍵字未指定最終 URL 時，才會使用此 URL。

添加： 必填
更新： 選		 字串數 組
FinalUrlSuffix 最終的 URL 尾碼可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 尾碼中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 尾碼 。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 數 組
識別碼 廣告的唯一 Microsoft Advertising 識別碼。

添加： 唯讀
更新： 必要和 Read-Only		 長
狀態 廣告的狀態。

您可以將廣告狀態設定為 [作用中] 或 [已暫停]。

添加： 選
更新： 選		 AdStatus
TrackingUrlTemplate 要作為所有登陸頁面 URL 預設值的追蹤範本。

下列驗證規則適用于追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？
- 針對較低層級實體定義的追蹤範本，例如廣告會覆寫針對較高層級實體設定的範本，例如行銷活動。 如需詳細資訊，請參閱 實體限制。
- 追蹤範本的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 追蹤範本必須是格式正確的 URL，開頭為下列其中一項： HTTP://、 HTTPs://、 {lpurl}或 {unescapedlpurl}。
- Microsoft Advertising 不會驗證自訂參數是否存在。 如果您在追蹤範本中使用自訂參數，但它們不存在，則登陸頁面 URL 會包含自訂參數的索引鍵和值預留位置，而不需替代。 例如，如果您的追蹤範本是 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} ，且 { _season} 或 {_promocode} 都未定義于行銷活動、廣告群組、準則、關鍵字或廣告層級，則登陸頁面 URL 會相同。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string
類型 廣告的類型。 當您擷取回應式搜尋廣告時，此值為 ResponsiveSearch 。 如需廣告類型的詳細資訊，請參閱 廣告資料物件備註。

添加： 唯讀
更新： 唯讀		 AdType
UrlCustomParameters 用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您在CustomParameters物件中包含的前 8 個CustomParameter物件，而且如果您包含超過 8 個自訂參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自訂參數。 若要移除所有自訂參數，請將CustomParameters物件的Parameters元素設定為 null 或空白。 若要移除自訂參數的子集，請在CustomParameters物件的Parameters元素中指定您想要保留的自訂參數。		 CustomParameters

需求

服務： CampaignManagementService.svc v13
命名 空間： https://bingads.microsoft.com/CampaignManagement/v13