市場物件記錄 - 大量
定義可在大量檔案中下載的市場內物件。
注意事項
此功能適用於 AD、AR、AT、AU、AW、BD、BE、BG、BN、BO、 BR、BS、CA、CH、CL、CO、CR、CY、CZ、DE、DK、DM、DO、EC、EE、ES、FI、FJ、FR、GF、GR、GT、GU、GY、HN、HR、HT、胡、ID、IE、IN、IT、KY、LI、LK、LT、LU、LV、MC、MN、MQ、 MS、MT、MV、MX、MY、NC、NL、NO、NP、NZ、PA、PE、PF、PG、PH、PL、PR、PT、PY、RO、SE、SG、SI、SK、SM、SV、TH、TT、UK、US、UY、VA、VE 和 VN。
注意事項
不支援大量上傳。 您無法使用 Bing 廣告 API 來新增、更新或刪除市場內的物件。 說過，您可以新增和刪除市場內對象關聯和排除專案。
Bing 廣告 API 一律會傳回所有目前作用中的市集物件。 此服務不會傳回已刪除的市場物件，也不會傳回任何差異下載，以查看變更的內容。
透過 Bing 廣告 API 傳回的市場內物件是所有市場中所有可用物件的聯集，例如 AU、CA、DE、FR、UK 和美國。 [ 物件網络大小 ] 和 [ 物件搜尋大小 ] 是相對應網路中特定市場物件在所有支持市場中的清單大小總和。 Bing 廣告 API 不會提供每個市場清單大小的詳細數據。 例如，搜尋網路中的「廣告與行銷」市場物件大小可能會透過 Bing 廣告 API 傳回為17070879 (1710 萬) 。 Microsoft Advertising Web 應用程式中顯示的每個市場明細可能是：美國 2880 萬;在 AU 中為 474K;英國為 13.7M。
您不應該對沙箱市場對象採取任何相依性。 有些市場內物件可在沙盒中使用，但在生產環境中則無法使用。 沙箱和生產環境之間的市場物件屬性值也可能不同，例如物件名稱和大小。
提示
如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 InMarketAudiences 的 DownloadEntity 值，以下載帳戶中的所有 In Market 對象記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
以下是適用於市場內物件的大量 CSV 範例下載。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
In Market Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,In Market Audience Description,30,Account,In Market Audience,Search;DynamicSearchAds;Shopping;Audience
如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來下載 BulkInMarketAudience 物件來節省時間，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
// Map properties in the Bulk file to the BulkInMarketAudience
var bulkInMarketAudience = new BulkInMarketAudience
{
// Map properties in the Bulk file to the
// InMarketAudience object of the Campaign Management service.
InMarketAudience = new InMarketAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "In Market Audience Description",
// 'Id' column header in the Bulk file
Id = InMarketAudienceIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "In Market Audience",
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// '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
};
針對 「市場中物件 」記錄， 大量檔案架構中提供下列屬性欄位。
對象
市場內對象的名稱。
名稱最多可以包含 128 個字元。
加： 不支援
更新： 不支援
刪除： 不支援
物件網路大小
在對象網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少物件網路用戶設為目標。
加： 不支援
更新： 不支援
刪除： 不支援
物件搜尋大小
在搜尋網路中，屬於此物件之作用中成員的人員總數。 這可讓您瞭解您可以將多少搜尋用戶設為目標。
加： 不支援
更新： 不支援
刪除： 不支援
描述
市場內物件的描述。 使用描述來協助您記住您以此市場內對象為目標的物件。
描述最多可以包含 1,024 個字元。
加： 不支援
更新： 不支援
刪除： 不支援
識別碼
系統產生的市場物件標識碼。
加： 不支援
更新： 不支援
刪除： 不支援
成員資格持續時間
當您在 Microsoft Advertising Web 應用程式中建立市場內物件時，可以指定廣告應該尋找符合您市場中物件定義的動作，以將人員新增至您的清單中的時間Microsoft。
最小持續時間為 1 天，允許的持續時間上限為 180 天。
加： 不支援
更新： 不支援
刪除： 不支援
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 不支援
更新： 不支援
刪除： 不支援
父項識別碼
客戶的Microsoft廣告標識符，其中包含市場內的物件。
加： 不支援
更新： 不支援
刪除： 不支援
範圍
範圍會定義哪些帳戶可以使用此市場內物件。 針對市場內物件，唯一支援的範圍是 客戶，而市場內的物件可以與所有客戶帳戶上的任何行銷活動和廣告群組相關聯。
加： 不支援
更新： 不支援
刪除： 不支援
狀態
市場內對象狀態。
可能的值為 [作用中 ] 或 [已刪除]。
加： 不支援
更新： 不支援
刪除： 不支援
支援的營銷活動類型
支援此市場物件之營銷活動類型的分號分隔清單。
支援的值為 Audience、DynamicSearchAds、Search 和 Shopping。 未來可能會新增新的行銷活動類型，因此您不應該對一組固定的值採取任何相依性。
加： 不支援
更新： 不支援
刪除： 不支援