共用方式為

促銷廣告延伸模組記錄 - 大量

  • 發行項

定義可在大量檔案中下載及上傳的促銷廣告延伸模組。

注意事項

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

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

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含PromotionAdExtensions的DownloadEntity值，以下載帳戶中的所有 Promotion Ad Extension記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。

下列大量 CSV 範例會將新的促銷廣告延伸模組新增至帳戶的共用程式庫。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD

如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkPromotionAdExtension 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // PromotionAdExtension object of the Campaign Management service.
    PromotionAdExtension = new PromotionAdExtension
    {
        // 'Id' column header in the Bulk file
        Id = promotionAdExtensionIdKey,
        // 'Currency Code' column header in the Bulk file
        CurrencyCode = "USD",
        // 'Discount Modifier' column header in the Bulk file
        DiscountModifier = PromotionDiscountModifier.None,
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Money Amount Off' column header in the Bulk file
        MoneyAmountOff = null,
        // 'Orders Over Amount' column header in the Bulk file
        OrdersOverAmount = null,
        // 'Percent Off' column header in the Bulk file
        PercentOff = 20000000,
        // 'Promotion Code' column header in the Bulk file
        PromotionCode = "SAVE20",
        // 'Promotion Target' column header in the Bulk file
        PromotionItem = "shoes",
        // 'Occasion' column header in the Bulk file
        PromotionOccasion = PromotionOccasion.WomensDay,
        // 'Promotion End' column header in the Bulk file
        PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Promotion Start' column header in the Bulk file
        PromotionStartDate = null,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
                    
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkPromotionAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 促銷廣告延伸 模組記錄， 大量檔案架構中提供下列屬性欄位。

廣告排程

您希望廣告延伸模組與廣告一起顯示的日期和時間範圍清單。 每一天和時間範圍包括排程的星期幾、開始/結束時間，以及開始/結束分鐘。 每一天和時間範圍都會以左括弧和右括弧括住，並以分號 (;) 分隔符號來分隔其他日期和時間範圍。 在每天和時間範圍內，格式為 Day[StartHour：StartMinue-EndHour：EndMinute]。

StartHour的可能值範圍從 00 到 23，其中00相當於上午 12：00，而 12則是 12：00PM。

EndHour的可能值範圍從 00 到 24，其中00相當於上午 12：00，而 12 則是 12：00PM。

StartMinute和EndMinute的可能值範圍從 00 到 60。

下列範例示範工作日從上午 9：00 到下午 9：00 的日期和時間範圍： (Monday[09：00-21：00]) ; (Tuesday[09：00-21：00]) ; (Wednesday[09：00-21：00]) ; (Thursday[09：00-21：00]) ; (Friday[09：00-21：00])

添加： 選。 如果您未設定此欄位，廣告擴充功能將有資格在行事曆 開始 和 結束 日期期間隨時排程。
更新： 選。 無法更新個別的日期和時間範圍。 您可以藉由傳送應該取代先前集合的新集合，有效地更新日期和時間範圍。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。 如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。 如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

貨幣代碼

促銷價格或折扣的貨幣代碼。

只有當您設定 [貨幣金額關閉 ] 或 [ 訂單超過金額]時，才適用此欄位。

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

添加： 如果已設定 Money Amount Off 或 Orders Over Amount ，則為必要專案。
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您設定 \[ 關閉百分比\ ] 或 \[ 升階代碼\]，此設定將不再適用且將會遭到刪除。
刪除： 唯讀

自訂參數

用於 URL 追蹤的自訂索引鍵和值參數集合。

在大量檔案中，自訂參數清單的格式如下。

  • 將每個自訂參數組格式化為 Key=Value，例如 {_promoCode}=PROMO1。

  • Microsoft Advertising 會接受您包含的前 3 個自訂參數索引鍵和值組，並忽略任何其他自訂參數。 針對自訂參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，Microsoft Advertising 會接受您包含的前 8 個自訂參數索引鍵和值組，如果您包含超過 8 個自訂參數，則會傳回錯誤。

  • 每個索引鍵和值組都會以分號和空格 ( 分隔」;「) ，例如 {_promoCode}=PROMO1;{_season}=summer。

  • 索引鍵不能包含分號。 如果 Value 包含分號，則必須以 '\;' 逸出。 此外，如果 Value 包含反斜線，也必須以 '\' 逸出。

  • 金鑰不能超過 16 UTF-8 位元組，而且值不能超過 200 UTF-8 位元組。 針對自訂參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，值限制會增加到 250 UTF-8 位元組。 索引鍵是必要的，而 Value 是選擇性的。 金鑰的大小上限不包含大括弧和底線，也就是 '{'、'_' 和 '}'。

    注意事項

    使用大量服務時，金鑰必須以括弧和前置底線格式化，例如，如果 Key 為 promoCode，則必須格式化為 {_promoCode}。 使用行銷活動管理服務時，您無法指定括弧和底線。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 若要移除所有自訂參數，請將此欄位設定 為 delete_value。 delete_value關鍵字會移除先前的設定。 若要移除自訂參數的子集，請指定您想要保留的自訂參數，並省略任何您不想要保留的參數。 新的自訂參數集將取代任何先前的自訂參數集。
刪除： 唯讀

折扣修飾詞

促銷折扣修飾詞。

此欄位的可能值為 None 和 UpTo。

  • 無：促銷折扣不會修改。
  • UpTo：促銷折扣會使用「最高」字串前置詞進行修改。 例如，如果未修改的促銷折扣是「$20 脫鞋」，修改後的促銷是「最多 $20 美元脫鞋」。

添加： 選。 如果您未指定此欄位或將它保留空白，則會設定 [ 無 ] 的預設值。
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

編輯位置

編輯檢閱失敗的廣告延伸模組元件或屬性。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯原因代碼

識別失敗原因的程式碼。 如需可能的原因代碼清單，請參閱 編輯原因代碼。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯狀態

廣告延伸模組的編輯狀態。

下表說明可能的值。

值 描述
作用中 廣告延伸模組已通過編輯檢閱。
ActiveLimited 廣告延伸模組已在一或多個市場中通過編輯檢閱，而廣告延伸模組的一或多個欄位正在另一個市場中進行編輯檢閱。 例如，廣告延伸模組已通過加拿大的編輯檢閱，且仍在美國中擱置檢閱。
反對 廣告延伸模組的編輯檢閱失敗。
非作用中 廣告延伸模組的一或多個欄位正在進行編輯檢閱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

如果字片語合造成失敗，或失敗是以原則違規為基礎，則不會設定此欄位。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

結束日期

廣告延伸模組排程結束日期字串格式化為 MM/DD/YYYY。

結束日期包含在內。 例如，如果您將此欄位設定為 2020/12/31，則廣告延伸模組將會在 2020 年 12 月 31 日下午 11：59 停止顯示。

添加： 選。 如果您未指定結束日期，除非您暫停相關聯的活動、廣告群組或廣告，否則會繼續傳遞廣告延伸模組。
更新： 選。 結束日期可以縮短或延長，只要開始日期為 Null 或發生在新的結束日期之前。 如果您將此欄位設定為 delete_value 字串，則實際上是移除結束日期。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。 如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。 如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

最終 URL

登陸頁面 URL。

下列驗證規則適用于最終 URL 和最終行動 URL。

  • URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
  • 您最多可以為最終 URL 和行動裝置 最終 URL指定 10 個清單專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個清單專案，以獲得潛在的正向相容性。
  • 每個 URL 都會以分號和空格分隔 (」;「) 。
  • 僅允許使用 '{' 和 '}' 來描述標記，例如 {lpurl}。
  • 最後一個 URL 必須是格式正確的 URL，開頭為 HTTP:// 或 HTTPs://。
  • 如果您指定 [行動最終 URL]，則也必須指定 [最終 URL]。

添加： 必填
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

最終 URL 尾碼

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

注意事項

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

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

識別碼

系統產生的廣告延伸模組識別碼。

添加： 選。 您必須將此欄位保留空白，或指定負識別碼。 接著可以在相依記錄類型的 [識別碼 ] 欄位 中參考廣告延伸模組的負識別碼集，例如 廣告群組促銷廣告延伸 模組和 行銷活動促銷廣告延伸模組。 如果您要在相同的大量檔案中新增新的廣告擴充功能和新的相依記錄，則建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考金鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

語言

將用來提供廣告延伸模組的語言。

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

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

添加： 必填
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行動裝置最終 URL

行動裝置的登陸頁面 URL。

下列驗證規則適用于最終 URL 和最終行動 URL。

  • URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
  • 您最多可以為最終 URL 和行動裝置 最終 URL指定 10 個清單專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個清單專案，以獲得潛在的正向相容性。
  • 每個 URL 都會以分號和空格分隔 (」;「) 。
  • 僅允許使用 '{' 和 '}' 來描述標記，例如 {lpurl}。
  • 最後一個 URL 必須是格式正確的 URL，開頭為 HTTP:// 或 HTTPs://。
  • 如果您指定 [行動最終 URL]，則也必須指定 [最終 URL]。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

修改時間

上次更新實體的日期和時間。 值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關資訊，請參閱 基本 XML 資料類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

貨幣金額關閉

金額的升階值。

例如，若要促銷「$20 off shoes - On orders over $100」， set the Promotion Target to 「shoes」， set Currency Code to 「USD」， set Money Amount Off to 20， and set Orders Over Amount to 100.

添加： 必填。 您必須設定 [貨幣金額關閉 ] 或 [ 關閉百分比]，但無法同時設定這兩者。
更新： 選。 您可以設定 [貨幣金額關閉 ] 或 [ 關閉百分比]，但無法同時設定這兩者。
刪除： 唯讀

場合

升階機會。

促銷 活動 和排程 (廣告排程、 結束日期、 開始日期和 使用搜尋人員時區 欄位) 欄位會決定廣告中是否有資格顯示促銷。

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

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

天數值 說明
BackToSchool 「回到學校」促銷可隨時根據您的廣告延伸模組排程執行。
BlackFriday 「黑色星期五」促銷活動可從 10 月 15 日到 12 月 15 日執行。
BoxingDay 「Boxing Day」促銷活動可從 12 月 15 日到 1 月 15 日執行。
嘉年華 從 2 月 1 日到 3 月 31 日，可以執行「布建」促銷。
ChineseNewYear 「新年」促銷活動可從 1 月 15 日到 3 月 1 日執行。
耶誕節 「耶誕節」促銷活動可從 11 月 1 日到 1 月 15 日執行。
CyberMonday 「網路星期一」促銷活動可從 10 月 15 日到 12 月 15 日執行。
排 燈節 「Diwali」 促銷可從 9 月 1 日到 12 月 1 日執行。
復活節 「復活節」促銷活動可從 3 月 1 日到 4 月 30 日執行。
EidAlAdha 「Eid al-Adha」促銷可隨時根據您的廣告延伸模組排程執行。
EidAlFitr 「Eid al-Fitr」促銷可隨時根據您的廣告延伸模組排程執行。
EndOfSeason 根據您的廣告延伸模組排程，隨時可以執行「季末」促銷。
頓悟 「複本」升級可從 12 月 15 日到 1 月 31 日執行。
FallSale 根據您的廣告延伸模組排程，隨時可以執行「秋季銷售」促銷。
父代 根據您的廣告延伸模組排程，隨時可以執行「父親節」促銷。
萬聖節 「萬日」促銷活動可從 10 月 1 日到 11 月 15 日執行。
光明 「Hanukkah」 促銷可從 11 月 15 日到 1 月 31 日執行。
Holi 「Holi」促銷可從 2 月 1 日到 3 月 31 日執行。
獨立日 根據您的廣告擴充功能排程，隨時可以執行「獨立日」促銷。
LaborDay 「人力日」促銷活動可從 4 月 15 日到 9 月 15 日執行。
生者日 根據您的廣告延伸模組排程，隨時可以執行「母親節」促銷。
NationalDay 根據您的廣告擴充功能排程，隨時可以執行「國日」促銷。
Navratri 「Navratri」 促銷可從 9 月 15 日到 10 月 31 日執行。
NewYears 「新年」促銷可從 12 月 1 日到 2 月 28 日執行。
無 促銷可以隨時根據您的廣告擴充功能排程執行。
ParentsDay 「家長節」促銷可從 4 月 15 日到 8 月 1 日執行。
逾越 節 「傳遞」升級可從 2 月 15 日到 5 月 1 日執行。
齋月 「Ramadan」促銷可隨時根據您的廣告延伸模組排程執行。
RoshHaah 「Rosh Hashanah」促銷可從 8 月 15 日到 11 月 1 日執行。
工作日 「單一節」促銷可從 10 月 15 日到 11 月 30 日執行。
Songkran 「Songkran」 促銷可以隨時根據您的廣告延伸模組排程執行。
SpringSale 「Spring Sale」促銷可隨時根據您的廣告延伸模組排程執行。
StNicholasDay 「聖德日」促銷活動可從 11 月 1 日到 12 月 31 日執行。
SummerSale 根據您的廣告延伸模組排程，可以隨時執行「年月銷售」促銷。
Unknown 保留供日後使用。
ValentinesDay 「情人節」促銷活動可從 1 月 15 日到 2 月 28 日執行。
WinterSale 根據您的廣告擴充功能排程，隨時可以執行「在新期銷售」促銷。
WomensDay 「女性節」促銷活動可從 2 月 15 日到 3 月 31 日執行。
YearEndGift 根據您的廣告延伸模組排程，隨時可以執行「年終禮物」促銷。

添加： 選。 如果您未指定此欄位或將它保留空白，則會設定 [ 無 ] 的預設值。
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您設定此欄位，則也必須將 升級開始 和 升級結束 設定為保留或更新先前的設定。
刪除： 唯讀

訂單超過金額

附加至促銷目標之金額值的訂單。

例如，若要促銷「$20 off shoes - On orders over $100」， set the Promotion Target to 「shoes」， set Currency Code to 「USD」， set Money Amount Off to 20， and set Orders Over Amount to 100.

添加： 選。 您無法同時設定 Orders Over Amount 和 Promotion Code。
更新： 選。 您無法同時設定 Orders Over Amount 和 Promotion Code。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 '0'， (零) ，則會刪除先前的設定。
刪除： 唯讀

父項識別碼

系統產生的帳戶識別碼，其中包含廣告延伸模組。

此大量欄位會對應至客戶紀錄的 [ 標識 符 ] 字 段。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

發行者國家/地區

發行者國家或地區的清單，其編輯指導方針不允許指定的 詞彙。

在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

百分比關閉

以雙精度浮點數表示升階值的百分比。

例如，10.0 代表 10% 折扣。

添加： 必填。 您必須設定 [貨幣金額關閉 ] 或 [ 關閉百分比]，但無法同時設定這兩者。
更新： 選。 您可以設定 [貨幣金額關閉 ] 或 [ 關閉百分比]，但無法同時設定這兩者。 如果您設定此欄位，則 [貨幣代碼] 設定不再適用，如果先前已設定，則會予以刪除。
刪除： 唯讀

升級程式碼

附加至升級目標的升級程式碼。

例如，若要促銷 「$20 off shoes - Promocode SAVE20」，請將 促銷目標 設定為 「shoes」，將 貨幣代碼 設定為 「USD」，將 貨幣金額設定 為 20，並將 促銷碼 設定為 「SAVE20」。

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

添加： 選。 您無法同時設定 Orders Over Amount 和 Promotion Code。
更新： 選。 您無法同時設定 Orders Over Amount 和 Promotion Code。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會刪除先前的設定。 如果您設定此欄位，則 [貨幣代碼] 設定不再適用，如果先前已設定，則會予以刪除。 刪除： 唯讀

升級結束

結束日期有助於通知廣告中將顯示的促銷日期。

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

升級開始日期必須早于或等於促銷結束日期。

這個屬性不會覆寫升級的固有傳遞範圍。 促銷 活動 和排程 (廣告排程、 結束日期、 開始日期和 使用搜尋人員時區) 欄位都會決定廣告中是否有資格顯示促銷。

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

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 若要刪除目前的結束日期，且實際上未設定結束日期，請將此欄位設定為 delete_value 字串。 當您下次擷取促銷廣告延伸模組時，將不會設定此欄位。
刪除： 唯讀

升級開始

開始日期有助於通知廣告中將顯示的促銷日期。

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

升級開始日期必須早于或等於促銷結束日期。

這個屬性不會覆寫升級的固有傳遞範圍。 促銷 活動 和排程 (廣告排程、 結束日期、 開始日期和 使用搜尋人員時區) 欄位都會決定廣告中是否有資格顯示促銷。

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

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 若要刪除目前的結束日期，且實際上未設定結束日期，請將此欄位設定為 delete_value 字串。 當您下次擷取促銷廣告延伸模組時，將不會設定此欄位。
刪除： 唯讀

升級目標

升級目標或專案。

例如，您可能會以美金 $20 元或 20% 的折扣執行「鞋子」促銷。 若要執行「最多 20 美元脫鞋」的促銷，請將 促銷目標 設定為 「shoes」、將 Discount 修飾詞 設定為 「UpTo」、將 貨幣代碼 設定為 「USD」，並將 [貨幣金額] 設為 [關閉] 為 20。

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

添加： 必填
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

開始日期

廣告延伸模組排程的開始日期字串格式化為 MM/DD/YYYY。

開始日期包含在內。 例如，如果您將 StartDate 設定為 5/5/2020，則廣告延伸模組會在 2020 年 5 月 5 日上午 12：00 開始顯示。

添加： 選。 如果您未指定開始日期，則廣告擴充功能立即符合 排程的資格。
更新： 選。 只要結束日期為 Null 或發生在新的開始日期之後，就可以縮短或延長開始日期。 如果您將此欄位設定 為delete_value 字串，則實際上會移除開始日期，且廣告延伸模組立即符合 排程的資格。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。 如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。 如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

狀態

廣告延伸模組的狀態。

可能的值為 [作用中 ] 或 [已刪除]。

添加： 選。 預設值為 Active。
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

追蹤範本

用於升級 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 會相同。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

使用搜尋人員時區

判斷是要使用帳戶時區，還是廣告可傳遞之搜尋使用者的時區。

如果您想要在搜尋使用者的時區中顯示廣告延伸模組，並將此屬性設定為 TRUE ，否則請將它設定為 FALSE。

添加： 選。 如果您未指定此欄位或將其保留空白，則會設定 FALSE 的預設值，並使用帳戶時區。
更新： 選。 如果您將此欄位設定為 delete_value 字串，則實際上會重設為預設值 FALSE。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。 如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。 如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

版本

廣告延伸模組內容已更新的次數。 當您新增擴充功能時，版本會設定為 1，而且每次修訂時都會遞增。

添加： 唯讀
更新： 唯讀
刪除： 唯讀