通过

广告组Check In天条件记录 - 批量

  • 项目

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

提示

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

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupTargetCriterions 的 DownloadEntity 值，可以在帐户中下载所有 Ad Group Check In Day Criterion 记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。

如果提供了有效的父 ID 值，以下批量 CSV 示例将添加新的广告组检查天条件。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Target,Min Target Value,Max Target Value,Name
Format Version,,,,,,,,,,,,,6
Ad Group Check In Day Criterion,Active,,-1111,,,,ClientIdGoesHere,,10,Monday,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupCheckInDayCriterion
var bulkAdGroupCheckInDayCriterion = new BulkAdGroupCheckInDayCriterion
{
    // '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 CheckInDayCriterion
        {
            // 'CheckInDay' column header in the Bulk file
            CheckInDay = Day.Monday
        },

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

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

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

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

广告组

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

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

出价调整

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

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

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

Campaign

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

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

客户端 ID

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

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

Id

条件的 Microsoft Advertising 唯一标识符。

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

修改时间

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

注意

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

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

父 ID

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

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

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

状态

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

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

子类型

要面向的以天为单位的子类型检查。

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

Target

要以相应出价调整为目标的一天中的检查的标识符。

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