共用方式為

PromotionAdExtension 數據物件 - 營銷活動管理

  • 發行項

促銷延伸模組會醒目提示文字廣告中的特殊銷售和供應專案。 藉由讓供應項目脫穎而出，潛在客戶更可能按下您的廣告，協助為您產生更多銷售。

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

注意事項

促銷延伸模組適用於 AU、CA、DE、FR、US 和 UK 的客戶。

語法

<xs:complexType name="PromotionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DiscountModifier" nillable="true" type="tns:PromotionDiscountModifier" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q57="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q57:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q58="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q58:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="MoneyAmountOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="OrdersOverAmount" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PromotionCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionEndDate" nillable="true" type="tns:Date" />
        <xs:element minOccurs="0" name="PromotionItem" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionOccasion" nillable="true" type="tns:PromotionOccasion" />
        <xs:element minOccurs="0" name="PromotionStartDate" nillable="true" type="tns:Date" />
        <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>

元素

PromotionAdExtension 物件具有下列元素：CurrencyCode、DiscountModifier、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、Language、MoneyAmountOff、OrdersOverAmount、PercentOff、PromotionCode、PromotionEndDate、PromotionItem、PromotionOccasion、PromotionStartDate、TrackingUrlTemplate、UrlCustomParameters。

元素 描述 資料類型
CurrencyCode 促銷價格或折扣的貨幣代碼。

只有當您設定 MoneyAmountOff 或 OrdersOverAmount 時，才適用此字段。

支援的貨幣代碼為 ARS、AUD、BRL、CAD、CHF、CLP、CNY、COP、DKK、EUR、GBP、HKD、INR、MXN、NZD、PEN、PHP、PLN、SEK、SGD、USD、TWD 和 VEF。

加： 如果已設定 MoneyAmountOff 或 OrdersOverAmount ，則為必要專案。
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您設定 PercentOff 或 PromotionCode，此設定將不再適用，而且將會被刪除。		 string
DiscountModifier 促銷折扣修飾詞。

例如，假設折扣修飾詞設定為 UpTo。 然後，如果未修改的促銷折扣是“$20 脫鞋”，修改後的促銷是「最多 $20 美元脫鞋」。

加： 自選。 如果您未指定此元素或將它保留空白， 則會設定 None 的預設值。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 PromotionDiscountModifier
FinalAppUrls 供日後使用。 AppUrl 陣 列
FinalMobileUrls 行動裝置的登陸頁面 URL。

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

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空白清單，則會刪除先前的設定。		 字串陣列
FinalUrls 登陸頁面 URL。

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

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

這項功能僅適用於最終 URL 後綴階段 3 試驗中的客戶 (GetCustomerPilotFeatures 會傳回 636) 。 如果您不在試驗中，則會忽略此屬性，而且不會傳回任何錯誤。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
語言 將用來提供廣告延伸模組的語言。

不論營銷活動或廣告群組的語言設定為何，擴充功能一律會以這種語言提供。

支持的語言字串為：丹麥文、荷蘭文、英文、芬蘭文、法文、德文、義大利文、挪威文、葡萄牙文、西班牙文、瑞典文和傳統語言。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
MoneyAmountOff 金額的升階值。

例如，若要促銷 “$20 off shoes - On orders over $100”，請將 PromotionItem 設定為 “shoes”， set CurrencyCode to “USD”， set MoneyAmountOff to 20， and set OrdersOverAmount to 100.

加： 必填。 您必須設定 MoneyAmountOff 或 PercentOff，但無法同時設定兩者。
更新： 自選。 您可以設定 MoneyAmountOff 或 PercentOff，但無法同時設定兩者。		 雙
OrdersOverAmount 附加至促銷目標之金額值的訂單。

例如，若要促銷 “$20 off shoes - On orders over $100”，請將 PromotionItem 設定為 “shoes”， set CurrencyCode to “USD”， set MoneyAmountOff to 20， and set OrdersOverAmount to 100.

加： 自選。 您無法同時設定 OrdersOverAmount 和 PromotionCode。
更新： 自選。 您無法同時設定 OrdersOverAmount 和 PromotionCode。 如果未設定更新的值，則此設定不會變更。 如果您將這個項目設定為 『0』， (零) ，則會刪除先前的設定。		 雙
PercentOff 升階值的關閉百分比。

例如，10.0 代表 10% 折扣。

加： 必填。 您必須設定 MoneyAmountOff 或 PercentOff，但無法同時設定兩者。
更新： 自選。 您可以設定 MoneyAmountOff 或 PercentOff，但無法同時設定兩者。 如果您設定此屬性，則 CurrencyCode 設定不再適用，如果先前已設定，則會予以刪除。		 雙
PromotionCode 附加至升級目標的升級程序代碼。

例如，若要促銷 「$20 off shoes - Promocode SAVE20」，請將 PromotionItem 設定為 「shoes」，將 CurrencyCode 設定為 “USD”，將 MoneyAmountOff 設定為 20，並將 PromotionCode 設定為 “SAVE20”。

