源项记录 - 批量

定义可在批量文件中下载和上传的源项。

提示

有关如何使用源和源项的概述,请参阅 广告定制器源自动库存源页面源 技术指南。

注意

  • 在 2023 年 2 月 1 日之前,将展开的文本广告升级到响应式搜索广告。 在此日期之后,你将无法再创建新的或编辑现有的扩展文本广告。 有关详细信息,请参阅 关于响应式搜索广告
  • 计划的源将继续运行,使用广告定制器源的现有扩展文本广告将继续提供。 你将能够查看其性能报告。
  • 你仍然可以暂停、运行或删除现有的广告定制器源。 否则,尝试为展开的文本广告创建或编辑现有广告定制器将导致 CustomerNotEligibleForAdCustomizersFeed 错误。
  • 详细了解此更改

如果要在同一大容量文件中创建新的父实体和子实体,则必须根据层次结构在依赖项之后包括依赖记录:

  1. 市场活动
  2. 广告组
  3. 源项

每个帐户可以有 100 个源, (此最大数量包括) 的所有源类型,每个帐户) (行的最大源项数为 500 万。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 FeedItemsDownloadEntity 值,可以下载帐户中的所有记录。 此外,下载请求必须包括 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 的必应广告 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” 字段,则会在批量文件中返回此记录的错误。
更新: 选。 如果包含此字段,则还必须设置 “市场活动” 字段,并且广告组必须存在于指定的市场活动中。 如果同时设置了 “广告组 ”和“ 目标广告组 ID” 字段,则会在批量文件中返回此记录的错误。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读

广告计划

要随广告一起显示源项的日期和时间范围列表。 每天和时间范围包括计划的星期几、开始/结束小时和开始/结束分钟。 每天和时间范围都用左括号和右括号括起来,并用分号 (;) 分隔符分隔其他日期和时间范围。 在每天和时间范围内,格式为 Day[StartHour:StartMinue-EndHour:EndMinute]

注意

此字段仅适用于广告定制器源。

StartHour 的可能值范围为 00 到 23,其中 00 相当于 12:00AM,12 等于中午 12:00。

EndHour 的可能值范围为 00 到 24,其中 00 相当于凌晨 12:00,12 等于中午 12:00。

StartMinuteEndMinute 的可能值范围为 00 到 60。

以下示例演示工作日从上午 9:00 到晚上 9:00 的日期和时间范围: (Monday[09:00-21:00]) ; (Tuesday[09:00-21:00]) ; (星期三[09:00-21:00]) ; (星期四[09:00-21:00]) ; (星期五[09:00-21:00])

添加: 选。 如果未设置此字段,则源项将有资格在日历开始和结束日期期间随时进行计划。
更新: 选。 如果未为更新设置任何值,则不会更改此设置。 无法更新单个日期和时间范围。 可以通过发送应替换上一组的新集来有效地更新日期和时间范围。 如果未设置此字段,则会保留现有设置。 如果将此字段设置为 delete_value,则实际上会删除所有现有的日期和时间范围。
删除: 只读

访问群体 ID

受众的 Microsoft Advertising 标识符,例如用于定位源项的再营销列表。 如果设置了此字段,则源项将仅符合指定受众的条件。

注意

此字段仅适用于广告定制器源。

添加: 选。
更新: 选。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读

Campaign

用于定位源项的活动的名称。 如果设置了此字段,则源项将仅符合指定的市场活动的条件。

注意

此字段仅适用于广告定制器源。

添加: 选。 如果同时设置了 “市场活动” 和“ 目标市场活动 ID” 字段,则会在批量文件中返回此记录的错误。
更新: 选。 如果同时设置了 “市场活动” 和“ 目标市场活动 ID” 字段,则会在批量文件中返回此记录的错误。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。

添加:
更新:
删除: 只读

自定义属性

属性针对每个源 子类型进行自定义,并定义要插入广告中的产品或服务的相关信息。

对于 AdCustomizerFeed子类型,每个源项最多可以包含 100 个自定义属性,其中每个自定义属性 名称 都是唯一的。

对于 DynamicDataAutosListingFeed 子类型,每个源项最多可以包含 100 个自定义属性,其中每个自定义属性 名称 都是唯一的。

对于 PageFeed子类型,可以为每个源项包含一个或两个自定义属性,其中每个自定义属性 名称 都是唯一的。

自定义属性在批量文件中以 JSON 字符串的形式表示。 有关详细信息,请参阅 feedAttributeTypeisPartOfKey 和下面的 名称

下面是可以为页面源上传的示例自定义属性。

注意

在逗号分隔的大容量文件中,需要用一组额外的双引号将属性、每个属性键和每个属性值括起来, 上述 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 源项,必须至少设置一个具有有效键值对的属性。 对于页面源,必须至少设置一个 名称 设置为“页面 URL”的属性。
更新: 选。 若要保留源项的所有现有自定义属性,请设置或保留此字段为空。 如果设置此字段,将替换以前为此源项设置的任何自定义属性。
删除: 只读

feedAttributeType

每个自定义属性的数据类型。 在源记录中定义数据类型,然后在源项中设置值。 只要每个自定义属性 名称 在源中是唯一的,就可以定义具有相同数据类型的多个属性。

可以为广告定制器源设置四种不同的 feedAttributeType 数据类型:

feedAttributeType 用例 接受的源项值
String 产品名称、产品类别、说明 任何字母、数字或符号
Int64 库存计数,可用颜色数 任何整数
价格 产品成本,销售折扣 任何数字 (包括小数) 和有效货币字符
日期时间 活动开始时间,销售的最后一天 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 用例 接受的源项值
String 车辆名称、车辆类别、说明 任何字母、数字或符号
Int64 车辆年份,引擎 任何整数
价格 车辆成本、销售折扣 任何数字 (包括小数) 和有效货币字符
日期时间 活动开始时间,销售的最后一天 yyyy/mm/dd HH:mm:ss
若要在一天开始时默认为午夜,可以省略 HH:mm:ss 部分。
URL 包含要包含在源中的网站的 URL。 必须为每个 源项包含一个 URL。
StringList 允许对源中的 URL 进行分组的标签。 每个 源项可以包含 1 到 10 个自定义标签。
每个自定义标签都以 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 用例 接受的源项值
String 显示的静态标题,而不是动态生成的标题。 任何最多 63 个字符的字母、数字或符号。 每个源项可以包含一个广告标题。
StringList 允许对源中的 URL 进行分组的标签。 每个 源项可以包含 1 到 10 个自定义标签。
每个自定义标签都以 JSON 表示法表示为列表项。 例如, 源项 的自定义标签部分可以编写为 “”自定义标签“”:[“”Label_1_3001“”,“”Label_2_3001“]]
URL 包含要包含在源中的网站的 URL。 必须为每个 源项包含一个 URL。

