市场活动负面网站记录 - 批量

定义分配给可在批量文件中上传和下载的营销活动的负站点。

在批量架构中,与市场活动关联的每个负面网站都由各自的行单独表示。 例如,如果你有两个负面网站,则它们由批量文件中的两条 市场活动负面网站 记录表示,并将 “状态” 设置为“活动”。 上传或下载关联负面网站的更新列表的记录时,一条记录会将 “状态” 设置为“已删除”,并显示一个空 的“网站 ”字段。 这表示已对列表进行了一些更改,并且后面的 市场活动负面网站 记录处于活动状态。

注意

可以添加和删除 市场活动负面网站 ,但无法更新。

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,contoso.com,ClientIdGoesHere,,

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

var uploadEntities = new List<BulkEntity>();
	
// Map properties in the Bulk file to the BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
                
    // Map properties in the Bulk file to the 
    // CampaignNegativeSites object of the Campaign Management service.
    CampaignNegativeSites = new CampaignNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.

// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // '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,
    // 'Website' column header in the Bulk file
    Website = "contoso.com",
};

uploadEntities.Add(bulkCampaignNegativeSite);

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

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

对于 市场活动负面网站 记录, 批量文件架构中提供了以下属性字段。

Campaign

包含负面网站的市场活动的名称。

加: 只读和必需
更新: 不適用。 可以添加和删除负面站点,但不能更新。
删除: 只读和必需

注意

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

客户端 ID

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

加: 自选
更新: 不適用。 可以添加和删除负面站点,但不能更新。
删除: 只读

修改时间

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

注意

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

加: 只读
更新: 不適用。 可以添加和删除负面站点,但不能更新。
删除: 只读

父 ID

包含负面网站的市场活动的系统生成的标识符。

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

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

注意

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

状态

表示市场活动与负面网站之间的关联状态。

如果负网站与市场活动相关联,则此字段的值为 Active

可能的值为 ActiveDeleted

加: 自选。 默认值为 Active
更新: 不適用。 可以添加和删除负面站点,但不能更新。
删除: 必填。 “状态”必须设置为 “已删除”。 若要删除特定的负面站点,必须上传 “状态”、“ 父 ID”和 “网站”。 若要删除市场活动的所有负面网站,只需在单个记录中上传 “状态”“父 ID ”。 然后,可以选择添加新的负网站记录来替换已删除的集。

网站

不希望显示广告的网站 URL。

每个 URL 必须指定域名,例如 ,contoso.com 最多可以包含三个子域和两个子目录。 子域计数包括 www 前缀。 例如 ,one.two.three.contoso.com/1/2www.two.three.contoso.com/1/2one.two.contoso.co.uk/1/2 是有效的 URL,而 one.two.three.contoso.co.uk/1/2 (太多子域 ) ,one.two.three.contoso.com/1/2/3 (太多子目录) 不是。 不允许每个市场活动或广告组出现重复的负面网站 URL。

只能排除联合搜索网站的网站。 广告组 的网络 必须设置为 OwnedAndOperatedAndSyndicatedSearch

使用在广告组级别指定的负网站 URL,而不是在市场活动级别指定的任何负面网站 URL。 如果将任何网站排除列表与广告帐户相关联, (通过市场活动管理服务) 提供,除市场活动负面网站或广告组负面网站外,还会使用负面网站列表。

加: 必填
更新: 不適用。 可以添加和删除负面站点,但不能更新。
删除: 只读