字串最多可以包含15個字元。

加： 自選。 您無法同時設定 OrdersOverAmount 和 PromotionCode。
更新： 自選。 您無法同時設定 OrdersOverAmount 和 PromotionCode。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。 如果您設定此屬性，則 CurrencyCode 設定不再適用，如果先前已設定，則會予以刪除。		 string
PromotionEndDate 結束日期有助於通知廣告中將顯示的促銷日期。

例如，如果 PromotionStartDate 和 PromotionEndDate 日期都設定為 2 月 14 日，則顯示的促銷中可能會包含「有效 2 月 14 日」文字。

PromotionStartDate 日期必須早於或等於 PromotionEndDate 日期。

這個屬性不會覆寫升級的固有傳遞範圍。 PromotionOccasion 和排程會決定促銷何時有資格顯示在廣告中。

如果目前年度的結束日期已經過，則必須在下一年的日期設定每個開始和結束日期。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要刪除目前的結束日期並有效設定無結束日期，請將 Day、 Month 和 Year 分別設定為 '0'， (零) 。 當您下次擷取促銷廣告延伸模組時，將不會設定此元素。		 Date
PromotionItem 升級目標或專案。

例如，您可能會以美金 $20 元或 20% 的折扣執行「鞋子」促銷。 若要執行「最多 20 美元脫鞋」的促銷，請將 PromotionItem 設定為 “shoes”，將 DiscountModifier 設定為 UpTo，將 CurrencyCode 設定為 “USD”，並將 MoneyAmountOff 設為 20。

字串最多可以包含 20 個字元。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
PromotionOccasion 升階機會。

PromotionOccasion 和 Scheduling 元素都會決定促銷何時有資格顯示在廣告中。

PromotionOccasion 會決定每年 2 月 15 日到 3 月 31 日的期間或季節性，例如 WomensDay。 升級只會在您設定的對應日期內執行。 如需每個時間之已定義日期範圍的詳細資訊，請參閱 PromotionOccasion 。

排 程 可以將升階限制為縮短時間範圍，例如，限制從 2 月 20 日到 3 月 8 日執行升階。 排 程 也可用來執行相同的促銷年份，例如，從每年 2 月 15 日到 3 月 31 日執行 WomensDay 促銷。

加： 自選。 如果您未指定此元素或將它保留空白， 則會設定 None 的預設值。
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您設定此元素，則 PromotionStartDate 和 PromotionEndDate 也必須設定為保留或更新先前的設定。		 PromotionOccasion
PromotionStartDate 開始日期有助於通知廣告中將顯示的促銷日期。

例如，如果 PromotionStartDate 和 PromotionEndDate 日期都設定為 2 月 14 日，則顯示的促銷中可能會包含「有效 2 月 14 日」文字。

PromotionStartDate 日期必須早於或等於 PromotionEndDate 日期。

這個屬性不會覆寫升級的固有傳遞範圍。 PromotionOccasion 和排程會決定促銷何時有資格顯示在廣告中。

如果目前年度的結束日期已經過，則必須在下一年的日期設定每個開始和結束日期。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要刪除目前的結束日期並有效設定無結束日期，請將 Day、 Month 和 Year 分別設定為 '0'， (零) 。 當您下次擷取促銷廣告延伸模組時，將不會設定此元素。		 Date
TrackingUrlTemplate 要作為所有 FinalUrls 和FinalMobileUrls 預設值的追蹤範本。

下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 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
UrlCustomParameters 用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您包含在 CustomParameters 物件內的前 3 個 CustomParameter 物件，並忽略任何其他自定義參數。 每個 CustomParameter 都包含 Key 和 Value 元素。 針對自定義參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，如果您包含超過 8 個自定義參數，則會傳回錯誤。

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

PromotionAdExtension 物件具有 Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

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

元素 描述 資料類型
DevicePreference 不支援此廣告延伸模組類型。 長
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

AdExtension 物件目前沒有向前相容性變更。

加： 唯讀
更新： 唯讀		 KeyValuePairOfstringstring 陣 列
標識碼 廣告擴充功能的唯Microsoft廣告標識碼。

加： 唯讀
更新： 唯讀和必要		 長
排程 決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。

加： 自選
更新： 自選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此項目設定為空的 Schedule 物件。		 Schedule
地位 廣告延伸模組的狀態。 此值一律為 [作用 中]，因為營銷活動管理服務不會傳回已刪除的廣告延伸模組。

加： 唯讀
更新： 唯讀		 AdExtensionStatus
類型 廣告延伸模組的類型。 當您擷取促銷廣告延伸模組時，此值為 PromotionAdExtension 。

加： 唯讀
更新： 唯讀

如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組數據物件備註。		 string
版本 追蹤廣告延伸模組更新的次數。

建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。

加： 不允許
更新： 不允許		 int

需求

服務： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13