广告组负关键字记录 - 批量

项目
11/13/2024

定义分配给可在批量文件中上传和下载的广告组的负关键字 (keyword) 。

在批量架构中，与广告组关联的每个负关键字都由各自的行单独表示。例如，如果一个广告组有两个否定关键字，则它们由批量文件中的两条 广告组否定关键字 记录表示，并将 “状态” 设置为“活动”。

注意

可以添加和删除 广告组负关键字 ，但无法更新。

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

如果提供了有效的父 ID 值，以下批量 CSV 示例将添加新的广告组负关键字 (keyword) 。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Ad Group Negative Keyword,Active,,-1111,,,ClientIdGoesHere,,shoes,Exact,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupNegativeKeyword
var bulkAdGroupNegativeKeyword = new BulkAdGroupNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkAdGroupNegativeKeyword);

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
状态

广告组

包含负关键字 (keyword) 的广告组的名称。

添加： 只读和必需
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读和必需

注意

若要添加和删除，必须指定 “父 ID ”或 “广告组” 字段。

Campaign

包含广告组和负面关键字 (keyword) 的市场活动的名称。

添加： 只读
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

客户端 ID

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

添加： 选
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

Id

负关键字 (keyword) 的系统生成的标识符。

添加： 只读
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读和必需

关键字

负关键字 (keyword) 文本。

文本最多可以包含 100 个字符。

添加： 必填
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

匹配类型

要比较负关键字 (keyword) 和用户的搜索词的匹配类型。

负关键字 (keyword) 支持的匹配类型值为 Phrase 和 Exact。

添加： 必填
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

修改时间

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

注意

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

添加： 只读
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 只读

父 ID

包含负关键字 (keyword) 的广告组的系统生成的标识符。

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

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

注意

若要添加和删除，必须指定 “父 ID ”或 “广告组” 字段。

状态

表示广告组与负关键字 (keyword) 之间的关联状态。

如果负关键字 (keyword) 与广告组相关联，则此字段的值为 Active。

可能的值为 Active 或 Deleted。

添加： 选。默认值为 Active。
更新： 不适用。可以添加和删除负关键字 (keyword) ，但不能更新。
删除： 必填。 “状态”必须设置为 “已删除”。若要删除特定的负关键字 (keyword) ，必须上传“状态”、“ID”和“父 ID”。若要删除广告组的所有负面关键字，只需在单个记录中上传“状态”和“父 ID”。然后，可以选择添加新的负关键字 (keyword) 记录来替换已删除的集。

通过