例如,我们可以定义页面源的自定义属性。

注意

对于页面源,是 feedAttributeType 可选的。 如果设置 feedAttributeType,则必须将“页面 Url”设置为“Url”,将“StringList”设置为“自定义标签”,并将“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”,则值必须是唯一的,否则可以为同一自定义属性上传重复值。

对于广告定制器源和源项,名为“自定义 ID”的字符串始终被视为唯一键, isPartOfKey 即 始终为“true”。 “自定义 ID”属性是目前通过 Microsoft Advertising Web 应用程序为广告定制器源设置唯一键的唯一方法。 使用批量 API 可以更灵活地使用任何属性名称作为唯一键。

对于页面源和源项,“页面 Url”始终被视为唯一键, isPartOfKey 即 始终为“true”。

对于 DynamicDataAutosListing 源和源项,“VehicleId”始终被视为唯一键, isPartOfKey 即 始终为“true”。

name

属性 name 用于跨 源和源 项映射不同的自定义属性。 实际上,这是确保特定源项汇总到源中的同一“列”的方式。 在广告定制器示例中,源和源项都使用了“DateTimeName”、“Int64Name”、“PriceName”和“StringName”名称。

设备首选项

此字段确定首选项是在移动设备还是所有设备上显示源项。

注意

此字段仅适用于广告定制器源。

可能的值为 AllMobile,这与市场活动管理服务中使用的值不同。

SixMonths

在批量下载和上传结果文件中,此字段永远不会为空。 如果未指定设备首选项,将返回默认值 All

添加:
更新: 选。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。 如果将此字段设置为 delete_value,则实际上会重置为默认值 All
删除: 只读

