摘要記錄 - 大量

發行項
12/21/2023

定義可在大量檔案中下載及上傳的摘要。

提示

如需如何使用摘要和摘要專案的概觀，請參閱廣告自訂工具摘要、自動清查摘要和頁面摘要技術指南。

注意事項

在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。如需詳細資訊，請參閱關於回應式搜尋廣告。
您的排程摘要將會繼續執行，而使用廣告自訂工具摘要的現有擴充文字廣告將會繼續提供。您將能夠檢視報告的效能。
您仍然可以暫停、執行或移除現有的廣告自訂工具摘要。否則，嘗試為展開的文字廣告建立或編輯現有的廣告自訂工具將會產生 CustomerNotEligibleForAdCustomizersFeed 錯誤。
深入瞭解這項變更。

如果您要在相同的大量檔案中建立新的父系和子實體，則相依記錄必須包含在根據階層的相依性之後：

每個帳戶可以有 100 個摘要 (此最大數目包括所有摘要類型) ，而每個帳戶 (資料列) 的最大摘要專案數目為 500 萬。

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含Feeds的DownloadEntity值，以下載帳戶中的所有摘要記錄。此外，下載要求必須包含 EntityData 範圍。如需大量服務的詳細資訊，包括最佳做法，請參閱大量下載和上傳。

