客戶清單記錄 - 大量
定義可在大量檔案中下載及上傳的客戶清單。
重要事項
您必須先建立一個客戶清單物件，並接受 Microsoft Advertising UI 中的條款及條件，才能透過大量 API 上傳客戶清單數據。 初始客戶清單不需要包含任何客戶數據，但您必須選取 [我接受]。 藉由選取 [我接受]，您 (1) 同意您可以公開對象詳細數據，也就是個人資料，以Microsoft並 (2) 接受客戶比對條款、Microsoft廣告合約和Microsoft廣告原則。 Microsoft會使用您根據 客戶比對條款上傳的數據。
客戶清單是您已編譯以啟用客戶比對的一組客戶聯繫人資訊。 每個清單可以包含多個 Email 專案。
- 在大量上傳檔案中包含 客戶清單 記錄，並將其 [ 動作類型 ] 字段設定為 [新增]、[移除] 或 [取代]。
- 在相同的大量上傳檔案中包含一或多個 客戶清單項目 記錄，並設定 [父標識符]、 [子類型] 和 [ 文字] 字 段。
您可以在相同的大量上傳檔案中新增或更新客戶清單記錄，而不需要任何客戶清單項目記錄;不過，如果沒有隨附的父客戶清單記錄，您就無法上傳任何客戶清單項目記錄。
48 小時後，請檢查 [物件大小] 欄位，例如 [ 物件搜尋大小 ]，以查看我們在 Bing 網络上比對的這些客戶數目。 此時，您的廣告可以開始顯示給這個新的觀眾。
提示
如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 CustomerLists 的 DownloadEntity 值，以下載帳戶中的所有客戶列表記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
下列大量 CSV 範例會新增新的客戶清單。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add
針對 客戶清單 記錄， 大量檔案架構中提供下列屬性欄位。
動作類型
決定是否要新增、移除或取代您包含在相同大量上傳檔案中 的客戶清單項目 記錄。
如果動作類型為 「Add」，服務會嘗試新增您包含在相同大量上傳檔案中 的客戶清單項目 記錄。
如果動作類型設定為 「Remove」，服務會嘗試移除您包含在相同大量上傳檔案中 的客戶清單項目 記錄。
如果動作類型設定為 [取代]，則會移除此列表的所有先前客戶比對數據，而且服務會嘗試新增您包含在相同大量上傳檔案中 的客戶清單項目 記錄。
加： 自選。 根據預設，「新增」動作類型會用於新的客戶清單。 無論您是否設定值，新客戶清單會忽略此欄位。
更新： 如果您也要在相同的大量上傳檔案中包含現有對象 的客戶清單項目 記錄，則為必要項目，否則此欄位是選擇性的。
刪除： 唯讀
對象
客戶清單的名稱。
名稱最多可以包含 128 個字元。
加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀
物件網路大小
在對象網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少物件網路用戶設為目標。
觀眾必須至少有 300 人，Microsoft廣告才會將其用於優化。
加： 唯讀
更新： 唯讀
刪除： 唯讀
物件搜尋大小
在搜尋網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少搜尋用戶設為目標。
觀眾必須至少有 300 人，Microsoft廣告才會將其用於優化。
此屬性在建立物件時最多會是空的 24 小時，例如，如果您新增或更新客戶清單成員資格持續時間、規則或標籤標識碼。
如果與客戶清單相關聯的 UET 標籤的狀態為 [未驗證] 或 [非使用中]，則此屬性會是空的，因為客戶清單無法從您的網站接收到需要建置清單的客戶資訊。
加： 唯讀
更新： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
加： 自選
更新： 自選
刪除： 唯讀
描述
客戶清單的描述。 使用描述來協助您記住此客戶清單的目標物件。
描述最多可以包含 1,024 個字元。
加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀
識別碼
系統產生的客戶清單標識碼。
加： 自選。 您必須將此欄位保留空白，或指定負識別碼。 接著，您可以在相依記錄類型的 [ 父 標識符] 字段中參考客戶清單的負標識元集，例如 客戶清單專案。 如果您要在相同的大量檔案中新增新的客戶清單和新的客戶清單專案，則需要這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 唯讀
更新： 唯讀
刪除： 唯讀
成員資格持續時間
當您建立客戶清單時，您可以指定使用者停留在該區段的時間長度。
最小持續時間為1天。 注意： 如果使用者有180天沒有活動，則會從所有區段中移除。
如果成員資格持續時間為 「-1」 則不會到期。
如果成員資格持續時間為 null，則會使用預設持續時間 (30 天) 。
加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀
父項識別碼
包含客戶清單之客戶的 Microsoft Advertising 識別碼。
加： 自選
更新： 唯讀。 您無法變更父識別碼。
刪除： 唯讀
範圍
範圍會定義哪些帳戶可以使用此客戶清單。 針對客戶清單，唯一支援的範圍是 客戶，而客戶清單可以與所有客戶帳戶上的任何行銷活動和廣告群組相關聯。
加： 必填
更新： 唯讀。 您無法變更範圍。
刪除： 唯讀
狀態
客戶清單狀態。
可能的值為 [作用中 ] 或 [已刪除]。
加： 自選。 預設值為 Active。
更新： 唯讀
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。
支援的營銷活動類型
支援此客戶清單之營銷活動類型的分號分隔清單。
支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。 未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。
加： 唯讀
更新： 唯讀
刪除： 唯讀