End Date

源项计划的结束日期字符串格式为 yyyy/mm/dd HH:mm:ss。 若要在一天开始时默认为午夜,可以省略 HH:mm:ss 部分。

注意

此字段仅适用于广告定制器源。

结束日期是包含的。 例如,如果将此字段设置为 2020/12/31 00:00:00,则源项将在 2020 年 12 月 31 日上午 12:00 停止符合条件。

添加: 选。 如果未指定结束日期,除非暂停关联的市场活动、广告组或广告,否则源项将继续交付。
更新: 选。 如果未为更新设置任何值,则不会更改此设置。 只要开始日期为 null 或出现在新的结束日期之前,就可以缩短或延长结束日期。 如果未设置此字段,则会保留现有设置。 如果将此字段设置为 delete_value,则实际上会删除结束日期,并且源项将继续交付,除非暂停关联的市场活动、广告组或广告。
删除: 只读

Id

源的系统生成的标识符。

添加: 只读
更新: 只读和必需
删除: 只读和必需

关键字

关键字 (keyword) 文本。

文本最多可以包含 100 个字符。

应在目标市场活动或广告组的语言区域设置中指定关键字 (keyword) 。

添加: 必填
更新: 只读
删除: 只读

匹配类型

要比较关键字 (keyword) 和用户的搜索词的匹配类型。

关键字 (keyword) 支持的匹配类型值为 BroadExactPhrase

添加: 必填
更新: 只读
删除: 只读

修改时间

上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间,而不是客户端。 有关日期和时间格式的信息,请参阅 基元 XML 数据类型中的 dateTime 条目。

添加: 只读
更新: 只读
删除: 只读

父 ID

的系统生成的标识符。

父源的 自定义属性子类型 确定哪些 自定义属性 对此源项有效。 目前支持广告定制器源和页面源,将来可能会添加其他源类型。

添加: 只读
更新: 只读
删除: 只读

物理意向

确定用户是否必须实际位于目标位置,才能使源项符合条件。

默认情况下,可以向用户显示源项、搜索或查看有关目标位置的页面。 如果仅希望将源项显示给实际位于目标位置的人员,请将此字段设置为 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,则实际上删除了开始日期,并且源项将立即有资格在日期和时间范围内进行计划。
删除: 只读

状态

源项的状态。

可能的值为 ActiveDeleted

添加: 选。 默认值为 Active
更新: 选。 如果未为更新设置任何值,则不会更改此设置。
删除: 必填。 “状态”必须设置为 “已删除”。

Target

用于定位源项的位置的标识符。 如果设置了此字段,则源项将仅符合指定位置的条件。

如果希望仅面向某个位置中的实际人员,则还需要设置 “物理意向” 字段。

位置标识符对应于地理位置文件的“ 位置 ID ”字段。 有关详细信息,请参阅 地理位置代码GetGeoLocationsFileUrl

添加:
更新: 选。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读

目标广告组 ID

用于定位源项的广告组的标识符。 如果设置了此字段,则源项将仅符合指定广告组的条件。

注意

此字段仅适用于广告定制器源。

添加: 选。 如果还设置了“ 市场活动” 字段 (不需要) ,则该广告组必须存在于指定的市场活动中。 如果同时设置了 “广告组 ”和“ 目标广告组 ID” 字段,则会在批量文件中返回此记录的错误。
更新: 选。 如果还设置了“ 市场活动” 字段 (不需要) ,则该广告组必须存在于指定的市场活动中。 如果同时设置了 “广告组 ”和“ 目标广告组 ID” 字段,则会在批量文件中返回此记录的错误。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读

目标市场活动 ID

用于定位源项的活动的标识符。 如果设置了此字段,则源项将仅符合指定的市场活动的条件。

注意

此字段仅适用于广告定制器源。

添加: 选。 如果同时设置了 “市场活动” 和“ 目标市场活动 ID” 字段,则会在批量文件中返回此记录的错误。
更新: 选。 如果同时设置了 “市场活动” 和“ 目标市场活动 ID” 字段,则会在批量文件中返回此记录的错误。 如果未为更新设置任何值,则不会更改此设置。 如果将此字段设置为 delete_value 字符串,则会删除以前的设置。
删除: 只读