下列大量 CSV 範例會新增新的頁面摘要、自動清查和廣告自訂工具摘要，每個摘要專案各有一個摘要專案。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Keyword,Match Type,Target,Physical Intent,Name,Ad Schedule,Audience Id,Feed Name,Custom Attributes
Format Version,,,,,,,,,,,,,,,,6,,,,
Feed,Active,-20,,PageFeed,,,PageFeedClientIdGoesHere,,,,,,,,,,,,MyPageFeedName,"[{""name"":""Page Url"",""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name"":""Custom Label"",""feedAttributeType"":""StringList""},{""name"":""Ad Title"",""feedAttributeType"":""String""}]"
Feed,Active,-21,,AdCustomizerFeed,,,AdCustomizerFeedClientIdGoesHere,,,,,,,,,,,,MyAdCustomizerFeedName,"[{""name"":""DateTimeName"",""feedAttributeType"":""DateTime""},{""name"":""Int64Name"",""feedAttributeType"":""Int64""},{""name"":""PriceName"",""feedAttributeType"":""Price""},{""name"":""StringName"",""feedAttributeType"":""String"",""isPartOfKey"":true}]"
Feed,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,-21,,DynamicDataAutosListingFeed,,"[{""name"":""Vehicle ID""},{""name"":""Final URL""},{""name"":""Image URL""},{""name"":""Make""},{""name"":""Model""},{""name"":""Price""},{""name"":""Title""},{""name"":""Target campaign""},{""name"":""Target ad group""},{""name"":""Latitude""},{""name"":""Longitude""},{""name"":""Mileage value""},{""name"":""Mileage unit""},{""name"":""Year""},{""name"":""Fuel type""},{""name"":""Transmission""},{""name"":""City""},{""name"":""VIN""},{""name"":""State of vehicle""}]"
Feed Item,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,,-21,,,"{""Vehicle Id"":""2g161290-1d13"",""""Final Url"""":""https:\/\/www.contoso.com\/used-Redmond1"",""Image Urls"":""https:\/\/www.contoso.com\/inventoryphotos\/01.jpg;https:\/\/www.contoso.com\/inventoryphotos\/02.jpg"",""Make"":""Contoso"",""Model"":""SUV"",""Price"":""65495.00 USD"",""Title"":""2020 SUV"",""Target campaign"":""CampaignName"",""Target ad group"":"""",""Latitude"":"""",""Logitude"":"""",""Mileage Value"":""13000"",""Mileage Unit"":""MI"",""Year"":""2020"",""Fuel Type"":"""",""Transmission"":"""",""City"":""Redmond"",""Vin"":""SALLJGML8HA004044"",""State of Vehicle"":""USED"",""Trim"":""HSE""}"
Feed Item,Active,-200,-20,,,,20;200,,2020/06/22 00:00:00,2020/06/30 00:00:00,,,,,,,,,,"{""Page Url"":""https://contoso.com/3001"",""Custom Label"":[""Label_1_3001"",""Label_2_3001""],""Ad Title"":""An ad title""}"
Feed Item,Active,-210,-21,,,,21;210,,2020/06/22 00:00:00,2020/06/30 00:00:00,,value,Broad,,PeopleIn,,(Sunday[09:00-17:00]),,,"{""DateTimeName"":""2020/06/22 00:00:00"",""Int64Name"":237601,""PriceName"":""$601"",""StringName"":""s237601""}"

如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkFeed 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkFeed
var bulkAdCustomizerFeed = new BulkFeed
{
    // 'Parent Id' column header in the Bulk file
	AccountId = 0,

	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = new[]
	{
		// Each FeedCustomAttributeContract is represented as a JSON list item in the Bulk file.
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "DateTime",
			Name = "DateTimeName"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Int64",
			Name = "Int64Name"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Price",
			Name = "PriceName"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "String",
			Name = "StringName",
			IsPartOfKey = true
		}
	},

	// 'Id' column header in the Bulk file
	Id = adCustomizerFeedIdKey,
	// 'Feed Name' column header in the Bulk file
	Name = "My AdCustomizerFeed " + DateTime.UtcNow,
	// 'Sub Type' column header in the Bulk file
	SubType = "AdCustomizerFeed",
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeed);

// Map properties in the Bulk file to the BulkFeed
var bulkPageFeed = new BulkFeed
{
	// 'Parent Id' column header in the Bulk file
	AccountId = 0,

	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = new []
	{
		// Each FeedCustomAttributeContract is represented as a JSON list item in the Bulk file.
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Url",
			Name = "Page Url"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "StringList",
			Name = "Custom Label"
		}
	},
	
	// 'Id' column header in the Bulk file
	Id = pageFeedIdKey,                    
	// 'Feed Name' column header in the Bulk file
	Name = "My PageFeed " + DateTime.UtcNow,
	// 'Sub Type' column header in the Bulk file
	SubType = "PageFeed",
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkPageFeed);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對摘要記錄，大量檔案架構中提供下列屬性欄位。

用戶端識別碼
自訂屬性
摘要名稱
Id
修改時間
父項識別碼
狀態
子類型

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 100 的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

自訂屬性

屬性會針對每個摘要子類型自訂，並定義您想要插入廣告之產品或服務的相關資訊。

針對 AdCustomizerFeed 子類型，每個摘要專案最多可以包含 100 個自訂屬性，其中每個自訂屬性名稱都是唯一的。

針對 DynamicDataAutosListingFeed 子類型，每個摘要專案最多可以包含 100 個自訂屬性，其中每個自訂屬性名稱都是唯一的。

針對 PageFeed 子類型，您可以針對每個摘要專案包含一或兩個自訂屬性，其中每個自訂屬性名稱都是唯一的。

自訂屬性會在大量檔案中以 JSON 字串表示。如需詳細資訊，請參閱 feedAttributeType、 isPartOfKey和下面的名稱。

以下是您可以針對頁面摘要上傳的範例自訂屬性。

注意事項

在逗號分隔的大量檔案中，您必須用一組額外的雙引號括住屬性清單、每個屬性索引鍵和每個屬性值，例如上述 JSON 字串會寫成「[{」「name」「：」「Page Url」「，」「feedAttributeType」「：」「Url」「，」「isPartOfKey」「：true}，{」「name」「」：「」自訂標籤「」，「」feedAttributeType「」：「」StringList「」}，{「」name「」：「」Ad Title「」「，」「feedAttributeType」「：」「String」「}]」。

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

添加： 必填。針對廣告自訂工具和 DynamicDataAutosListing 摘要，您必須設定至少一個具有 name 和 feedAttributeType 索引鍵的屬性。針對頁面摘要，您必須設定至少一個名稱設定為「Page Url」的屬性。只接受feedAttributeType和isPartOfKey機碼的名稱。
更新： 選。建立摘要之後，您就無法移除自訂屬性。您可以藉由只上傳新的屬性來新增新的自訂屬性，也就是不要將現有的屬性包含在新屬性中。如果您在現有屬性中包含新屬性，則會傳回錯誤。如果您將此欄位保留空白，或上傳現有屬性的確切複本，但不進行任何修改，則不會進行任何變更。
刪除： 唯讀

feedAttributeType

每個自訂屬性的資料類型。您可以在摘要記錄中定義資料類型，然後在摘要專案中設定值。只要每個自訂屬性名稱在摘要內都是唯一的，您就可以定義具有相同資料類型的多個屬性。

您可以為廣告自訂工具摘要設定四種不同的 feedAttributeType 資料類型：

feedAttributeType	使用案例	接受的摘要專案值
字串	產品名稱、產品類別、描述	任何字母、數位或符號
Int64	清查計數，可用的色彩數目	任何整數
Price	產品成本、銷售折扣	任何數位 (包括小數) 和有效貨幣字元
日期時間	活動開始時間、銷售的最後一天	yyyy/mm/dd HH：mm：ss 若要預設為一天開頭的午夜，您可以省略 HH：mm：ss 部分。

例如，我們可以定義廣告自訂工具摘要的自訂屬性。

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	}
]

然後，我們可以在摘要專案上傳中對應每個摘要名稱，例如「DateTimeName」、「Int64Name」、「PriceName」和「StringName」：

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

您可以為 DynamicDataAutosListing 摘要設定六種不同的 feedAttributeType 資料類型：

feedAttributeType	使用案例	接受的摘要專案值
字串	車輛名稱、車輛類別、描述	任何字母、數位或符號
Int64	車輛年份，引擎	任何整數
Price	車輛成本、銷售折扣	任何數位 (包括小數) 和有效貨幣字元
日期時間	活動開始時間、銷售的最後一天	yyyy/mm/dd HH：mm：ss 若要預設為一天開頭的午夜，您可以省略 HH：mm：ss 部分。
URL	包含要包含在摘要中的網站 URL。	每個摘要專案必須包含一個 URL。
StringList	可讓您將摘要內的 URL 分組的標籤。	每個摘要專案可以包含一到十個自訂標籤。每個自訂標籤都會以 JSON 標記法標記法表示為清單專案。例如，摘要專案的自訂標籤部分可以寫成「」自訂標籤「」：[「」Label_1_3001「，」「Label_2_3001」]

例如，我們可以定義 DynamicDataAutosListing 摘要的自訂屬性。

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	},
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	}
]

然後，我們可以在摘要專案上傳中對應每個摘要名稱，例如「DateTimeName」、「Int64Name」、「PriceName」和「StringName」：

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601",
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
}

以下是 feedAttributeType 您可以為頁面摘要設定的資料類型：

feedAttributeType	使用案例	接受的摘要專案值
字串	顯示的靜態標題，而不是動態產生的標題。	任何字母、數位或符號最多 63 個字元。您可以為每個摘要專案包含一個廣告標題。
StringList	可讓您將摘要內的 URL 分組的標籤。	每個摘要專案可以包含一到十個自訂標籤。每個自訂標籤都會以 JSON 標記法標記法表示為清單專案。例如，摘要專案的自訂標籤部分可以寫成「」自訂標籤「」：[「」Label_1_3001「，」「Label_2_3001」]
URL	包含要包含在摘要中的網站 URL。	每個摘要專案必須包含一個 URL。

例如，我們可以定義頁面摘要的自訂屬性。

注意事項

對於 feedAttributeType 頁面摘要而言是選擇性的。如果您設定 feedAttributeType ，則必須將「Page Url」、「Custom Label」的「StringList」設定為「Url」，而「Ad Title」具名屬性必須設定為「String」。

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

然後，我們可以在摘要專案上傳中對應每個摘要名稱，例如「頁面 Url」、「自訂標籤」和「廣告標題」：

{
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
    "Ad Title": "Find New Customers & Increase Sales!",
}

isPartOfKey

會 isPartOfKey 決定自訂屬性的值在匯總至摘要的所有摘要專案記錄中是否必須是唯一的。 isPartOfKey如果設定為「true」，則值必須是唯一的，否則您可以上傳相同自訂屬性的重複值。

針對廣告自訂工具摘要和摘要專案，名為「自訂識別碼」的字串一律視為唯一索引鍵， isPartOfKey 也就是一律為「true」。「自訂識別碼」屬性是目前透過 Microsoft Advertising Web 應用程式為廣告自訂工具摘要設定唯一索引鍵的唯一方式。使用大量 API，您可以更有彈性地使用任何屬性名稱作為唯一索引鍵。

對於頁面摘要和摘要專案，一律會將「Page Url」視為唯一索引鍵， isPartOfKey 也就是一律為「true」。

對於 DynamicDataAutosListing 摘要和摘要專案，一律會將「VehicleId」視為唯一索引鍵， isPartOfKey 也就是一律為「true」。

name

屬性 name 可用來對應摘要和摘要專案之間的不同自訂屬性。實際上，這是您確保特定摘要專案匯總到摘要中相同「資料行」的方式。在上述的廣告自訂工具範例中，摘要和摘要專案中都會使用「DateTimeName」、「Int64Name」、「PriceName」和「StringName」名稱。

摘要名稱

摘要的名稱。

名稱必須是唯一 (帳戶內所有摘要之間的不區分大小寫) 。名稱最多可以包含 128 個字元。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

識別碼

系統產生的摘要識別碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。然後，在摘要專案等相依記錄類型的 [標識符] 欄位中，可以參考摘要的負識別碼集。如果您要在相同的大量檔案中新增摘要和摘要專案，建議使用此方法。如需詳細資訊，請參閱大量檔案架構參考金鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

修改時間

上次更新實體的日期和時間。值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關資訊，請參閱基本 XML 資料類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

父項識別碼

系統產生的帳戶識別碼，其中包含摘要。

此大量欄位會對應至客戶紀錄的 [ 標識符 ] 字段。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

狀態

摘要的狀態。

可能的值為 [作用中 ] 或 [已刪除]。

添加： 選。預設值為 Active。
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

子類型

為了方便閱讀，摘要子類型包含在大量下載檔案中。

可能的值為：

PageFeed
AdCustomizerFeed
DynamicDataToursAndActivitiesFeed
DynamicDataCreditCardsFeed
DynamicDataCruisesFeed
DynamicDataHealthInsuranceFeed
DynamicDataProfessionalServiceFeed
DynamicDataMortgageLendersFeed
DynamicDataEventsFeed
DynamicDataHotelsAndVacationRentalsFeed
DynamicDataCustomFeed
DynamicDataAutosListingFeed

未來可能會支援新的值，因此您不能相依于一組固定的值。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

共用方式為

摘要記錄 - 大量

用戶端識別碼

自訂屬性

feedAttributeType

isPartOfKey

name

摘要名稱

識別碼

修改時間

父項識別碼

狀態

子類型

意見反應

其他資源