標籤記錄 - 大量
定義可在大量檔案中上傳和下載的標籤。
標籤可讓您根據任何對您很重要的專案,將行銷活動、廣告群組、廣告和關鍵字組織成群組。 然後,您可以篩選並執行標籤上的報表,以取得對您最有意義的資料。
您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含Labels的DownloadEntity值,以下載帳戶中的所有Label記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
下列大量 CSV 範例會新增標籤。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF
如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkLabel 物件,而不是直接呼叫服務作業,並撰寫自訂程式碼來剖析大量檔案中的每個欄位。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkLabel
var bulkLabel = new BulkLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// Label object of the Campaign Management service.
Label = new Label
{
// 'Color' column header in the Bulk file
ColorCode = "#FFFFFF",
// 'Description' column header in the Bulk file
Description = "Label Description",
// 'Id' column header in the Bulk file
Id = labelIdKey,
// 'Label' column header in the Bulk file
Name = "Label Name " + DateTime.UtcNow
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkLabel);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 標籤 記錄, 大量檔案架構中提供下列屬性欄位。
色彩
作為十六進位程式碼的標籤色彩。
十六進位值必須有 '#' 前置詞。 例如,您可以將 #FFFFFF 的值用於白色標籤。
您可以在 Microsoft Advertising Web 應用程式中檢視色彩。 您的應用程式可以顯示色彩,或利用十六進位值來分類一組標籤。
添加: 選。 如果您未指定任何色彩,則會針對每個標籤隨機指派值。
更新: 選。 如果未設定更新的值,則此設定不會變更。 您可以更新色彩代碼,但無法移除它。
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。
添加: 選
更新: 選
刪除: 唯讀
說明
標籤描述。
標籤描述的長度可以介於 1 到 200 個字元之間。
添加: 選
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
識別碼
系統產生的標籤識別碼。
添加: 選。 您必須將此欄位保留空白,或指定負識別碼。 接著,您可以在啟動磁碟區標等相依記錄類型的 [父 識別碼] 欄位中參考卷 標的負識別碼集。 如果您要在相同的大量檔案中新增新的標籤和新的相依記錄,建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
標籤
標籤名稱。
區分大小寫的標籤名稱長度可以介於 1 到 80 個字元之間,而且必須是帳戶中所有標籤的唯一名稱。
添加: 必填
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關資訊,請參閱 基本 XML 資料類型中的 dateTime 專案。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
狀態
標籤的狀態。
可能的值為 [作用中 ] 或 [已刪除]。
添加: 選。 預設值為 Active。
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應