广告组年龄条件记录 - 批量
定义可在批量文件中上传和下载的广告组年龄条件。
你可以按年龄定位客户，以便更频繁地向感兴趣的用户展示广告。
每个年龄条件都为附带条件出价调整定义了一个年龄范围。
可为每个市场活动或广告组指定的最大年龄条件数为 5 个，即每个受支持的年龄范围 为 18eToTwentyFour、 TwentyFiveToThirtyFourfour、 ThirtyFiveToFourtyNine、 FiftyToSixtyFour 和 SixtyFiveAndAbove 各一个。
如果指定了广告组级别年龄条件，则会忽略该广告组的市场活动级别年龄条件。 换句话说，广告组年龄标准会覆盖市场活动年龄标准，并且不作为联合应用。
提示
有关如何使用目标条件的概述，请参阅 向目标受众显示广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupTargetCriterions 的 DownloadEntity 值，可以下载帐户中的所有 Ad 组年龄条件记录。 此外，下载请求必须包括 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 Age Criterion,Active,,-1111,,,,ClientIdGoesHere,,EighteenToTwentyFour,20,,,,,,,,,,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupAgeCriterion 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupAgeCriterion
var bulkAdGroupAgeCriterion = new BulkAdGroupAgeCriterion
{
// '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 AgeCriterion
{
// 'Target' column header in the Bulk file
AgeRange = AgeRange.EighteenToTwentyFour,
},
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,
}
};
uploadEntities.Add(bulkAdGroupAgeCriterion);
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 唯一标识符。
注意
以前，使用市场活动管理 API 版本 10，可以使用 AddTargetsToLibrary、SetTargetToCampaign 和 SetTargetToAdGroup 操作将一个目标标识符与多个市场活动和广告组相关联。 在市场活动或广告组与共享目标取消关联后，批量下载或批量上传结果文件中的条件标识符将设置为 0 (零) 。
添加： 只读
更新： 只读和必需
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
父 ID
应用或删除此条件的广告组的标识符。
此批量字段映射到广告组记录的 Id 字段。
添加： 只读和必需。 必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。 如果要向同一批量文件中的新广告组添加新条件，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
状态
表示广告组与条件之间的关联状态。 如果条件应用于广告组，则此字段的值为 Active。 若要删除条件，请将状态设置为 “已删除”。
添加： 只读。 添加条件时，状态将始终设置为 “活动 ”。 如果上传另一个值，例如 Foo ，则结果文件将包含相同的值，尽管条件处于活动状态。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。 若要删除特定年龄条件出价，必须上传 “状态”、“ ID”和“ 父 ID”。
Target
要以相应的 出价调整为目标的年龄范围。
支持的值为 EighteenToTwentyFour、 TwentyFiveToThirtyFour、 ThirtyFiveToFourtyNine、 FiftyToSixtyFour 和 SixtyFiveAndAbove。 还可以面向 未知 用户，即年龄未知的人。
注意
在许多国家或地区，在线广告客户不应针对任何 18 岁以下的用户。 Microsoft Advertising 不会向在其 Microsoft 帐户中将出生日期标识为 13 岁以下的儿童提供基于兴趣的广告。 有关详细信息，请参阅 Microsoft 隐私声明。
添加： 必填
更新： 必填
删除： 只读