合併的清單記錄 - 大量
定義可在大量檔案中下載和上傳的合併清單。
合併清單是從多個現有物件組合建立的物件。
提示
如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 CombinedLists 的 DownloadEntity 值，以下載帳戶中的所有合併清單記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
下列大量 CSV 範例會新增合併清單。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)
如果您使用適用於 .NET、Java 或 Python 的 Bing 廣告 SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkCombinedList 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CombinedList object of the Campaign Management service.
CombinedList = new CombinedList
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "New Combined List",
// 'Id' column header in the Bulk file
Id = combinedListIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "Combined List " + DateTime.UtcNow,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Combination Rule' column header in the Bulk file
CombinationRules = new[]
{
// Each rule is delimited by a semicolon (;) in the Bulk file
new CombinationRule
{
AudienceIds = new [] { 123, 234 },
Operator = LogicalOperator.And
},
new CombinationRule
{
AudienceIds = new [] { 345, 456 },
Operator = LogicalOperator.And
},
},
// 'Scope' column header in the Bulk file
Scope = EntityScope.Account,
// 'Audience Search Size' column header in the Bulk file
SearchSize = null,
// 'Supported Campaign Types' column header in the Bulk file
SupportedCampaignTypes = null,
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCombinedList);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 合併清單 記錄， 大量檔案架構中提供下列屬性欄位。
對象
合併清單的名稱。
名稱最多可以包含 128 個字元。
添加： 必填
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀
物件網路大小
在對象網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少物件網路用戶設為目標。
對象必須至少有 300 人，Microsoft Advertising 才會將它用於優化。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
物件搜尋大小
在搜尋網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少搜尋用戶設為目標。
對象必須至少有 300 人，Microsoft Advertising 才會將它用於優化。
此屬性在建立物件時最多會是空的 24 小時，例如，如果您新增或更新合併的清單成員資格持續時間、規則或標籤標識碼。
如果與合併清單相關聯的 UET 標籤的狀態為 [未驗證] 或 [非使用中]，則此屬性會是空的，因為合併的清單無法從您的網站接收到需要建置清單的客戶資訊。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
添加： 選
更新： 選
刪除： 唯讀
組合規則
組合規則包含用來判斷要將誰新增至合併清單的條件。
您可以結合自定義物件、客戶清單、產品物件、類似的物件，以及重新營銷清單。 您不能在合併清單中包含其他合併清單或市場內物件。
每個廣告帳戶最多可以建立1,000個合併清單，每個客戶最多可以建立5,000個清單。 每個清單的組合規則最多可以包含100組邏輯條件，而且每個集合最多可以包含100個物件識別碼。
透過以下所述的一些限制，您可以使用下列邏輯運算符來結合物件：
- 或者：這會包含任何這些物件清單中的客戶。
- AND：這隻會包含每一個物件清單中的客戶。
- NOT：這會排除任何這些物件清單中的客戶。
邏輯條件集是指 OR、AND 或 NOT 所限定的一組對象識別碼。 在大量 API 中，每個集合都是以連字元分隔 ( & ) 。
例如，以下是一個組合規則的10個集合。 每一個對象標識碼： NOT (1) &AND (2) &或 (3) &NOT (4) &AND (5) #B 4 OR (6) &NOT (7) &AND (8) &OR (9) &NOT (10)
以下是一個組合規則的 10 個集合範例： 各有兩個對象標識碼： NOT (1,101) &AND (2,102) &OR (3,103) &NOT (4,104) &AND (5,105) #B 4 OR (6,106) &NOT (7,107) &AND (8,108) &OR (9,109) &不 (10,110)
邏輯表達式的評估會決定要將誰新增至合併清單。 多個組合一律會與 AND 函式結合。 這表示客戶必須符合每個組合的所有準則，才能出現在這個自定義組合物件清單中。 例如， 假設組合規則設定為 NOT (123,234) &NOT (345,456) &AND (567,678) &或 (789,890) &或 (987,876) 。 合併的清單將包含) 物件為 567 和 678 的客戶，而 b) 位於 789 或 890 物件中，而 c) 則位於物件 987 或 876 中，除非 d) 客戶位於物件 123、234、345 或 456。
合併的清單必須至少包含一個使用 OR 或 AND 運算符的物件。 合併的清單不能只使用 NOT 運算子。 在此情況下，您應該改用物件排除專案。
自定義物件和客戶清單無法與其他物件類型結合。
類似的對象無法透過 AND 或 NOT 運算子結合。 類似的物件只能在單一 OR 條件中使用。 換句話說，只能有一個物件集包含類似的物件，而且該集合必須使用 OR 運算元。
雖然無法透過 AND 和 NOT 運算符來合併相同的物件識別碼，但允許重複的物件。
如果您要在相同的大量上傳中與此合併清單一起建立新的對象，組合規則可以包含負標識元，其等於其他新物件的 [標識 符] 字段。 例如，如果您要建立新的 重新行銷清單 ，而且也想要將它包含在合併清單中，您可以將重新行銷清單的 標識 碼值設定為 -1。 在相同的大量上傳中，您可以在組合規則中使用 -1 參考新的重新營銷清單，例如 NOT (123,234) &AND (345,456) &或 (-1,678) 。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
如果您要在相同的大量上傳中與此合併清單一起建立新的對象，組合規則可以包含其他新物件之負 標識 符字段的負參考索引鍵。 您也可以使用邏輯參考索引鍵，將 物件 (名稱) 其他新物件的欄位。
- 作為使用負數參考索引鍵的範例，在相同的大量上傳中，包含新的 重新行銷清單 ，其中的 標識 碼設定為 -1。 然後在組合規則中使用 -1 參考新的重新行銷清單，例如 NOT (123,234) &AND (345,456) &OR (-1,678) 。
- 作為使用邏輯參考索引鍵的範例，在相同的大量上傳中，會包含新的 重新行銷清單 ，其中的 [物件 名稱] 會設定為 [我的新物件]。 然後在組合規則中，使用單引號) 括住的 「我的物件」 (參照新的重新營銷清單，例如 NOT (123,234) &AND (345,456) &OR ('My New Audience'，678) 。
如需詳細資訊，請 參閱大量檔案架構參考密鑰。
添加： 必填
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀
描述
合併清單的描述。 使用描述來協助您記住您以此合併清單為目標的物件。
描述最多可以包含 1,024 個字元。
添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀
Id
系統產生的合併清單標識碼。
添加： 唯讀
更新： 唯讀和必要
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
父項識別碼
系統產生的帳戶或客戶標識碼。 如果 [範圍] 設定為 [ 帳戶]，則這是帳戶標識符，否則為客戶標識符。
添加： 選
更新： 唯讀。 您無法變更父識別碼。
刪除： 唯讀
範圍
範圍會定義哪些帳戶可以使用此合併清單。 如果範圍設定為 [帳戶]，則合併的清單只能與一個指定帳戶內的活動和廣告群組相關聯 (父標識 子) 。 如果範圍設定為 [客戶]，則合併的清單可以與所有客戶帳戶上的任何行銷活動和廣告群組相關聯。
添加： 必填
更新： 唯讀。 您無法變更範圍。
刪除： 唯讀
狀態
合併的清單狀態。
可能的值為 [作用中 ] 或 [已刪除]。
添加： 選。 預設值為 Active。
更新： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。
支援的營銷活動類型
支援此合併清單之營銷活動類型的分號分隔清單。
支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。 未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。
添加： 唯讀
更新： 唯讀
刪除： 唯讀