广告组位置条件记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的广告组位置条件。

使用位置条件，可以选择向潜在客户显示广告，搜索或查看有关以下内容的页面：

所有可用的国家/地区
美国) 、县、州/省和国家/地区的所选城市、邮政编码、大都市区 (Microsoft 市场区域

每个位置条件定义附带条件出价调整的位置代码。

可为每个市场活动或广告组指定的合并位置和负位置条件的最大数目为 10,000。

注意

每个广告组只能有一条广告组位置意向条件记录，以确定适用于所有广告组的广告组位置条件和广告组半径条件记录的位置意向选项。创建广告组的第一个条件时，还将自动添加广告组位置意向条件记录，并将默认目标设置为 PeopleInOrSearchingForOrViewingPages。无论广告组是否具有任何其他条件，都可以添加或更新广告组的“广告组位置意向条件”。不能删除广告组的 “广告组位置意向条件”，尽管没有位置或半径条件，它没有任何用途。

如果) 指定广告组级别位置条件 (正面或负面，则忽略该广告组的市场活动级别位置条件。换句话说，广告组位置条件会覆盖市场活动位置条件，并且不作为联合应用。

另请注意，必须将位置、负位置和半径条件视为一组 地理条件。如果广告组具有任何地理条件，则不会继承任何市场活动的地理条件。如果广告组没有任何地理条件，则会继承市场活动的所有地理位置条件。即使广告组具有位置意向条件，也可以从市场活动继承地理条件。如果使用广告组的地理条件，则使用广告组的位置意向条件;如果继承了市场活动的地理位置条件，则使用市场活动的位置意向条件，并忽略广告组的位置意向条件。不能删除市场活动或广告组的位置意向条件，尽管没有位置或半径条件，它没有任何目的。

提示

有关如何使用目标条件的概述，请参阅向目标受众显示广告。

通过在 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 Location Criterion,Active,,-1111,Country,,,ClientIdGoesHere,,190,20,,,,,,,,,,

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupLocationCriterion 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupLocationCriterion
var bulkAdGroupLocationCriterion = new BulkAdGroupLocationCriterion
{
    // '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 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 = AdGroupCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkAdGroupLocationCriterion);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

对于 广告组位置条件 记录，批量文件架构中提供了以下属性字段。

广告组
出价调整
市场活动
客户端 ID
Id
修改时间
父 ID
状态
子类型
目标

广告组

应用或删除此条件的广告组的名称。

添加： 只读
更新： 只读
删除： 只读

出价调整

要调整相应 目标的出价的百分比金额。

支持的值为负 90 (-90) 到正 900 (900) 。

添加： 选。如果未包括，则出价调整将设置为默认值 0 。
更新： 必填
删除： 只读

Campaign

包含应用或移除此条件的广告组的市场活动的名称。

添加： 只读
更新： 只读
删除： 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。它可以是长度最大为 100 的任何有效字符串。

添加： 选
更新： 选
删除： 选

Id

条件的 Microsoft Advertising 唯一标识符。

添加： 只读
更新： 只读和必需
删除： 只读和必需

修改时间

上次更新实体的日期和时间。该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

添加： 只读
更新： 只读
删除： 只读

父 ID

应用或删除此条件的广告组的标识符。

此批量字段映射到广告组记录的 Id 字段。

添加： 只读和必需。必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。如果要向同一批量文件中的新广告组添加新条件，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

状态

表示广告组与条件之间的关联状态。如果条件应用于广告组，则此字段的值为 Active。若要删除条件，请将状态设置为 “已删除”。

添加： 只读。添加条件时，状态将始终设置为 “活动 ”。如果上传另一个值，例如 Foo ，则结果文件将包含相同的值，尽管条件处于活动状态。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。若要删除特定位置条件出价，必须上传 “状态”、“ ID”和“ 父 ID”。

子类型

要面向的位置子类型。例如，如果记录表示城市位置条件，则值为 City。

注意

邻里位置即将推出。子类型将为“邻里”。

随时可以添加新的位置子类型。给定位置 ID 的位置类型很少发生更改。

添加： 只读
更新： 只读
删除： 只读

Target

要定位的具有相应 出价调整的位置的标识符。

有关可能的值，请参阅地理位置文件的“位置ID”字段。可以调用 GetGeoLocationsFileUrl 操作来下载文件。

重要

在添加或更新位置条件之前，请在地理位置文件中检查“状态”字段。如果状态为 PendingDeprecation，则位置条件不再用于定位或排除。仍可检索已弃用的位置条件，但无法添加或更新已弃用的位置条件。

添加： 必填
更新： 必填
删除： 只读

通过

广告组位置条件记录 - 批量

广告组

出价调整

Campaign

客户端 ID

Id

修改时间

父 ID

状态

子类型

Target

反馈

其他资源