市场活动白天条件记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的活动日期和时间条件。

随着市场活动的进展，你可能会发现点击率和转换率在某些时间（例如，周夜）最高。这可能是一个绝佳的机会，利用出价调整来提高星期一到星期五晚上 6：00 到晚上 11：00 显示广告的机会。按时间定位时，你的目标是搜索者的本地时区。例如，如果将下午 6：00 的出价提高 10%，到晚上 11：00，则该出价调整将从美国东部时间 6：00 到晚上 11：00 对纽约的搜索者生效，然后对西雅图的搜索者从太平洋时间晚上 6：00 到晚上 11：00 生效。现在，你在潜在客户在线时显示广告！

每一天和时间标准定义从小时、从分钟到小时以及到分钟数的对应条件出价调整要求。

注意

不能修改现有条件的 Target、 From Hour、 From Minute、 To Hour 或 To Minute 值。若要修改日期和时间范围，必须删除条件并添加新条件。

可为每个市场活动或广告组指定的最大天数和时间条件为 49。不能指定任何重叠的日期和时间范围，例如，星期一从凌晨 3：00 到 5：00，星期一凌晨 4：00 到 6：00 对于同一市场活动或广告组不允许。此外，对于给定的市场活动或广告组，可以指定的每日最大天数和时间条件为 7。例如，可以指定最多 7 天和时间条件，其中 Day 设置为星期一。

如果指定了广告组级别日期和时间条件，则会忽略该广告组的市场活动级别日期和时间条件。换句话说，广告组日期和时间标准会覆盖市场活动日期和时间标准，并且不作为联合应用。

提示

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

通过在 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 DayTime Criterion,Active,,-111,,,ClientIdGoesHere,,Monday,20,,,,0,0,4,0,,

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

var uploadEntities = new List<BulkEntity>();

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

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

    // 'Modified Time' column header in the Bulk file is read-only
    //  LastModifiedTime cannot be set in the Bulk entity

    // 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 DayTimeCriterion
        {
            // 'Target' column header in the Bulk file
            Day = Day.Monday,

            // 'From Hour' column header in the Bulk file
            FromHour = 0,

            // 'To Hour' column header in the Bulk file
            ToHour = 4,

            // 'From Minute' column header in the Bulk file
            FromMinute = Minute.Zero,

            // 'To Minute' column header in the Bulk file
            ToMinute = Minute.Zero
        },

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

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
状态
目标
To Hour
To Minute

出价调整

要调整相应 Target、From Hour、From Minute、To Hour 和 To Minute 的出价的百分比金额。

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

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

Campaign

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

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

客户端 ID

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

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

从小时

要确定的起始小时数。

支持的值范围为 0 到 23。

添加： 必填
更新： 必填。不能修改现有条件的 Target、 From Hour、 From Minute、 To Hour 或 To Minute 值。若要修改日期和时间范围，必须删除条件并添加新条件。
删除： 只读

从分钟

要定位的起始分钟数。

支持的值为 0、15、30 和 45。

Id

条件的 Microsoft Advertising 唯一标识符。

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

修改时间

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

注意

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

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

父 ID

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

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

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

状态

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

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

Target

要针对相应 出价调整的日期。

支持的值为 Sunday、 Monday、 Tuesday、 Wednesday、 Thursday、 Friday 和 Saturday。

To Hour

要确定的结束小时数。

支持的值范围为 0 到 24。如果 To Hour 设置为 24，则 To Minute 必须为零。

To Minute

要定位的结束分钟数。