市场活动位置条件记录 - 批量
定义一个市场活动位置条件,该条件可用于向特定位置的用户显示广告。
使用位置条件,可以选择向潜在客户显示广告,搜索或查看有关以下内容的页面:
- 所有可用的国家/地区
- 美国) 、县、州/省和国家/地区的所选城市、邮政编码、大都市区 (Microsoft 市场区域
每个位置条件定义附带条件出价调整的位置代码。
可为每个市场活动或广告组指定的合并位置和负位置条件的最大数目为 10,000。
注意
每个市场活动只能有一个 市场活动位置意向标准 记录,以确定适用于市场活动的所有 市场活动位置条件 和 市场活动半径条件 记录的位置意向选项。 创建市场活动的第一个条件时,还会自动添加 市场活动位置意向条件 记录,并将默认 目标 设置为 PeopleInOrSearchingForOrViewingPages。 无论市场活动是否具有任何其他条件,都可以添加或更新市场 活动的位置意向标准。 虽然没有位置或半径条件,但无法删除市场 活动的市场活动位置意向标准。
如果) 指定广告组级别位置条件 (正面或负面,则忽略该广告组的市场活动级别位置条件。 换句话说,广告组位置条件会覆盖市场活动位置条件,并且不作为联合应用。
另请注意,必须将位置、负位置和半径条件视为一组 地理条件。 如果广告组具有任何地理条件,则不会继承任何市场活动的地理条件。 如果广告组没有任何地理条件,则会继承市场活动的所有地理位置条件。 即使广告组具有位置意向条件,也可以从市场活动继承地理条件。 如果使用广告组的地理条件,则使用广告组的位置意向条件;如果继承了市场活动的地理位置条件,则使用市场活动的位置意向条件,并忽略广告组的位置意向条件。 不能删除市场活动或广告组的位置意向条件,尽管没有位置或半径条件,它没有任何目的。
提示
有关如何使用目标条件的概述,请参阅 向目标受众显示广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignTargetCriterions 的 DownloadEntity 值,可以下载帐户中的所有市场活动位置条件记录。 此外,下载请求必须包括 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 Location Criterion,Active,,-111,Country,,ClientIdGoesHere,,190,20,,,,,,,,,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ,则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkCampaignLocationCriterion 对象,而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCampaignLocationCriterion
var bulkCampaignLocationCriterion = new BulkCampaignLocationCriterion
{
// '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 LocationCriterion
{
// 'Target' column header in the Bulk file
LocationId = 190,
// 'Sub Type' column header in the Bulk file
LocationType = "Country"
},
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(bulkCampaignLocationCriterion);
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 唯一标识符。
添加: 只读
更新: 只读和必需
删除: 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间,而不是客户端。 有关日期和时间格式的信息,请参阅 基元 XML 数据类型中的 dateTime 条目。
添加: 只读
更新: 只读
删除: 只读
父 ID
应用或删除此条件的活动的标识符。
此批量字段映射到市场活动记录的 ID 字段。
添加: 只读和必需。 必须指定现有的市场活动标识符,或指定等于父市场活动记录的 ID 字段的负标识符。 如果要将新条件添加到同一批量文件中的新市场活动,则建议这样做。 有关详细信息,请参阅 批量文件架构引用密钥。
更新: 只读和必需
删除: 只读和必需
状态
表示市场活动与条件之间的关联状态。 如果条件应用于市场活动,则此字段的值为 “活动”。 若要删除条件,请将状态设置为 “已删除”。
添加: 只读。 添加条件时,状态将始终设置为 “活动 ”。 如果上传另一个值,例如 Foo ,则结果文件将包含相同的值,尽管条件处于活动状态。
更新: 选
删除: 必填。 “状态”必须设置为 “已删除”。 若要删除特定位置条件出价,必须上传 “状态”、“ ID”和“ 父 ID”。
子类型
要面向的位置子类型。 例如,如果记录表示 城市 位置条件,则值为 City。
可能的值为 City、 Country、 County、 MetroArea、 PostalCode 和 State。
注意
邻里位置即将推出。 子类型将为“邻里”。
随时可以添加新的位置子类型。 给定位置 ID 的位置类型很少发生更改。
添加: 只读
更新: 只读
删除: 只读
Target
要定位的具有相应 出价调整的位置的标识符。
有关可能的值,请参阅地理位置文件的“位置ID”字段。 可以调用 GetGeoLocationsFileUrl 操作来下载文件。
重要
在添加或更新位置条件之前,请在地理位置文件中检查“状态”字段。 如果状态为 PendingDeprecation,则位置条件不再用于定位或排除。 仍可检索已弃用的位置条件,但无法添加或更新已弃用的位置条件。
添加: 必填
更新: 必填
删除: 只读