共用方式為

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

  • 發行項

定義動態搜尋廣告。

使用動態搜尋廣告時，標題和顯示 URL 會根據您想要設為目標的網站網域和語言自動產生。 Path1、Path2 和 Text 元素的組合讓動態搜尋廣告成為唯一的。 您可以選擇性地使用 頁面摘要來提供靜態標題。

注意事項

這項功能目前適用于下列國家或地區： (AL) 、Andorra (AD) 、 阿根廷 (AR) 、Aruba、Australia (AU) 、奧地利 (AT) 、巴哈馬 (BS) 、孟加拉國 (BD) 、比利時 (BE) 、加勒 (BO) 、波士尼亞和赫塞哥維尼亞 (BA) 、巴西 (BR) 、 汶萊 (BN) 、保加利亞 (BG) 、加拿大 (CA) 、開曼群島 (KY) 、 挪威 (CL) 、哥倫比亞 (CO) 、加西亞 (CR) 、克羅埃西亞 (HR) 、 (CY) 、捷克 (CZ) 、丹麥 (DK) 、亞馬亞 (DM) 、挪威共和國 (DO) 、 愛沙尼亞 (EC) 、El France (SV) 、愛沙尼亞 (EE) 、愛沙尼亞 (FJ) 、芬蘭 (FI) 、法國 (FR) 、 法屬 guiana (GF) 、法屬 Polynesia (PF) 、德國 (DE) 、希臘 (GR) 、關島 (GU) 、 (GT) 、Guyana (GY) 、 (HT) 、 匈牙利 (HN) 、匈牙利 (HU) 、印度 (IS) 、印度 (IN) 、印尼 (識別碼) 愛爾蘭 (IE) 、義大利 (IT) 、拉脫維亞 (LV) 、列支敦斯登 (LI) 、立陶宛 (LT) 、盧森堡 (LU) 、馬來西亞 (MY) 、Maldives (MV) 、 (MT) 、 馬提尼 (MQ) 、墨西哥 (MX) 、 (MC) 、蒙古 (MN) 、蒙特內哥羅 (ME) 、 Montserrat (MS) ， Republic (NP) ， 荷蘭 (NL) ， New Caledonia (NC) ， 紐西蘭 (NZ) ， 北馬其頓共和國 (MK) ， 挪威 (NO) ， (PA) ， 幾內亞 (PY) 、巴布亞紐幾內亞 (PG) 、秘魯 (PE) 、幾內亞 (PH) 、 波蘭 (PO) 、葡萄牙 (PT) 、波多黎各、羅馬尼亞 (RO) 、San Marino (SM) 、塞爾維亞 (RS) 、新加坡 (SG) 、斯洛伐克 (SK) 、斯洛維尼亞 (SI) 、南非 (ZA) 西班牙 (ES) 、西班牙 (ES) 、斯拉西亞 (LK) 、瑞典 (SE) 、 瑞士 (CH) 、泰國 (TH) 、Trinidad 和 Tobago (TT) 、土耳其 (TR) 、 (VA) 、越南 (VN) 、英國 (英國) 、美國 (US) 、 (UY) 、 和[和安全 (VE) 。

動態搜尋廣告只能在具有 DynamicSearchAdsSetting 的搜尋活動中建立。 無法設定行銷活動的 ExperimentId 元素，而且 AdGroupType 必須設定為 「SearchDynamic」。

注意事項

您無法再新增、更新或擷取僅支援動態搜尋廣告的活動。 您現有行銷活動的行銷活動類型已從 「DynamicSearchAds」 更新為 「Search」。 廣告群組現在被視為「動態」廣告群組，但沒有任何結構化變更，也就是它們包含與之前相同的自動目標和動態搜尋廣告。

語法

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

元素

DynamicSearchAd物件具有下列元素：Path1、Path2、Text、TextPart2。

元素 說明 資料類型
Path1 選擇性路徑的第一個部分，將附加至顯示 URL 的網域部分。 顯示 URL，例如 www.contoso.com 會從顯示 URL 的網域產生。 然後，如果您已指定 Path 1 的值，它會附加至顯示 URL。 如果您也指定 了 Path 2的值，則它也會附加至 Path 1之後的顯示 URL。 例如，如果您的網域 contoso.com， 路徑 1 設定為 subdirectory1， 而 Path 2 設為 subdirectory2，則顯示的 URL 將會 www.contoso.com/subdirectory1/subdirectory2。

路徑的最大輸入長度為 15 個字元。 請注意，對於具有雙寬字元的語言，例如繁體中文，路徑的最大輸入長度為 7 個字元。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

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

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

添加： 選
更新： 選		 string
Path2 選擇性路徑的第二個部分，將附加至顯示 URL 的網域部分。 顯示 URL，例如 www.contoso.com 會從動態搜尋廣告行銷活動層級設定的網域產生。 然後，如果您已指定 Path 1 的值，它會附加至顯示 URL。 如果您也指定 了 Path 2的值，則它也會附加至 Path 1之後的顯示 URL。 例如，如果您的網域 contoso.com， 路徑 1 設定為 subdirectory1， 而 Path 2 設為 subdirectory2，則顯示的 URL 將會 www.contoso.com/subdirectory1/subdirectory2。

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

路徑的最大輸入長度為 15 個字元。 請注意，對於具有雙寬字元的語言，例如繁體中文，路徑的最大輸入長度為 7 個字元。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

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

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

添加： 選
更新： 選		 string
文字 廣告描述的第一個部分。

文字必須至少包含一個字。

複製的最大輸入長度為 90 個字元。 請注意，對於使用繁體中文的廣告群組，複本的最大輸入長度為 45 個字元。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

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

添加： 必填
更新： 選		 string
TextPart2 廣告描述的第二個部分。

文字必須至少包含一個字。

複製的最大輸入長度為 90 個字元。 請注意，對於使用繁體中文的廣告群組，複本的最大輸入長度為 45 個字元。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

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

添加： 選
更新： 選		 string

DynamicSearchAd物件具有Inherited Elements。

繼承的專案

從廣告繼承的元素

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

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

添加： 唯讀
更新： 唯讀		 AdEditorialStatus
FinalAppUrls 不支援此廣告類型。 AppUrl 數 組
FinalMobileUrls 不支援此廣告類型。 字串數 組
FinalUrls 不支援此廣告類型。 字串數 組
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
類型 廣告的類型。 當您擷取動態搜尋廣告時，此值為 DynamicSearch 。 如需廣告類型的詳細資訊，請參閱 廣告資料物件備註。

添加： 唯讀
更新： 唯讀		 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