摘要專案記錄 - 大量

發行項
12/21/2023

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

提示

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

注意事項

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

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

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

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

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

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Target Campaign Id,Target Ad Group Id,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 來節省時間來上傳和下載 BulkFeedItem 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkFeedItem
var bulkAdCustomizerFeedItem = new BulkFeedItem
{
	// 'Parent Id' column header in the Bulk file
	FeedId = adCustomizerFeedIdKey,
	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = adCustomizerFeedItemCustomAttributesJson,
	// 'Id' column header in the Bulk file
	Id = null,
	// 'Target Ad Group Id' column header in the Bulk file
	AdGroupId = null,
	// 'Ad Group' column header in the Bulk file
	AdGroupName = null,
	// 'Audience Id' column header in the Bulk file
	AudienceId = null,
	// 'Target Campaign Id' column header in the Bulk file
	CampaignId = null,
	// 'Campaign' column header in the Bulk file
	CampaignName = null,
	// 'Ad Schedule' column header in the Bulk file
	DayTimeRanges = new[]
	{
		// Each day and time range is delimited by a semicolon (;) in the Bulk file
		// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
		new DayTime
		{
			Day = Day.Monday,
			StartHour = 9,
			StartMinute = Minute.Zero,
			EndHour = 21,
			EndMinute = Minute.Zero,
		},
	},
	// 'End Date' column header in the Bulk file
	EndDate = null,
	// 'Start Date' column header in the Bulk file
	StartDate = null,
	// 'Physical Intent' column header in the Bulk file
	IntentOption = IntentOption.PeopleIn,
	// 'Keyword' column header in the Bulk file
	Keyword = "insurance",
	// 'Target' column header in the Bulk file
	LocationId = 190,
	// 'Match Type' column header in the Bulk file
	MatchType = MatchType.Exact,
	// 'Device Preference' column header in the Bulk file
	DevicePreference = null,
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeedItem);

// Map properties in the Bulk file to the BulkFeedItem
var bulkPageFeedItem = new BulkFeedItem
{
    // 'Parent Id' column header in the Bulk file
    FeedId = pageFeedIdKey,
    // 'Custom Attributes' column header in the Bulk file
    CustomAttributes = pageFeedItemCustomAttributesJson,
    // 'Id' column header in the Bulk file
    Id = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkPageFeedItem);

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

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

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

廣告群組
廣告排程
物件識別碼
行銷活動
用戶端識別碼
自訂屬性
裝置喜好設定
結束日期
Id
關鍵字
比對類型
修改時間
父項識別碼
實體意圖
開始日期
狀態
Target
目標廣告群組識別碼
目標行銷活動識別碼

廣告群組

用來以摘要專案為目標的廣告組名。如果已設定此欄位，則摘要專案將僅適用于指定的廣告群組。

注意事項

此欄位僅適用于廣告自訂工具摘要。

