SearchCampaignChangeHistoryReportColumn 值集 - 报告
定义可包含在 SearchCampaignChangeHistoryReportRequest 中的属性列。
有关必须包含的列的列表，请参阅下面的 “必需列” 部分。
语法
<xs:simpleType name="SearchCampaignChangeHistoryReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="DateTime" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="ChangedBy" />
<xs:enumeration value="CampaignName" />
<xs:enumeration value="CampaignId" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="AdTitle" />
<xs:enumeration value="AdDescription" />
<xs:enumeration value="DisplayUrl" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="ItemChanged" />
<xs:enumeration value="AttributeChanged" />
<xs:enumeration value="HowChanged" />
<xs:enumeration value="OldValue" />
<xs:enumeration value="NewValue" />
<xs:enumeration value="EntityName" />
<xs:enumeration value="EntityId" />
<xs:enumeration value="Tool" />
</xs:restriction>
</xs:simpleType>
值
SearchCampaignChangeHistoryReportColumn 值集具有以下值：AccountId、AccountName、AccountNumber、AdDescription、AdGroupId、AdGroupName、AdTitle、AttributeChanged、CampaignId、CampaignName、ChangedBy、DateTime、DisplayUrl、EntityId、EntityName、HowChanged、ItemChanged、 Keyword、NewValue、OldValue、Tool。
| 值 | 说明 |
|---|---|
| AccountId | 帐户的 Microsoft Advertising 分配的标识符。 |
| AccountName | 帐户名称。 |
| AccountNumber | 帐户的 Microsoft Advertising 分配的编号。 |
| AdDescription | 广告路径下方显示的第一个广告说明。 如果 ItemChanged 不是 Ad，则此列将为空。 |
| AdGroupId | 广告组的 Microsoft Advertising 分配的标识符。 如果 ItemChanged 不是 Ad 、广告组或关键字，则此列将为空。 |
| AdGroupName | 广告组名称。 如果 ItemChanged 不是 Ad 、广告组或关键字，则此列将为空。 |
| AdTitle | 广告标题部分。 如果 ItemChanged 不是 Ad，则此列将为空。 |
| AttributeChanged | 标识更改的 ItemChanged 列中实体的属性或属性。 有关报告其更改历史记录的元素的列表，请参阅 “备注”中的“属性已更改”列。 如果添加或删除了市场活动、广告组或广告实体，则此列为空。 |
| CampaignId | 为市场活动分配的 Microsoft Advertising 标识符。 |
| CampaignName | 市场活动名称。 |
| ChangedBy | 对帐户中的设置进行更改的用户的用户名。 如果系统进行了更改，则值为 Administrator。 |
| 日期时间 | 更改的日期和时间。 日期和时间将位于市场活动的时区。 |
| DisplayUrl | 广告显示 URL。 如果 ItemChanged 不是 Ad，则此列将为空。 |
| entityId | 已更新的实体的 Microsoft Advertising 系统标识符。 |
| EntityName | 已更新的实体的名称。 |
| HowChanged | 一个值，该值指示是添加、更新还是已删除元素。 有关可能的值，请参阅 ChangeTypeReportFilter 值集。 对于添加， NewValue 列包含添加的实体。 对于删除， OldValue 列包含已删除的实体。 对于更新， NewValue 列包含新值， OldValue 列包含旧值。 如果添加了具有传递状态属性的实体（例如市场活动），则 HowChanged 的值为“已添加”。 若要报告已删除的实体， ItemChanged 字段为 Status，HowChanged 字段为 Changed，NewValue 字段为 Deleted。 将目标与市场活动或广告组关联将报告为添加更改。 AttributeChanged 列将标识目标对象中包含的目标类型。 目标对象的汇报将报告为删除更改和添加更改。 删除市场活动或广告组与目标对象的关联将报告为删除更改。 |
| ItemChanged | 标识已更改的实体的值。 如果更改是实体元素的更新，或者与市场活动或广告组关联的目标相关， 则 AttributeChanged 列包含已更改实体的元素或更改的目标类型。 |
| 关键字 | 关键字 (keyword) 文本。 如果 ItemChanged 不是 Keyword，则此列将为空。 |
| NewValue | 更改后的值。 有关详细信息，请参阅 HowChanged 列。 |
| OldValue | 更改前的值。 有关详细信息，请参阅 HowChanged 列。 |
| 工具 | 用于进行更改的 Microsoft Advertising 工具。 可能的值包括“API”、“自动规则”、“批量上传”、“导入”、“编辑器”、“移动应用”、“其他”、“脚本”和“Web 客户端 (手动) ”。 将来可以添加新值，因此不应依赖于一组固定值。 |
备注
所需列
报表必须至少包含以下列。 一般情况下，每个报表必须至少包含一个属性列和至少一个非印象共享性能统计信息列。 有关详细信息，请参阅 报表属性和性能统计信息。
| Column |
|---|
| 日期时间 |
更改历史记录详细信息
下面是报告其更改历史记录的实体类型。
注意
如果 AttributeChanged 字段为空或空，并且 HowChanged 字段为“添加或删除”，则 NewValue 或 OldValue 字段的内容分别表示添加或删除的实体的元素。 例如，如果添加了关键字 (keyword) ，则 NewValue 字段包含关键字 (keyword) 文本。
帐户
当 ItemChanged 字段的值为 Account 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指已添加的帐户的名称。 相应 HowChanged 字段的值为 Added。 |
| 帐户 | 指已更改的帐户的名称。 |
| 代理联系人 | 指代理联系人的姓名。 |
| 销售公司客户 | 指销售公司客户。 |
| 向客户计费 | 指向客户计费 |
| 财务状况 | 指财务状况 |
| 锁定状态 | 指锁定状态 |
| 付款选项 | 指付款选项 |
| 首选帐单到付款方式 | 指首选的计费付款方式 |
| 首选语言 | 引用首选语言 |
| 销售付款方式 | 销售付款方式 |
| 状态 | 指帐户状态。 |
| 首选用户 | 指首选用户 |
| 支出限制 | 指支出限制 |
| 跟踪模板 | 引用帐户的跟踪模板。 |
广告
当 ItemChanged 字段的值为 Ad 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指所添加广告的标题。 相应 HowChanged 字段的值为 Added。 |
| 广告文本 | 引用广告副本的说明。 |
| 广告标题 | 指已更改的广告的标题。 |
| 自定义参数 | 引用广告的自定义参数。 |
| 目标 URL | 指广告的目标 URL。 |
| 显示 URL | 指广告的显示 URL。 |
| 编辑状态 | 指广告的编辑状态。 如果广告正在等待脱机编辑评审，则在下载的更改历史记录报告中，编辑状态表示为 挂起 - 活动 或 挂起 - 非活动。 有关详细信息，请参阅 实体和传递状态。 |
| 最终 URL | 指广告的最终 URL。 |
| 移动 URL | 指广告的最终移动 URL。 |
| 状态 | 指广告的投放状态。 如果报告已删除的广告，则 ItemChanged 字段为 Status，HowChanged 字段为 Changed，NewValue 字段为 Deleted。 |
| 跟踪模板 | 引用广告的跟踪模板。 |
广告组
当 ItemChanged 字段的值为 Ad 组时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指添加的广告组的名称。 相应 HowChanged 字段的值为 Added。 |
| 广告组 | 指已更改的广告组的名称。 |
| 高级位置定位 | 指与广告组关联的位置目标的意向选项。 |
| 年龄 | 指年龄目标。 |
| 自定义参数 | 引用广告组的自定义参数。 |
| 天 | 指必应广告 API 版本 9 之后弃用的日期目标。 |
| 默认广泛匹配出价 | 指默认广泛匹配出价 |
| 默认内容匹配出价 | 引用默认内容匹配出价 |
| 默认完全匹配出价 | 指默认的完全匹配出价 |
| 默认短语匹配出价 | 引用默认短语匹配出价 |
| 设备 | 指对设备目标的延迟。 |
| 距离 | 指半径目标的距离。 |
| 结束日期 | 指广告组的计划结束日期。 |
| 结束时间 | 指 DayTime 目标的组合“到小时”和“到分钟数”。 出价调整也包含在此字段中，从时间开始由单个垂直条形字符分隔。 |
| Gender | 指性别目标。 |
| 小时 | 指在必应广告 API 版本 9 之后弃用的小时目标。 |
| 位置 | 指位置目标。 |
| 位置排除 | 指从位置目标中排除位置。 |
| 中 | 指搜索或内容广告分发。 |
| 负关键字 (keyword) | 指与广告组关联的负关键字 (keyword) 。 汇报负关键字在两行中报告为“已删除”和“已添加”更改。 “已删除”记录对应于旧值，“已添加”记录反映新值。 |
| 暂停状态 | 指广告组的任何暂停状态。 |
| 产品组 | 产品组的乘积条件由向后斜杠 ('') 分隔，并在出价中用单个空格字符分隔。 |
| 网站排除 | 指广告组的负网站 URL。 一个广告组可以有多个网站排除项，每个网站排除项在其自己的报表行中单独表示。 |
| 开始时间 | 指 DayTime 目标的“从小时”和“从分钟数”组合。 出价调整也包含在此字段中，从时间开始由单个垂直条形字符分隔。 |
| 状态 | 指广告组的传递状态。 如果报告已删除的广告组，则 ItemChanged 字段为 Status，HowChanged 字段为 Changed，NewValue 字段为 Deleted。 |
| 目标天数 | 指 DayTime 目标的日期。 出价调整也包含在此字段中，从当天开始用单个垂直条形字符分隔。 |
| 跟踪模板 | 引用广告组的跟踪模板。 |
呼叫分机
当 ItemChanged 字段的值为“调用扩展”时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 关联 | 指调用扩展与实体的关联。 例如，如果扩展与市场活动相关联，则 CampaignName 字段的值是关联市场活动的名称，ItemChanged 字段的值为 Call extension，AttributeChanged 字段的值为 Association，HowChanged 字段的值为 Added。 另一个示例是，如果扩展与市场活动关联或取消关联，则相应的 NewValue 或 OldValue 是市场活动的名称，而 EntityName 列包含广告扩展的名称。 |
| 国家/地区 | 指呼叫分机的国家/地区。 |
| 电话号码 | 指呼叫分机的电话号码。 |
| 显示网站或手机 | 指是否应显示带有呼叫分机号码的网站。 OldValue 和 NewValue 列中的可能值为“电话”、“网站”和“电话”。 |
| 使用正向数字 | 指是否为呼叫分机设置转发。 OldValue 和 NewValue 列中的可能值为 No 和 Yes。 |
Campaign
当 ItemChanged 字段的值为 Campaign 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指已添加的市场活动的名称。 相应 HowChanged 字段的值为 Added。 |
| 高级位置定位 | 指与市场活动关联的位置目标的意向选项。 |
| 年龄 | 指年龄目标。 |
| 预算类型 | 指市场活动预算类型。 OldValue 和 NewValue 列中的可能值如下所示： - 每日目标值 (加速) 对应于 Microsoft Advertising Web 应用程序每日加速设置。 - 每日目标值 (标准) 对应于 Microsoft Advertising Web 应用程序每日标准设置。 |
| 市场活动优先级 | 指 Microsoft 购物活动的优先级。 |
| 自定义参数 | 指市场活动的自定义参数。 |
| 每日预算 | 指市场活动每日预算金额。 |
| 天 | 指必应广告 API 版本 9 之后弃用的日期目标。 |
| 设备 | 指设备目标。 |
| 距离 | 指半径目标的距离。 |
| 结束日期 | 指广告组的计划结束日期。 |
| 结束时间 | 指 DayTime 目标的组合“到小时”和“到分钟数”。 出价调整也包含在此字段中，从时间开始由单个垂直条形字符分隔。 |
| Gender | 指性别目标。 |
| 小时 | 指在必应广告 API 版本 9 之后弃用的小时目标。 |
| IP 排除 | 指通过 Microsoft Advertising Web 应用程序创建的 IP 排除项。 |
| 位置 | 指位置目标。 |
| 位置排除 | 指从位置目标中排除位置。 |
| 名称 | 指已更改的市场活动的名称。 |
| 负关键字 (keyword) | 指与市场活动关联的负面关键字 (keyword) 。 汇报负关键字在两行中报告为“已删除”和“已添加”更改。 “已删除”记录对应于旧值，“已添加”记录反映新值。 |
| 暂停状态 | 指市场活动的任何暂停状态。 OldValue 和 NewValue 列中的可能值为“预算暂停”、“预算和用户暂停”、“未暂停”和“已暂停”。 |
| 产品筛选器 | 指 Microsoft 购物市场活动的产品范围或条件。 Microsoft 购物市场活动可以有多个产品条件，并且每个条件在其自己的报表行中单独表示。 |
| 共享预算 | 指多个市场活动共享的预算。 |
| 网站排除 | 指市场活动的负面网站 URL。 一个市场活动可以有多个网站排除项，每个网站排除在其自己的报表行中单独表示。 |
| 开始日期 | 供内部使用。 |
| 开始时间 | 指 DayTime 目标的“从小时”和“从分钟数”组合。 出价调整也包含在此字段中，从时间开始由单个垂直条形字符分隔。 |
| 状态 | 指市场活动的交付状态。 如果报告已删除的活动，则 ItemChanged 字段为 Status，HowChanged 字段为 Changed，NewValue 字段为 Deleted。 |
| 目标天数 | 指 DayTime 目标的日期。 出价调整也包含在此字段中，从当天开始用单个垂直条形字符分隔。 |
| 跟踪模板 | 引用市场活动的跟踪模板。 |
关键字
当 ItemChanged 字段的值为 Keyword 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指已添加关键字 (keyword) 的文本。 相应 HowChanged 字段的值为 Added。 |
| 广泛匹配出价 | 指关键字 (keyword) 的广泛匹配出价金额。 |
| 内容匹配出价 | 指关键字 (keyword) 的内容匹配出价金额。 |
| 自定义参数 | 指关键字 (keyword) 的自定义参数。 |
| 编辑状态 | 指关键字 (keyword) 的编辑状态。 如果关键字 (keyword) 正在等待脱机编辑评审，则在下载的更改历史记录报表中，编辑状态表示为挂起 - 活动或挂起 - 非活动。 有关详细信息，请参阅 实体和传递状态。 |
| 完全匹配出价 | 指关键字 (keyword) 的完全匹配出价金额。 |
| 最终 URL | 指关键字 (keyword) 的最终 URL。 |
| 移动 URL | 指关键字 (keyword) 的最终移动 URL。 |
| 匹配类型 | 指关键字 (keyword) 的出价匹配类型。 无法使用必应广告 API 更新出价匹配类型;但是，可以使用 Microsoft Advertising Web 应用程序更改出价匹配类型。 |
| 短语匹配出价 | 指关键字 (keyword) 的短语匹配出价金额。 |
| 状态 | 指关键字 (keyword) 的传递状态。 如果报告已删除关键字 (keyword) ，则 ItemChanged 字段为 Status，HowChanged 字段为 Changed，NewValue 字段为 Deleted。 |
| 跟踪模板 | 指关键字 (keyword) 的跟踪模板。 |
位置扩展
当 ItemChanged 字段的值为 Location extension 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 关联 | 指位置扩展与实体的关联。 例如，如果扩展与市场活动关联，则 CampaignName 字段的值是关联的市场活动的名称，ItemChanged 字段的值为 Location extension，AttributeChanged 字段的值为 Association，HowChanged 字段的值为 Added。 |
否定关键字列表
当 ItemChanged 字段的值为“负关键字列表”时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 关联 | 指否定关键字列表与市场活动的关联。 例如，如果负关键字 (keyword) 列表与市场活动相关联，则 CampaignName 字段的值是关联市场活动的名称，ItemChanged 字段的值为 Negative Keyword List，AttributeChanged 字段的值为 Association，HowChanged 字段的值为 Added。 |
| 负关键字 (keyword) | 指从负关键字 (keyword) 列表中添加或删除的负关键字 (keyword) 。 |
| 负关键字列表名称 | 指负关键字 (keyword) 列表的名称。 |
Sitelink 扩展
当 ItemChanged 字段的值为 Sitelink 扩展时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 关联 | 指站点链接扩展与实体的关联。 例如，如果扩展与市场活动关联，则 CampaignName 字段的值是关联市场活动的名称，ItemChanged 字段的值为 Sitelink 扩展，AttributeChanged 字段的值为 Association，HowChanged 字段的值为 Added。 |
| 自定义参数 | 引用站点链接的自定义参数。 |
| 目标 URL | 指 sitelink 扩展的目标 URL。 |
| 显示文本 | 指 sitelink 扩展的显示文本。 |
| 最终 URL | 指站点链接的最终 URL。 |
| 移动 URL | 指站点链接的最终移动 URL。 |
| 跟踪模板 | 指站点链接的跟踪模板。 |
用户
当 ItemChanged 字段的值为 User 时，以下属性的更改历史记录可用。
| 属性已更改 | 说明 |
|---|---|
| 无 (空白) | 指已添加的用户的用户名。 相应 HowChanged 字段的值为 Added。 |
| 代码 | 供内部使用。 |
| 电子邮件 | 指用户的联系人电子邮件地址。 |
| 名 | 指用户的名字。 |
| 姓 | 指用户的姓氏。 |
| 状态 | 指用户的状态。 |
要求
服务： ReportingService.svc v13
命名 空间： https://bingads.microsoft.com/Reporting/v13