行銷啟動磁碟區標記錄 - 大量
定義 活動 與卷 標 之間的關聯記錄,可在大量檔案中上傳和下載。 若要上傳或下載行銷活動或標籤,請使用 行銷活動 或 標籤 記錄。
您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含CampaignLabels的DownloadEntity值,以下載帳戶中的所有行銷啟動磁碟區標記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
如果提供有效的 標識 符和 父 識別碼值,下列大量 CSV 範例會將標籤套用至行銷活動。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Campaign Label,,-22,-111,,,ClientIdGoesHere,,,,,
如果您使用適用于 .NET、JAVA 或 Python 的 Bing 廣告 SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkCampaignLabel 物件,而不是直接呼叫服務作業,並撰寫自訂程式碼來剖析大量檔案中的每個欄位。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCampaignLabel
var bulkCampaignLabel = new BulkCampaignLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = campaignIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCampaignLabel);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 行銷啟動磁碟區標 記錄, 大量檔案架構中提供下列屬性欄位。
行銷活動
包含套用或移除此標籤之行銷活動的行銷活動名稱。
添加: 唯讀
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。
添加: 選
刪除: 唯讀
識別碼
從行銷活動套用或移除的標籤識別碼。
這個大量欄位會對應至標籤記錄的 [標識符] 欄位。
添加: 唯讀和必要。 您必須指定現有的標籤識別碼,或指定等於父卷標記錄之 [標識符] 欄位的負識別碼。 如果您要將新標籤套用至相同大量檔案中的行銷活動,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
刪除: 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關資訊,請參閱 基本 XML 資料類型中的 dateTime 專案。
添加: 唯讀
刪除: 唯讀
父項識別碼
套用或移除此標籤之行銷活動的識別碼。
此大量欄位會對應至行銷活動記錄的 [標識符] 欄位。
添加: 唯讀和必要。 您必須指定現有的行銷活動識別碼,或指定等于父活動記錄之 [標識符] 欄位的負識別碼。 如果您要將標籤套用至相同大量檔案中的新活動,則建議使用此選項。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
刪除: 唯讀和必要
狀態
表示行銷活動與標籤之間的套用狀態。
可能的值為 Active 和 Deleted。 如果標籤套用至行銷活動,則此欄位的值為 Active。
添加: 唯讀
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。