产品广告记录 - 批量
定义可在批量文件中下载和上传的产品广告。
产品广告不直接用于交付的广告副本。 相反，交付引擎会从客户Microsoft商家中心商店目录中找到的产品详细信息生成产品广告。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 ProductAds 的 DownloadEntity 值，可以下载帐户中的所有产品广告记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
如果提供了有效的 父 ID 值，下面的批量 CSV 示例将添加新的产品广告。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,
如果使用用于 .NET、Java 或 Python 的 Bing Ads SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkProductAd 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// ProductAd object of the Campaign Management service.
ProductAd = new ProductAd
{
// 'Id' column header in the Bulk file
Id = null,
// 'Promotion' column header in the Bulk file
PromotionalText = "Find New Customers & Increase Sales!",
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
},
};
uploadEntities.Add(bulkProductAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 产品广告 记录， 批量文件架构中提供了以下属性字段。
广告组
包含广告的广告组的名称。
加： 只读和必需
更新： 只读和必需
删除： 只读和必需
Campaign
包含广告组和广告的市场活动的名称。
加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
加： 自选
更新： 自选
删除： 只读
编辑上诉状态
确定是否可以对编辑评审发现的问题提出上诉。
下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 上诉 | 编辑问题很有吸引力。 |
| AppealPending | 编辑问题可上诉，已提出上诉。 |
| NotAppealable | 编辑问题没有吸引力。 |
加： 只读
更新： 只读
删除： 只读
编辑位置
编辑评审失败的广告的组件或属性。
加： 只读
更新： 只读
删除： 只读
编辑原因代码
标识失败原因的代码。 有关可能的原因代码列表，请参阅 编辑原因代码。
加： 只读
更新： 只读
删除： 只读
编辑状态
广告的编辑状态。
下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 活动 | 广告通过了编辑评审。 |
| ActiveLimited | 广告在一个或多个市场通过了编辑评审，广告的一个或多个元素正在另一个市场进行编辑评审。 例如，广告通过了加拿大的编辑评审，并且仍在美国中等待评审。 |
| 反对 | 广告未通过编辑评审。 |
| 非活动 | 广告的一个或多个元素正在接受编辑评审。 |
加： 只读
更新： 只读
删除： 只读
编辑术语
编辑评审失败的术语。
如果术语组合导致失败，或者失败基于策略冲突，则不会设置此字段。
加： 只读
更新： 只读
删除： 只读
Id
广告的系统生成的标识符。
加： 自选。 必须将此字段留空，或指定负标识符。 然后，可以在相关记录类型（例如产品广告标签）的 “父 ID ”字段中引用为 广告设置的负标识符。 如果要在同一批量文件中添加新广告和新的从属记录，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
加： 只读
更新： 只读
删除： 只读
父 ID
包含广告的广告组的系统生成的标识符。
此批量字段映射到广告组记录的 Id 字段。
加： 只读和必需。 必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。 如果要将新广告添加到同一批量文件中的新广告组，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读
删除： 只读
发布者国家/地区
编辑指南不允许指定 术语的发布者国家或地区的列表。
在批量文件中，发布者国家或地区的列表用分号 (;) 分隔。
加： 只读
更新： 只读
删除： 只读
状态
广告的状态。
注意
从 2024 年 12 月 3 日开始，产品广告记录的批量 API 将不再支持删除操作。 这是因为产品广告实体是系统生成的。
可能的值为 Active、 Paused 或 Deleted。
加： 自选。 默认值为 Active。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。
删除： 必填。 “状态”必须设置为 “已删除”。