注標廣告延伸模組記錄 - 大量
定義可在大量檔案中下載並上傳的注標廣告延伸模組。
您可以將應用程式廣告延伸模組與帳戶建立關聯,或與帳戶中的行銷活動和廣告群組建立關聯。 您必須將每個實體的 2 到 20 個注標廣告延伸模組 (帳戶、行銷活動或廣告群組) 產生關聯。 如果您將一或多個圖說文字延伸模組與您的帳戶、行銷活動或廣告群組建立關聯,則您的廣告將不會提供任何注標文字。 廣告可能包含每一印象 2 到 4 個圖說文字。 使用 帳戶注標廣告延伸模組、 廣告群組注標廣告延伸模組和 行銷活動注標廣告延伸 模組記錄來管理注標廣告延伸模組關聯。
與廣告群組層級相關聯的廣告延伸模組將會覆寫與行銷活動層級相關聯之相同類型的廣告延伸模組。 例如,如果您有 2 個針對 行銷活動 A設定的圖說文字延伸模組、零個與 廣告群組 AA相關聯的圖說文字延伸模組,以及一個與 廣告群組 AB相關聯的注標延伸模組,則只有 廣告群組 AA 才有資格使用圖說文字廣告裝飾其文字廣告。
您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含CalloutAdExtensions的DownloadEntity值,以下載帳戶中的所有注標廣告延伸模組記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
下列大量 CSV 範例會將新的注標廣告延伸模組新增至帳戶的共用程式庫。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Callout Text
Format Version,,,,,,,,,,,6.0,,,
Callout Ad Extension,Active,-13,0,,,ClientIdGoesHere,,,12/31/2020,,,(Monday[09:00-21:00]),FALSE,Callout Text
如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkCalloutAdExtension 物件,而不是直接呼叫服務作業,並撰寫自訂程式碼來剖析大量檔案中的每個欄位。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCallAdExtension
var bulkCalloutAdExtension = new BulkCalloutAdExtension
{
// '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
// CalloutAdExtension object of the Campaign Management service.
CalloutAdExtension = new CalloutAdExtension
{
// 'Id' column header in the Bulk file
Id = calloutAdExtensionIdKey,
// '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,
// 'Callout Text' column header in the Bulk file
Text = "Callout Text",
},
};
uploadEntities.Add(bulkCalloutAdExtension);
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。
刪除: 唯讀
圖說文字
關於您的商務、產品或服務的其他注標文字,要包含在文字廣告中。 注標延伸模組文字必須與您的廣告文字不同。
此字串的長度必須介於 1 到 25 個字元之間。
添加: 必填
更新: 必填
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。
添加: 選
更新: 選
刪除: 唯讀
編輯位置
編輯檢閱失敗的廣告延伸模組元件或屬性。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
編輯原因代碼
識別失敗原因的程式碼。 如需可能的原因代碼清單,請參閱 編輯原因代碼。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
編輯狀態
廣告延伸模組的編輯狀態。
下表說明可能的值。
值 | 描述 |
---|---|
作用中 | 廣告延伸模組已通過編輯檢閱。 |
ActiveLimited | 廣告延伸模組已在一或多個市場中通過編輯檢閱,而廣告延伸模組的一或多個元素正在另一個市場中進行編輯檢閱。 例如,廣告延伸模組已通過加拿大的編輯檢閱,且仍在美國中擱置檢閱。 |
反對 | 廣告延伸模組的編輯檢閱失敗。 |
非作用中 | 廣告延伸模組的一或多個元素正在進行編輯檢閱。 |
添加: 唯讀
更新: 唯讀
刪除: 唯讀
編輯詞彙
失敗的編輯檢閱詞彙。
如果字片語合造成失敗,或失敗是以原則違規為基礎,則不會設定此欄位。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
結束日期
廣告延伸模組排程結束日期字串格式化為 MM/DD/YYYY。
結束日期包含在內。 例如,如果您將此欄位設定為 2020/12/31,則廣告延伸模組將會在 2020 年 12 月 31 日下午 11:59 停止顯示。
添加: 選。 如果您未指定結束日期,除非您暫停相關聯的活動、廣告群組或廣告,否則會繼續傳遞廣告延伸模組。
更新: 選。 結束日期可以縮短或延長,只要開始日期為 Null 或發生在新的結束日期之前。 如果您將此欄位設定為 delete_value 字串,則實際上是移除結束日期。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依,並一起更新。 如果您在更新期間將所有這些欄位保留空白,則不會更新這些欄位。 如果您包含任何這些欄位的值,則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定,請將每個欄位設定 為 delete_value。
刪除: 唯讀
識別碼
系統產生的廣告延伸模組識別碼。
添加: 選。 您必須將此欄位保留空白,或指定負識別碼。 接著可以在相依記錄類型的 [識別碼 ] 欄位 中參考廣告延伸模組的負識別碼集,例如 Ad Group Callout Ad Extension 和 Campaign Callout Ad Extension。 如果您要在相同的大量檔案中新增新的廣告擴充功能和新的相依記錄,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關資訊,請參閱 基本 XML 資料類型中的 dateTime 專案。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
父項識別碼
系統產生的帳戶識別碼,其中包含廣告延伸模組。
此大量欄位會對應至客戶紀錄的 [ 標識 符 ] 字 段。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
發行者國家/地區
發行者國家或地區的清單,其編輯指導方針不允許指定的 詞彙。
在大量檔案中,發行者國家或地區的清單會以分號分隔 (;) 。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
開始日期
廣告延伸模組排程的開始日期字串格式化為 MM/DD/YYYY。
開始日期包含在內。 例如,如果您將開始日期設定為 5/5/2020,則廣告延伸模組會在 2020 年 5 月 5 日上午 12:00 開始顯示。
添加: 選。 如果您未指定開始日期,則廣告擴充功能立即符合 排程的資格。
更新: 選。 只要結束日期為 Null 或發生在新的開始日期之後,就可以縮短或延長開始日期。 如果您將此欄位設定 為delete_value 字串,則實際上會移除開始日期,且廣告延伸模組立即符合 排程的資格。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依,並一起更新。 如果您在更新期間將所有這些欄位保留空白,則不會更新這些欄位。 如果您包含任何這些欄位的值,則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定,請將每個欄位設定 為 delete_value。
刪除: 唯讀
狀態
廣告延伸模組的狀態。
可能的值為 [作用中 ] 或 [已刪除]。
添加: 選。 預設值為 Active。
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。
使用搜尋人員時區
判斷是要使用帳戶時區,還是廣告可傳遞之搜尋使用者的時區。
如果您想要在搜尋使用者的時區中顯示廣告延伸模組,並將此屬性設定為 TRUE ,否則請將它設定為 FALSE。
添加: 選。 如果您未指定此欄位或將其保留空白,則會設定 FALSE 的預設值,並使用帳戶時區。
更新: 選。 如果您將此欄位設定為 delete_value 字串,則實際上會重設為預設值 FALSE。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依,並一起更新。 如果您在更新期間將所有這些欄位保留空白,則不會更新這些欄位。 如果您包含任何這些欄位的值,則會移除或取代所有這些欄位的先前值。 若要移除所有先前的排程設定,請將每個欄位設定 為 delete_value。
刪除: 唯讀
版本
廣告延伸模組內容已更新的次數。 當您新增擴充功能時,版本會設定為 1,而且每次修訂時都會遞增。
添加: 唯讀
更新: 唯讀
刪除: 唯讀