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

定義包含 3 到 8 個價位資料表資料列的廣告延伸模組。

您可以將價格廣告延伸模組與帳戶或帳戶中的行銷活動和廣告群組建立關聯。 每個實體 (帳戶、行銷活動或廣告群組) 最多可以與 20 個價格廣告延伸模組相關聯。

語法

<xs:complexType name="PriceAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element name="PriceExtensionType" type="tns:PriceExtensionType" />
        <xs:element minOccurs="0" name="TableRows" nillable="true" type="tns:ArrayOfPriceTableRow" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

PriceAdExtension物件具有下列元素：FinalUrlSuffix、Language、PriceExtensionType、TableRows、TrackingUrlTemplate、UrlCustomParameters。

元素	說明	資料類型
FinalUrlSuffix	最終的 URL 尾碼可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 尾碼中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 尾碼 。 這項功能僅適用于最終 URL 尾碼階段 3 試驗中的客戶 (GetCustomerPilotFeatures 會傳回 636) 。 如果您不在試驗中，則會忽略此屬性，而且不會傳回任何錯誤。 添加： 選 更新： 選。 如果未設定更新的值，則此設定不會變更。	string
語言	價格廣告延伸模組廣告複本的語言。 如需可能的值，請參閱 廣告語言。 添加： 必填 更新： 必填	string
PriceExtensionType	價格廣告延伸模組的類型。 可能的值包括： 品牌、 事件、 位置、 鄰近地區、 ProductCategories、 ProductTiers、 ServiceCategories、 Services、 ServiceTiers和 Unknown。 添加： 必填 更新： 必填	PriceExtensionType
TableRows	價位表資料列。 您必須有 3 到 8 個價位表資料列。 您在 廣告中建立它們的順序是預期的順序，但不保證訂單。 添加： 必填 更新： 必填	PriceTableRow 數 組
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 會相同。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	string
UrlCustomParameters	用於 URL 追蹤的自訂索引鍵和值參數集合。 Microsoft Advertising 會接受您包含在CustomParameters物件內的前 3 個CustomParameter物件，並忽略任何其他自訂參數。 每個 CustomParameter 都包含 Key 和 Value 元素。 針對自訂參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，Microsoft Advertising 會接受您包含的前 8 個自訂參數索引鍵和值組，如果您包含超過 8 個自訂參數，則會傳回錯誤。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	CustomParameters

PriceAdExtension物件具有Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

PriceAdExtension物件衍生自AdExtension物件，並繼承下列元素：DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version。 下列描述專屬於 PriceAdExtension，而且可能不適用於從 AdExtension 物件繼承相同元素的其他物件。

元素	說明	資料類型
DevicePreference	不支援此廣告延伸模組類型。	長
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 AdExtension物件目前沒有向前相容性變更。 添加： 唯讀 更新： 唯讀	KeyValuePairOfstringstring 數 組
識別碼	廣告延伸模組的唯一 Microsoft Advertising 識別碼。 添加： 唯讀 更新： 唯讀和必要	長
排程	決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。 添加： 選 更新： 選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此專案設定為空的 Schedule 物件。	Schedule
狀態	廣告延伸模組的狀態。 此值一律為 [作用 中]，因為行銷活動管理服務不會傳回已刪除的廣告延伸模組。 添加： 唯讀 更新： 唯讀	AdExtensionStatus
類型	廣告延伸模組的類型。 當您擷取價格廣告延伸模組時，此值為 PriceAdExtension 。 添加： 唯讀 更新： 唯讀 如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組資料物件備註。	string
版本	追蹤廣告延伸模組更新的次數。 建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。 添加： 不允許 更新： 不允許	int

需求

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