共用方式為

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) (CA) 、開曼群島 (KY) 、 挪威 (CL) 、哥倫比亞 (CO) 、加西亞 (CR) 、加西亞 (CR (CA) 、開曼群島 (KY) 、 挪威 (CL) 、哥倫比亞 (CO) 、加西亞 (CR) 、加西亞 (CR (CA) 、開曼群島 (KY) 、 挪威 (CL) 、克羅埃西亞 (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) 、匈牙利 (胡) 、 (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) 、英國 (UK) 、美國 (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廣告標識符。

加： 唯讀
更新： 必要和 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