飛線廣告延伸模組記錄 - 大量

發行項
12/21/2023

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

飛出視窗延伸模組可讓廣告商將產品或商店目錄散發 () 給潛在客戶。

他們可以在廣泛查詢上明顯顯示，例如「每週交易」或「每週銷售」，因此鼓勵顧客按一下您的廣告，而不是競賽。根據其本質，它們有助於更妥善地通知搜尋人員，因此增加使用者參與度，例如按下速率。

注意事項

在功能試驗 (GetCustomerPilotFeatures 會傳回 802) ，讓客戶可以使用飛出視窗擴充功能。

您可以將飛出視窗廣告延伸模組與帳戶或帳戶中的行銷活動和廣告群組建立關聯。每個實體 (帳戶、行銷活動或廣告群組) 最多可以與 3 個飛人版廣告延伸模組相關聯。使用 \[帳戶飛出\] \[廣告擴充功能\]、\ [廣告群組飛人\] \[廣告擴充功能\] 和 \[ 行銷活動飛人\] \[廣告擴充功能\] 記錄來管理飛出視窗廣告擴充功能關聯。

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

下列大量 CSV 範例會將新的 Flyer Ad Extension 新增至帳戶的共用程式庫。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Store Id,Name,Ad Schedule,Use Searcher Time Zone,Flyer Name,Description,Final Url,Mobile Final Url,Media Ids,Media Urls
Format Version,,,,,,,,,,,6.0,,,,,,
Flyer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Flyer name goes here, Flyer description goes here,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three,12345678,

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

// Map properties in the Bulk file to the BulkFlyerAdExtension
var bulkFlyerAdExtension = new BulkFlyerAdExtension
{
    // '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 
    // FlyerAdExtension object of the Campaign Management service.
    FlyerAdExtension = new FlyerAdExtension
    {
        // 'Description' column header in the Bulk file
        Description = "Flyer description",

        // 'Id' column header in the Bulk file
        Id = flyerAdExtensionIdKey,
                        
        // '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/one",
            "https://www.contoso.com/two",
            "https://www.contoso.com/three"
        },
        // '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/one",
            "https://mobile.contoso.com/two",
            "https://mobile.contoso.com/three"
        },
        // 'Flyer Name' column header in the Bulk file
        FlyerName = "Flyer name",
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new[] {
            (long)12345678,
        },
        // 'Media Urls' column header in the Bulk file
        ImageMediaUrls = null,
        // 'Store Id' column header in the Bulk file
        StoreId = 12345678,
        // '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(bulkFlyerAdExtension);

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

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

針對 Flyer Ad Extension 記錄，大量檔案架構中提供下列屬性欄位。

廣告排程
用戶端識別碼
描述
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
結束日期
最終 URL
飛出視窗名稱
Id
媒體識別碼
媒體 URL
行動裝置最終 URL
修改時間
父項識別碼
發行者國家/地區
開始日期
狀態
市集識別碼
使用搜尋人員時區
版本

廣告排程

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

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

用戶端識別碼

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

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

說明

廣告商、機構或帳戶管理員可用來追蹤、標記或管理飛出視窗延伸模組的描述。

此描述不會與廣告或影像一起顯示。

這個專案的最大長度為 1,024 個字元。

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

編輯位置

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

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

編輯原因代碼

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

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

編輯狀態

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

下表說明可能的值。

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

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

編輯詞彙

失敗的編輯檢閱詞彙。

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

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

結束日期

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

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

結束日期必須在開始日期的 30 天內。

添加： 必填
更新： 選。結束日期可以縮短或延長，只要未設定開始日期，或是最多在新結束日期之前 30 天發生。
刪除： 唯讀

最終 URL

登陸頁面 URL。

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

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

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

飛出視窗名稱

飛出視窗名稱。

這個專案的最大長度為 150 個字元。

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

識別碼

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

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

媒體識別碼

要包含在廣告中的影像識別碼。

您只能設定一個媒體識別碼。

每個媒體識別碼都會對應至「GenericImage」子類型的影像。

影像的寬度和高度下限應為 220px，檔案大小上限為 3.9 MB。

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

媒體 URL

您已新增的媒體 URL。

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

行動裝置最終 URL

行動裝置的登陸頁面 URL。

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

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

修改時間

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

注意事項

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

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

父項識別碼

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

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

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

發行者國家/地區

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

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

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

開始日期

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

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

結束日期必須在開始日期的 30 天內。

添加： 必填
更新： 選。只要未設定結束日期，或是最多在新開始日期之後 30 天，即可縮短或延長開始日期。
刪除： 唯讀

狀態

廣告延伸模組的狀態。

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

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

市集識別碼

用於產品廣告之 Microsoft 商家中心商店的唯一識別碼。

添加： 選
更新： 唯讀。您無法在設定後更新存放區識別碼。
刪除： 唯讀

使用搜尋人員時區

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

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

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

版本

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

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

共用方式為

飛線廣告延伸模組記錄 - 大量

廣告排程

用戶端識別碼

說明

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

結束日期

最終 URL

飛出視窗名稱

識別碼

媒體識別碼

媒體 URL

行動裝置最終 URL

修改時間

父項識別碼

發行者國家/地區

開始日期

狀態

市集識別碼

使用搜尋人員時區

版本

其他資源