市场活动负面商店标准记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的“市场活动负面商店条件”。

每个 市场活动负面商店标准 从品牌购物活动中排除一个 Microsoft 商家中心商店。每个市场活动最多可以有 10 个排除的商店。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignNegativeStoreCriterions 的 DownloadEntity 值，可以下载帐户中的所有市场活动负面存储条件记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

如果提供了有效的父 ID 值，下面的批量 CSV 示例将添加新的市场活动负面存储条件。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Store Id,Name
Format Version,,,,,,,,,6.0
Campaign Negative Store Criterion,Active,,-114,,,ClientIdGoesHere,,StoreIdGoesHere,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeStoreCriterion
var bulkCampaignNegativeStoreCriterion = new BulkCampaignNegativeStoreCriterion
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new StoreCriterion
        {
            // 'Store Id' column header in the Bulk file
            StoreId = StoreIdGoesHere,
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeStoreCriterion);

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
状态
应用商店 ID

Campaign

包含应用商店条件的活动的名称。

添加： 只读和必需
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 只读和必需

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “市场活动” 字段。

客户端 ID

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

添加： 选
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 只读

Id

存储条件的系统生成的标识符。

添加： 只读
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 只读和必需

修改时间

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

注意

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

添加： 只读
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 只读

父 ID

包含商店条件的活动的系统生成的标识符。

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

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

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “市场活动” 字段。

状态

存储条件的状态。

可能的值为 Active 或 Deleted。

添加： 选。默认值为 Active。
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 必填。 “状态”必须设置为 “已删除”。

应用商店 ID

要排除的 Microsoft 商家中心商店的系统生成的标识符。

添加： 必填
更新： 不适用。可以添加和删除负存储，但不能更新。
删除： 只读

通过