添加： 選。如果您包含此欄位，則也必須設定 [ 行銷活動 ] 欄位，且廣告群組必須存在於指定的行銷活動內。如果同時設定 [ 廣告群組 ] 和 [ 目標廣告群組標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。
更新： 選。如果您包含此欄位，則也必須設定 [ 行銷活動 ] 欄位，且廣告群組必須存在於指定的行銷活動內。如果同時設定 [ 廣告群組 ] 和 [ 目標廣告群組標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

廣告排程

您希望摘要專案與廣告一起顯示的日期和時間範圍清單。每一天和時間範圍包括排程的星期幾、開始/結束時間，以及開始/結束分鐘。每一天和時間範圍都會以左括弧和右括弧括住，並以分號 (;) 分隔符號來分隔其他日期和時間範圍。在每天和時間範圍內，格式為 Day[StartHour：StartMinue-EndHour：EndMinute]。

注意事項

此欄位僅適用于廣告自訂工具摘要。

StartHour的可能值範圍從 00 到 23，其中00相當於上午 12：00，而 12則是 12：00PM。

EndHour的可能值範圍從 00 到 24，其中00相當於上午 12：00，而 12 則是 12：00PM。

StartMinute和EndMinute的可能值範圍從 00 到 60。

下列範例示範工作日從上午 9：00 到下午 9：00 的日期和時間範圍： (Monday[09：00-21：00]) ; (Tuesday[09：00-21：00]) ; (Wednesday[09：00-21：00]) ; (Thursday[09：00-21：00]) ; (Friday[09：00-21：00])

添加： 選。如果您未設定此欄位，則摘要專案將有資格在行事曆開始和結束日期期間隨時排程。
更新： 選。如果未設定更新的值，則此設定不會變更。無法更新個別的日期和時間範圍。您可以藉由傳送應該取代先前集合的新集合，有效地更新日期和時間範圍。如果您未設定此欄位，則會保留現有的設定。如果您將此欄位設定 為 [delete_value]，則會有效地移除所有現有的日期和時間範圍。
刪除： 唯讀

物件識別碼

物件的 Microsoft Advertising 識別碼，例如用來以摘要專案為目標的重新行銷清單。如果設定此欄位，摘要專案將僅符合指定物件的資格。

注意事項

此欄位僅適用于廣告自訂工具摘要。

添加： 選。
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

行銷活動

用來以摘要專案為目標的行銷活動名稱。如果設定此欄位，摘要專案將僅符合指定行銷活動的資格。

注意事項

此欄位僅適用于廣告自訂工具摘要。

添加： 選。如果同時設定 [ 行銷活動 ] 和 [ 目標行銷活動標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。
更新： 選。如果同時設定 [ 行銷活動 ] 和 [ 目標行銷活動標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 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"
	}
]

以下是您可以針對廣告自訂工具摘要上傳的範例自訂屬性。

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

添加： 必填。針對廣告自訂者和 DynamicDataAutosListing 摘要專案，您必須設定至少一個具有有效索引鍵和值組的屬性。針對頁面摘要，您必須設定至少一個名稱設定為「Page Url」的屬性。
更新： 選。若要保留摘要專案的所有現有自訂屬性，請設定或保留此欄位空白。如果您設定此欄位，將會取代先前為此摘要專案設定的任何自訂屬性。
刪除： 唯讀

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」名稱上方的廣告自訂工具範例中，會同時用於摘要和摘要專案。

裝置喜好設定

此欄位會決定要在行動裝置或所有裝置上顯示摘要專案的喜好設定。

注意事項

此欄位僅適用于廣告自訂工具摘要。

可能的值為 All 和 Mobile，這與行銷活動管理服務中使用的值不同。

SixMonths

在大量下載和上傳結果檔案中，此欄位永遠不會是空的。如果您未指定裝置喜好設定，則會傳回預設值 All 。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。如果您將此欄位設定 為 delete_value，則實際上會重設為預設值 All。
刪除： 唯讀

結束日期

摘要專案排程結束日期字串格式化為 yyyy/mm/dd HH：mm：ss。若要預設為一天開頭的午夜，您可以省略 HH：mm：ss 部分。

注意事項

此欄位僅適用于廣告自訂工具摘要。

結束日期包含在內。例如，如果您將此欄位設定為 2020/12/31 00：00：00，摘要專案將會在 2020 年 12 月 31 日上午 12：00 停止符合資格。

添加： 選。如果您未指定結束日期，除非您暫停相關聯的活動、廣告群組或廣告，否則摘要專案會繼續傳遞。
更新： 選。如果未設定更新的值，則此設定不會變更。結束日期可以縮短或延長，只要開始日期為 Null 或發生在新的結束日期之前。如果您未設定此欄位，則會保留現有的設定。如果您將此欄位設定 為delete_value，則除非您暫停相關聯的行銷活動、廣告群組或廣告，否則您實際上會移除結束日期，而且摘要專案會繼續傳遞。
刪除： 唯讀

識別碼

系統產生的摘要識別碼。

添加： 唯讀
更新： 唯讀和必要
刪除： 唯讀和必要

關鍵字

關鍵字文字。

文字最多可以包含 100 個字元。

您應該在目標行銷活動或廣告群組的語言地區設定中指定關鍵字。

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

比對類型

要比較關鍵字和使用者搜尋字詞的相符類型。

關鍵字支援的相符類型值為 Broad、 Exact 和 Phrase。

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

修改時間

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

注意事項

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

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

父項識別碼

系統產生的父摘要識別碼。

父摘要的自訂屬性和子類型會決定哪些自訂屬性對此摘要專案有效。目前支援廣告自訂工具摘要和頁面摘要，而且未來可以新增其他摘要類型。

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

實體意圖

判斷人員是否必須實際位於目標位置，才能讓摘要專案符合資格。

根據預設，摘要專案可以向中的人員顯示、搜尋或檢視有關您目標位置的頁面。如果您只想要將摘要專案顯示給實際位於目標位置的人員，請將此欄位設定為 PeopleIn 。

添加： 選。如果您設定此欄位，也必須設定目標位置。
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。如果您將此欄位設定 為 delete_value，則實際上會重設為預設值 PeopleIn。
刪除： 唯讀

開始日期

摘要專案排程的開始日期字串格式化為 yyyy/mm/dd HH：mm：ss。若要預設為一天開頭的午夜，您可以省略 HH：mm：ss 部分。

開始日期包含在內。例如，如果您將此欄位設定為 2020/06/15 00：00：00，摘要專案會在 2020 年 6 月 15 日上午 12：00 開始符合資格。

添加： 選。如果您未指定開始日期，則摘要專案會立即符合排程日期和時間範圍的資格。
更新： 選。如果未設定更新的值，則此設定不會變更。只要結束日期為 Null 或發生在新的開始日期之後，就可以縮短或延長開始日期。如果您未設定此欄位，則會保留現有的設定。如果您將此欄位設定 為 [delete_value]，則您實際上會移除開始日期，而且摘要專案會立即符合在日期和時間範圍內排程的資格。
刪除： 唯讀

狀態

摘要專案的狀態。

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

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

Target (目標)

用來以摘要專案為目標之位置的識別碼。如果設定此欄位，則摘要專案將僅符合指定位置的資格。

如果您只想要以某個位置中的人員為目標，您也必須設定 [ 實體意圖] 字段。

位置識別碼會對應至地理位置檔案的 [ 位置標識 符] 欄位。如需詳細資訊，請參閱地理位置代碼和 GetGeoLocationsFileUrl。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

目標廣告群組識別碼

用來鎖定摘要專案的廣告群組識別碼。如果已設定此欄位，則摘要專案將僅適用于指定的廣告群組。

注意事項

此欄位僅適用于廣告自訂工具摘要。

添加： 選。如果您也 (不需要) 設定 [ 行銷活動 ] 欄位，則廣告群組必須存在於指定的行銷活動內。如果同時設定 [ 廣告群組 ] 和 [ 目標廣告群組標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。
更新： 選。如果您也 (不需要) 設定 [ 行銷活動 ] 欄位，則廣告群組必須存在於指定的行銷活動內。如果同時設定 [ 廣告群組 ] 和 [ 目標廣告群組標識符] 欄位，則會在大量檔案中傳回此記錄的錯誤。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

目標行銷活動識別碼

用來以摘要專案為目標之行銷活動的識別碼。如果設定此欄位，摘要專案將僅符合指定行銷活動的資格。

注意事項

此欄位僅適用于廣告自訂工具摘要。

共用方式為

摘要專案記錄 - 大量

廣告群組

廣告排程

物件識別碼

行銷活動

用戶端識別碼

自訂屬性

feedAttributeType

isPartOfKey

name

裝置喜好設定

結束日期

識別碼

關鍵字

比對類型

修改時間

父項識別碼

實體意圖

開始日期

狀態

Target (目標)

目標廣告群組識別碼

目標行銷活動識別碼

意見反應

其他資源