位置廣告延伸模組記錄 - 大量

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

您可以將位置廣告延伸模組與帳戶或帳戶中的行銷活動建立關聯。 每個實體 (帳戶或行銷活動) 可以與您決定的位置廣告延伸模組建立關聯，最多可達您帳戶中的位置廣告延伸模組總數。 使用 帳戶位置廣告擴充 功能和 行銷活動位置廣告擴充 功能記錄來管理位置廣告延伸模組關聯。

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
    // '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 
    // LocationAdExtension object of the Campaign Management service.
    LocationAdExtension = new LocationAdExtension
    {
        Address = new Address
        {
            // 'City' column header in the Bulk file
            CityName = "Woodinville",
            // 'Country Code' column header in the Bulk file
            CountryCode = "US",
            // 'Postal Code' column header in the Bulk file
            PostalCode = "98608",
            // 'State Or Province Code' column header in the Bulk file
            ProvinceCode = null,
            // 'Province Name' column header in the Bulk file
            ProvinceName = "WA",
            // 'Address Line 1' column header in the Bulk file
            StreetAddress = "1234 Washington Place",
            // 'Address Line 2' column header in the Bulk file
            StreetAddress2 = "Suite 1210",
        },
        // 'Business Name' column header in the Bulk file
        CompanyName = "Contoso Shoes",
        // 'Geo Code Status' column header in the Bulk file
        GeoCodeStatus = null,
        GeoPoint = new GeoPoint
        {
            // 'Latitude' column header in the Bulk file
            LatitudeInMicroDegrees = 0,
            // 'Longitude' column header in the Bulk file
            LongitudeInMicroDegrees = 0,
        },
        // 'Id' column header in the Bulk file
        Id = locationAdExtensionIdKey,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "206-555-0100",

        // '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(bulkLocationAdExtension);

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

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

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

• 廣告排程
• 位址行 1
• 位址行 2
• 商務名稱
• City
• 用戶端識別碼
• 國家/地區代碼
• 編輯位置
• 編輯原因代碼
• 編輯狀態
• 編輯詞彙
• 結束日期
• 地理程式碼狀態
• Id
• 緯度
• 經度
• 修改時間
• 父項識別碼
• 電話號碼
• 郵遞區號
• 省名稱
• 發行者國家/地區
• 開始日期
• 州或省代碼
• 狀態
• 使用搜尋人員時區
• 版本

廣告排程

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

位址行 1

位址的第一行。

第一行最多可以包含 80 個字元。

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

位址行 2

位址的第二行。

第二行最多可以包含 80 個字元。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。
刪除： 唯讀

商務名稱

企業名稱。

名稱最多可以包含 80 個字元。

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

城市

街地道址所在的城市名稱。

名稱最多可以包含 80 個字元。

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

用戶端識別碼

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

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

國碼

街地道址所在的國家或地區。

國家/地區代碼必須包含 2 個字元的國家/地區代碼。 支援的國碼值包括 AR、AT、AU、BR、CA、CH、CL、CO、DE、DK、ES、FI、FR、GB、HK、ID、IE、IN、IT、MX、MY、NL、NZ、NO、PE、PH、SE、SG、TH、TW、US、VE 和 VN。

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

編輯位置

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

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

編輯原因代碼

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

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

編輯狀態

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

下表說明可能的值。

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

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

編輯詞彙

失敗的編輯檢閱詞彙。

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

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

結束日期

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

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

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

地理程式碼狀態

狀態值，指出是否已判斷企業的緯度和經度座標。

如果您提供座標，狀態會設定為 [ 完成];否則，狀態會指出判斷所指定企業位址座標的進度。

下表說明可能的值。

值	描述
完成	成功判斷企業的緯度和經度。
失敗	無法判斷企業的緯度和經度。
無效	無法判斷企業的緯度和經度，可能是因為位址未解析。
擱置	在判斷業務緯度和經度的程式中。

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

識別碼

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

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

緯度

以度為單位指定的緯度。 緯度必須大於或等於 -85 且小於或等於 +85。

注意事項

行銷活動管理服務使用從 -850000000 到 850000000 的微度。 當您透過 SDK 使用 BulkLocationAdExtension 時，您應該使用微度，因為 BulkLocationAdExtension 實作會從微度轉換，並將值寫入為 Bulk 檔案中的度數。

當使用者按一下廣告上的位址時，緯度和經度座標會用來標示Bing 地圖服務上的商務位置。 如果指定的座標不在有效值的範圍內，服務會根據地址決定座標。

如果您指定已知的座標，服務不會確認指定的座標是否符合指定的商務位址。 如果您未提供座標，大量服務會使用企業位址來判斷座標。

注意事項

新增超過 10 個位置廣告延伸模組時，服務會離線解析座標，否則會在服務作業執行期間預先解析座標。 在決定座標之前，將不會在廣告中使用位置，這可能需要幾秒到幾分鐘的時間，視新增的位置廣告延伸模組數目和目前的需求而定。

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

經度

以度為單位指定的經度。 經度必須大於或等於 -180 且小於或等於 +180。

注意事項

行銷活動管理服務使用從 -1800000000 到 1800000000 的微度。 當您透過 SDK 使用 BulkLocationAdExtension 時，您應該使用微度，因為 BulkLocationAdExtension 實作會從微度轉換，並將值寫入為 Bulk 檔案中的度數。

當使用者按一下廣告上的位址時，緯度和經度座標會用來標示Bing 地圖服務上的商務位置。 如果指定的座標不在有效值的範圍內，服務會根據地址決定座標。

如果您指定已知的座標，服務不會確認指定的座標是否符合指定的商務位址。 如果您未提供座標，大量服務會使用企業位址來判斷座標。

注意事項

新增超過 10 個位置廣告延伸模組時，服務會離線解析座標，否則會在服務作業執行期間預先解析座標。 在決定座標之前，將不會在廣告中使用位置，這可能需要幾秒到幾分鐘的時間，視新增的位置廣告延伸模組數目和目前的需求而定。

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

修改時間

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

注意事項

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

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

父項識別碼

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

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

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

電話號碼

要包含在廣告中的企業可點選電話號碼。

電話號碼最多可以包含 35 個字元，而且必須對指定的國家或地區有效。

如果行銷活動也包含通話擴充功能，通話擴充功能中的電話號碼將會覆寫位置廣告延伸模組的電話號碼。

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

郵遞區號

郵遞區號或郵遞區號。

郵遞區號最多可以包含 80 個字元。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。
刪除： 唯讀

省名稱

街地道址所在的州或省名稱，例如 華盛頓州。

名稱最多可以包含 50 個字元。

您必須指定 [省名稱] 或 [州或省代碼]。

注意事項

如果[國家/地區代碼] 欄位設定為 [FR]、[IE] 或 [SG]，則不需要 [州或省代碼] 和 [省名稱]。

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

發行者國家/地區

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

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

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

開始日期

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

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

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

州或省代碼

識別街地道址所在州或省的程式碼，例如 WA。

程式碼最多可以包含 50 個字元。

您必須指定 [省名稱] 或 [州或省代碼]。

注意事項

如果[國家/地區代碼] 欄位設定為 [FR]、[IE] 或 [SG]，則不需要 [州或省代碼] 和 [省名稱]。

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

狀態

廣告延伸模組的狀態。

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

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

使用搜尋人員時區

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

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

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

版本

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

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