广告组位置意向条件记录 - 批量
定义可在批量文件中上传和下载的广告组位置条件。
每个位置意向条件为市场活动或广告组的所有位置和半径条件定义意向选项。 没有任何附带的条件出价调整。
可为每个市场活动或广告组指定的最大位置意向条件数为 1。
注意
每个广告组只能有一条 广告组位置意向条件 记录，以确定适用于所有广告组的广告 组位置条件 和 广告组半径条件 记录的位置意向选项。 创建广告组的第一个条件时，还将自动添加 广告组位置意向条件 记录，并将默认 目标 设置为 PeopleInOrSearchingForOrViewingPages。 无论广告组是否具有任何其他条件，都可以添加或更新广告组 的“广告组位置意向条件”。 不能删除广告组的 “广告组位置意向条件”，尽管没有位置或半径条件，它没有任何用途。
自 2024 年 4 月起，PeopleSearchingForOrViewingPages 已弃用。 如果尝试将 IntentOption 设置为 PeopleSearchingForOrViewingPages，它将改为设置为 PeopleInOrSearchingForOrViewingPages 。 我们将具有此设置的现有市场活动自动转换为 PeopleInOrSearchingForOrViewingPages。
重要
将 AIM Location Intent Criteria 设置为 PeopleIn ，而不是 PeopleInOrSearchingForOrViewingPages。
提示
有关如何使用目标条件的概述，请参阅 向目标受众显示广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupTargetCriterions 的 DownloadEntity 值，可以下载帐户中的所有广告组位置意向条件记录。 此外，下载请求必须包括 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 Location Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupLocationIntentCriterion 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
// '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 LocationIntentCriterion
{
// 'Target' column header in the Bulk file
IntentOption = IntentOption.PeopleIn
},
CriterionBid = null,
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupLocationIntentCriterion);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 广告组位置意向条件 记录， 批量文件架构中提供了以下属性字段。
广告组
应用或删除此条件的广告组的名称。
添加： 只读
更新： 只读
删除： 只读
Campaign
包含应用或移除此条件的广告组的市场活动的名称。
添加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 选
更新： 选
删除： 选
Id
条件的标识符。
注意
目前，位置意向条件标识符等于父标识符，但不应依赖该关系。 最佳做法是，应将位置意向条件标识符视为非重复标识符。
添加： 只读
更新： 只读
删除： 只读
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
父 ID
应用或删除此条件的广告组的标识符。
此批量字段映射到广告组记录的 Id 字段。
添加： 只读和必需。 必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。 如果要向同一批量文件中的新广告组添加新条件，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
状态
表示广告组与条件之间的关联状态。 如果为广告组设置了条件，则此字段的值为 Active。 若要删除条件，请将状态设置为 “已删除”。
添加： 只读。 添加条件时，状态将始终设置为 “活动 ”。 如果上传另一个值，例如 Foo ，则结果文件将包含相同的值，尽管条件处于活动状态。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。 若要删除特定位置意向条件，必须上传 “状态” 和“ 父 ID”。
Target
确定用户是否必须位于目标位置才能显示广告。
支持以下值。 默认值为 PeopleInOrSearchingForOrViewingPages。
- 如果要向用户显示广告、搜索或查看有关目标位置的页面，请使用 PeopleInOrSearchingForOrViewingPages 。
- 如果要向目标位置中的人员显示广告，请使用 PeopleIn 。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果设置此字段，则必须将其设置为有效值，即 PeopleInOrSearchingForOrViewingPages 或 PeopleIn。
删除： 只读