Ad Group DeviceOS Criterion Record - Bulk
定义可在批量文件中上传和下载的广告组设备条件。
按设备定位时，选择在潜在客户使用台式机、平板电脑或智能手机时向他们显示广告。
每个设备条件都为附带的条件出价调整定义了一个设备名称。
可为每个市场活动或广告组指定的最大设备条件数为 3。 对于 计算机、 智能手机和 平板电脑，必须有三个单独的条件，否则市场活动或广告组不能存在设备条件。
如果指定了广告组级别设备条件，则会忽略该广告组的市场活动级别设备条件。 换句话说，广告组设备条件会替代市场活动设备条件，并且不作为联合应用。
提示
有关如何使用目标条件的概述，请参阅 向目标受众显示广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupTargetCriterions 的 DownloadEntity 值，可以下载帐户中的所有 Ad Group DeviceOS Criterion 记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
如果提供了有效的 父 ID 值，以下批量 CSV 示例将为每个设备类型添加三个新的广告组设备条件 (一个条件) 。
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group DeviceOS Criterion,Active,,-1111,,,,ClientIdGoesHere,,Computers,20,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupDeviceOSCriterion 对象，而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
var bulkAdGroupDeviceCriterions = new [] {
// Map properties in the Bulk file to the BulkAdGroupDeviceCriterion
new BulkAdGroupDeviceCriterion
{
// 'Ad Group' column header in the Bulk file is read-only
AdGroupName = null,
// '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
// BiddableAdGroupCriterion object of the Campaign Management service.
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new DeviceCriterion
{
// 'Target' column header in the Bulk file
DeviceName = "Computers",
},
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 = AdGroupCriterionStatus.Active,
}
},
new BulkAdGroupDeviceCriterion
{
ClientId = "ClientIdGoesHere",
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
AdGroupId = adGroupIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Smartphones",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
new BulkAdGroupDeviceCriterion
{
ClientId = "ClientIdGoesHere",
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
AdGroupId = adGroupIdKey,
Criterion = new DeviceCriterion
{
DeviceName = "Tablets",
},
CriterionBid = new BidMultiplier
{
Multiplier = 0,
},
}
},
};
foreach (var bulkAdGroupDeviceCriterion in bulkAdGroupDeviceCriterions)
{
uploadEntities.Add(bulkAdGroupDeviceCriterion);
}
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 Ad 组 DeviceOS Criterion 记录，批量 文件架构中提供了以下属性字段。
广告组
应用或删除此条件的广告组的名称。
添加： 只读
更新： 只读
删除： 只读
出价调整
要调整相应 目标的出价的百分比金额。
支持的值为 -100 (负 100) 到正 900 (900) %。 将出价调整设置为 -100%将导致排除相应的 Target。
添加： 选。 如果未包括，则出价调整将设置为默认值 0 。
更新： 必填
删除： 只读
Campaign
包含应用或移除此条件的广告组的市场活动的名称。
添加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 选
更新： 选
删除： 选
Id
条件的 Microsoft Advertising 唯一标识符。
添加： 只读
更新： 只读和必需
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
父 ID
应用或删除此条件的广告组的标识符。
此批量字段映射到广告组记录的 Id 字段。
添加： 只读和必需。 必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。 如果要向同一批量文件中的新广告组添加新条件，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
状态
表示广告组与条件之间的关联状态。 如果条件应用于广告组，则此字段的值为 Active。 若要删除条件，请将状态设置为 “已删除”。
添加： 只读。 添加条件时，状态将始终设置为 “活动 ”。 如果上传另一个值，例如 Foo ，则结果文件将包含相同的值，尽管条件处于活动状态。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。 若要删除特定设备条件出价，必须上传 “状态”、“ ID”和“ 父 ID”。
Target
要以相应的 出价调整为目标的设备的名称。
支持的值为 “计算机”、“ 智能手机”和 “平板电脑”。
添加： 必填。 计算机、智能手机和平板电脑的三个单独出价应在批量文件中一起指定， (每个投标在单独的记录/行) 。 如果不添加表示这三种设备类型的单个设备条件，则不会为广告组添加任何设备条件。
更新： 必填
删除： 只读