市场活动评审广告扩展记录 - 批量
定义 市场活动 与可在批量文件中上传和下载的 审阅广告扩展 之间的关联记录。 若要上传或下载市场活动或查看广告扩展,请使用 市场活动 或 查看广告扩展 记录。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignReviewAdExtensions 的 DownloadEntity 值,可以下载帐户中的所有市场活动审阅广告扩展记录。 此外,下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息(包括最佳做法),请参阅 批量下载和上传。
如果提供了有效的 ID 和 父 ID 值,以下批量 CSV 示例会将评论广告扩展关联到市场活动。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Campaign Review Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ,则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkCampaignReviewAdExtension 对象,而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCampaignReviewAdExtension
var bulkCampaignReviewAdExtension = new BulkCampaignReviewAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = reviewAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = campaignIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkCampaignReviewAdExtension);
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 的任何有效字符串。
添加: 选
删除: 只读
编辑位置
编辑评审失败的广告扩展插件的组件或属性。
添加: 只读
删除: 只读
编辑原因代码
标识失败原因的代码。 有关可能的原因代码列表,请参阅 编辑原因代码。
添加: 只读
删除: 只读
编辑状态
广告扩展的编辑状态。
下表介绍了可能的值。
值 | 说明 |
---|---|
活动 | 广告扩展已通过编辑评审。 |
ActiveLimited | 广告扩展在一个或多个市场通过了编辑评审,广告扩展的一个或多个元素正在另一个市场进行编辑评审。 例如,广告扩展已通过加拿大的编辑评审,仍在美国中等待评审。 |
反对 | 广告扩展未通过编辑评审。 |
非活动 | 广告扩展的一个或多个元素正在接受编辑评审。 |
添加: 只读
删除: 只读
编辑术语
编辑评审失败的术语。
如果术语组合导致失败,或者失败基于策略冲突,则不会设置此字段。
添加: 只读
删除: 只读
Id
在市场活动中关联或删除的广告扩展的标识符。
此批量字段映射到“审阅广告扩展”记录的“ID”字段。
添加: 只读和必需。 必须指定现有的广告扩展标识符,或指定等于父“审阅广告扩展”记录的“ID”字段的负标识符。 如果要在同一批量文件中添加新的广告扩展和关联,则建议这样做。 有关详细信息,请参阅 批量文件架构引用密钥。
删除: 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间,而不是客户端。 有关日期和时间格式的信息,请参阅 基元 XML 数据类型中的 dateTime 条目。
添加: 只读
删除: 只读
父 ID
关联或删除此广告扩展的市场活动的标识符。
此批量字段映射到市场活动记录的 ID 字段。
添加: 只读和必需。 必须指定现有的市场活动标识符,或指定等于父市场活动记录的 ID 字段的负标识符。 如果将广告扩展关联到同一批量文件中的新市场活动,则建议这样做。 有关详细信息,请参阅 批量文件架构引用密钥。
删除: 只读和必需
发布者国家/地区
编辑指南不允许指定 术语的发布者国家或地区的列表。
在批量文件中,发布者国家或地区的列表用分号 (;) 分隔。
添加: 只读
删除: 只读
状态
表示市场活动与广告扩展之间的关联状态。
可能的值为 Active 和 Deleted。 如果广告扩展与市场活动关联,则此字段的值为 Active。
添加: 只读
删除: 必填。 “状态”必须设置为 “已删除”。