市场活动半径条件记录 - 批量
定义可在批量文件中上传和下载的市场活动半径条件。
使用半径条件，可以选择在邮政编码、坐标、地标或区域周围指定半径的页面中向潜在客户显示广告、搜索或查看页面。
每个半径条件都为随附的条件出价调整定义了半径、纬度和经度。
可为每个市场活动或广告组指定的最大半径条件数为 2,000。
注意
每个市场活动只能有一个 市场活动位置意向标准 记录，以确定适用于市场活动的所有 市场活动位置条件 和 市场活动半径条件 记录的位置意向选项。 创建市场活动的第一个条件时，还会自动添加 市场活动位置意向条件 记录，并将默认 目标 设置为 PeopleInOrSearchingForOrViewingPages。 无论市场活动是否具有任何其他条件，都可以添加或更新市场 活动的位置意向标准。 虽然没有位置或半径条件，但无法删除市场 活动的市场活动位置意向标准。
如果指定了广告组级别半径条件，则忽略该广告组的市场活动级别半径条件。 换句话说，广告组半径条件会覆盖市场活动半径条件，并且不作为联合应用。
另请注意，必须将位置、负位置和半径条件视为一组 地理条件。 如果广告组具有任何地理条件，则不会继承任何市场活动的地理条件。 如果广告组没有任何地理条件，则会继承市场活动的所有地理位置条件。 即使广告组具有位置意向条件，也可以从市场活动继承地理条件。 如果使用广告组的地理条件，则使用广告组的位置意向条件;如果继承了市场活动的地理位置条件，则使用市场活动的位置意向条件，并忽略广告组的位置意向条件。 不能删除市场活动或广告组的位置意向条件，尽管没有位置或半径条件，它没有任何目的。
提示
有关如何使用目标条件的概述，请参阅 向目标受众显示广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignTargetCriterions 的 DownloadEntity 值，可以下载帐户中的所有市场活动 Radius Criterion 记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
如果提供了有效的 父 ID 值，下面的批量 CSV 示例将添加新的市场活动半径条件。
Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkCampaignRadiusCriterion 对象，而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
// 'Campaign' column header in the Bulk file is read-only
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// BiddableCampaignCriterion object of the Campaign Management service.
CampaignCriterion = new BiddableCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new RadiusCriterion
{
// 'Latitude' column header in the Bulk file
LatitudeDegrees = 10.5,
// 'Longitude' column header in the Bulk file
LongitudeDegrees = 40.5,
// 'Name' column header in the Bulk file
Name = "RadiusName",
// 'Radius' column header in the Bulk file
Radius = 10,
// 'Unit' column header in the Bulk file
RadiusUnit = DistanceUnit.Kilometers,
},
CriterionBid = new BidMultiplier
{
// 'Bid Adjustment' column header in the Bulk file
Multiplier = 20,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = CampaignCriterionStatus.Active,
}
};
uploadEntities.Add(bulkCampaignRadiusCriterion);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 市场活动半径条件 记录， 批量文件架构中提供了以下属性字段。
出价调整
要调整相应半径条件的出价的百分比金额。
支持的值为负 90 (-90) 到正 900 (900) 。
添加： 选。 如果未包括，则出价调整将设置为默认值 0 。
更新： 必填
删除： 只读
Campaign
应用或删除此条件的活动的名称。
添加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 选
更新： 选
删除： 选
Id
条件的 Microsoft Advertising 唯一标识符。
添加： 只读
更新： 只读和必需
删除： 只读和必需
Latitude
位置条件的纬度（以度为单位）。
纬度必须大于或等于 -85.0 且小于或等于 +85.0。
将纬度和经度指定为十进制值。 例如，Wa Redmond Way One 的纬度和经度分别为 47.755367 和 -122.091827。 若要获取这些值，可以在 必应地图 中输入地理位置的地址，坐标将显示在地址下方。
添加： 必填
更新： 必填
删除： 只读
Longitude
位置条件的经度（以度为单位）。
经度必须大于或等于 -180.0 且小于或等于 +180.0。
将纬度和经度指定为十进制值。 例如，Wa Redmond Way One 的纬度和经度分别为 47.755367 和 -122.091827。 若要获取这些值，可以在 必应地图 中输入地理位置的地址，坐标将显示在地址下方。
添加： 必填
更新： 必填
删除： 只读
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
名称
目标地理位置的名称。
名称最多可以包含 50 个字符。
添加： 选
更新： 只读
删除： 只读
父 ID
应用或删除此条件的活动的标识符。
此批量字段映射到市场活动记录的 ID 字段。
添加： 只读和必需。 必须指定现有的市场活动标识符，或指定等于父市场活动记录的 ID 字段的负标识符。 如果要向同一批量文件中的新市场活动添加新条件，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
半径
指定要定位的地理位置周围区域的半径。
如果“ Radius 单位” 字段设置为 “英里”，则接受从 1 到 500 的正整数值。
如果“ 半径单位” 字段设置为 “千米”，则接受从 1 到 800 的正整数值。
注意
数据类型为 double，在将来的版本中可能受支持。 目前，服务仅接受并返回整数值。
添加： 必填
更新： 必填
删除： 只读
状态
表示市场活动与条件之间的关联状态。 如果条件应用于市场活动，则此字段的值为 “活动”。 若要删除条件，请将状态设置为 “已删除”。
添加： 只读。 添加条件时，状态将始终设置为 “活动 ”。 如果上传另一个值，例如 Foo ，则结果文件将包含相同的值，尽管条件处于活动状态。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。 若要删除特定位置条件出价，必须上传 “状态”、“ ID”和“ 父 ID”。
Unit
指定半径的度量单位。
支持的值为 “英里 (默认) ”和 “公里”。
添加： 选。 如果未指定，则将设置默认值 “英里 ”。
更新： 必填
删除： 只读