市场活动行业标准记录 - 批量

定义可在批量文件中上传和下载的活动行业标准。

可以通过设置 配置文件 ID,根据LinkedIn针对特定行业的人员。

Microsoft Advertising 应用市场活动与广告组级别配置文件条件的联合。 但是,如果应用具有相同配置文件 ID 的条件,例如,在市场活动级别和广告组级别定位或排除相同的公司名称,则广告组级别标准将覆盖市场活动级别标准。

提示

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

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignTargetCriterionsDownloadEntity 值,可以下载帐户中的所有市场活动行业标准记录。 此外,下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息(包括最佳做法),请参阅 批量下载和上传

如果提供了有效的 父 ID 值,以下批量 CSV 示例将添加新的市场活动行业标准。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Profile Id,
Format Version,,,,,,,,,,6.0,,
Campaign Industry Criterion,Active,,-1111,,,,ClientIdGoesHere,,20,,ProfileIdGoesHere,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignIndustryCriterion
var bulkCampaignIndustryCriterion = new BulkCampaignIndustryCriterion
{
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // 'Profile' column header in the Bulk file is read-only
    ProfileName = null,

    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.

    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new ProfileCriterion
        {
            // 'Profile Id' column header in the Bulk file
            ProfileId = 0,

            // Maps to the 'Campaign Industry Criterion' record name in the Bulk file
            ProfileType = ProfileType.Industry
        },

        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(bulkCampaignIndustryCriterion);

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

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

对于 市场活动行业准则 记录, 批量文件架构中提供了以下属性字段。

出价调整

要调整相应 配置文件 ID 的出价的百分比金额。

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

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

Campaign

应用或删除此条件的活动的名称。

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

客户端 ID

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

添加:
更新:
删除:

Id

条件的 Microsoft Advertising 唯一标识符。

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

修改时间

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

注意

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

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

父 ID

应用或删除此条件的活动的标识符。

此批量字段映射到市场活动记录的 ID 字段。

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

配置文件

受众配置文件的显示名称(英文)。

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

配置文件 ID

要以相应的 出价调整为目标的受众配置文件的标识符。

添加: 必填
更新: 必填
删除: 必填

状态

表示市场活动与条件之间的关联状态。 如果条件应用于市场活动,则此字段的值为 “活动”。 若要删除条件,请将状态设置为 “已删除”。

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