SearchQueryPerformanceReportColumn 值集 - 报告
定义可包含在 SearchQueryPerformanceReportRequest 中的属性和性能统计信息列。
报表将仅包含过去 30 天内导致大量点击的搜索词的数据。
由于此数据可能会随时间而更改，因此请使用关键字性能报告来获取关键字的性能指标。
报表中包含的属性列可能会影响统计信息的聚合方式。 换句话说，行数会增加唯一属性的一个因素。 有关详细信息，请参阅 对数据进行分组的列。
有关必须包含的列的列表，请参阅下面的 “必需列” 部分。
若要查看报表的每小时、每日、每周、每月、每年和汇总聚合数据的检索距离，请参阅 报表数据保留时间段。
语法
<xs:simpleType name="SearchQueryPerformanceReportColumn" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:restriction base="xs:string">
<xs:enumeration value="AccountName" />
<xs:enumeration value="AccountNumber" />
<xs:enumeration value="AccountId" />
<xs:enumeration value="TimePeriod" />
<xs:enumeration value="CampaignName" />
<xs:enumeration value="CampaignId" />
<xs:enumeration value="AdGroupName" />
<xs:enumeration value="AdGroupId" />
<xs:enumeration value="AdId" />
<xs:enumeration value="AdType" />
<xs:enumeration value="DestinationUrl" />
<xs:enumeration value="BidMatchType" />
<xs:enumeration value="DeliveredMatchType" />
<xs:enumeration value="CampaignStatus" />
<xs:enumeration value="AdStatus" />
<xs:enumeration value="Impressions" />
<xs:enumeration value="Clicks" />
<xs:enumeration value="Ctr" />
<xs:enumeration value="AverageCpc" />
<xs:enumeration value="Spend" />
<xs:enumeration value="AveragePosition" />
<xs:enumeration value="SearchQuery" />
<xs:enumeration value="Keyword" />
<xs:enumeration value="AdGroupCriterionId" />
<xs:enumeration value="Conversions" />
<xs:enumeration value="ConversionRate" />
<xs:enumeration value="CostPerConversion" />
<xs:enumeration value="Language" />
<xs:enumeration value="KeywordId" />
<xs:enumeration value="Network" />
<xs:enumeration value="TopVsOther" />
<xs:enumeration value="DeviceType" />
<xs:enumeration value="DeviceOS" />
<xs:enumeration value="Assists" />
<xs:enumeration value="Revenue" />
<xs:enumeration value="ReturnOnAdSpend" />
<xs:enumeration value="CostPerAssist" />
<xs:enumeration value="RevenuePerConversion" />
<xs:enumeration value="RevenuePerAssist" />
<xs:enumeration value="AccountStatus" />
<xs:enumeration value="AdGroupStatus" />
<xs:enumeration value="KeywordStatus" />
<xs:enumeration value="CampaignType" />
<xs:enumeration value="CustomerId" />
<xs:enumeration value="CustomerName" />
<xs:enumeration value="AllConversions" />
<xs:enumeration value="AllRevenue" />
<xs:enumeration value="AllConversionRate" />
<xs:enumeration value="AllCostPerConversion" />
<xs:enumeration value="AllReturnOnAdSpend" />
<xs:enumeration value="AllRevenuePerConversion" />
<xs:enumeration value="Goal" />
<xs:enumeration value="GoalType" />
<xs:enumeration value="AbsoluteTopImpressionRatePercent" />
<xs:enumeration value="TopImpressionRatePercent" />
<xs:enumeration value="AverageCpm" />
<xs:enumeration value="ConversionsQualified" />
<xs:enumeration value="AllConversionsQualified" />
</xs:restriction>
</xs:simpleType>
值
SearchQueryPerformanceReportColumn 值集具有以下值：AbsoluteTopImpressionRatePercent、AccountId、AccountName、AccountNumber、AccountStatus、AdGroupCriterionId、AdGroupId、AdGroupName、AdGroupStatus、AdId、AdStatus、AdType、AllConversionRate、AllConversions、AllConversionsQualifiedAllCostPerConversion、AllReturnOnAdSpend、AllRevenue、AllRevenuePerConversion、Assists、AverageCpc、AverageCpm、AveragePosition、BidMatchType、CampaignId、CampaignName、CampaignStatus、CampaignType、Clicks、ConversionRate、ConversionsQualified、CostPerAssist、CostPerConversion、Ctr、CustomerId、CustomerName、DeliveredMatchType、DestinationUrl、DeviceOS、DeviceType、Target、GoalType、Impressions、Keyword、KeywordId、KeywordStatus、Language、Network、ReturnOnAdSpend、Revenue、RevenuePerAssist、RevenuePerConversion、SearchQuery、Spend、TimePeriod、TopImpressionRatePercent、TopVsOther。
| 值 | 说明 |
|---|---|
| AbsoluteTopImpressionRatePercent | 广告在所有结果的第一位置出现的频率（占总展示次数的百分比）。 较高的数字表示广告经常显示在最佳广告位置。 如果数据不可用，则此列的值为空。 不支持 Hourly 或 HourOfDay 聚合。 如果将此列包含在 Hourly 或 HourOfDay 聚合中，则服务不会返回错误，并且应忽略为此列返回的任何性能数据。 |
| AccountId | Microsoft广告分配的帐户标识符。 |
| AccountName | 帐户名称。 |
| AccountNumber | Microsoft广告分配的帐户数。 |
| AccountStatus | 帐户状态。 |
| AdGroupCriterionId | 广告组条件的Microsoft广告分配标识符。 |
| AdGroupId | Microsoft广告组分配的标识符。 |
| AdGroupName | 广告组名称。 |
| AdGroupStatus | 广告组状态。 |
| AdId | Microsoft广告分配的标识符。 |
| AdStatus | 广告状态。 |
| AdType | 广告类型。 |
| AllConversionRate | 以百分比表示的转换率。 转换次数除以单击总数。 例如，如果市场活动中的广告获得了 300 次点击和 4 次转换，则转换率为 1.33 (%) 。 用于计算转换率的公式是 (转换/单击) x 100。 对于 ExcludeFromBidding 属性设置为 true 的任何转换目标，将从 ConversionRate 报表列中排除数据。 AllConversionRate 列将包括所有转换目标的数据，而不管其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| AllConversions | 转换的次数。 转换是客户在查看广告后完成的操作。 该操作可能是购买你的产品、注册网络研讨会、加入组织，或者你认为你的目标以及广告成功率的最佳衡量标准。 通过向网站页面添加少量代码来衡量转换，以便跟踪访问者在网站中的进度。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的转换报告列中排除数据。 AllConversions 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 此列自 2022 年已弃用，因此应改用 AllConversionsQualified 列。 今后，性能报告将在此列中返回“0” (零) 。 根据已发布 的数据保留期，在弃用日期之前的时间段内的历史数据仍可用。 |
| AllConversionsQualified | 转换的次数。 转换是客户在查看广告后完成的操作。 该操作可能是购买你的产品、注册网络研讨会、加入组织，或者你认为你的目标以及广告成功率的最佳衡量标准。 通过向网站页面添加少量代码来衡量转换，以便跟踪访问者在网站中的进度。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的转换报告列中排除数据。 AllConversions 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 无论是否存在部分外部特性化脱机转换，都应期望数据类型为 double 。 还不是每个人都有此功能。 如果你没有，别担心 - 它即将推出！ |
| AllCostPerConversion | 每次转换的成本。 用于计算每次转换成本的公式 (支出/转换) 。 只有启用转换跟踪的营销活动中的广告才会影响转换编号，因此除非帐户中的所有市场活动都启用了转换跟踪，否则该数字将不准确。 对于 ExcludeFromBidding 属性设置为 true 的任何转换目标，数据将从 CostPerConversion 报表列中排除。 AllCostPerConversion 列将包括所有转换目标的数据，而不管其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| AllReturnOnAdSpend | 广告支出的回报 (ROAS) 。 用于计算 ROM 的公式 (收入/支出) 。 对于将 ExcludeFromBidding 属性设置为 true 的任何转换目标，数据将从 ReturnOnAdSpend 报表列中排除。 AllReturnOnAdSpend 列将包括所有转换目标的数据，而不管其 ExcludeFromBiding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| AllRevenue | 广告客户选择性地报告因转换而报告的收入。 任何转换目标的数据将从 “收入 报告”列中排除，并将 ExcludeFromBidding 属性设置为 true。 AllRevenue 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| AllRevenuePerConversion | 每次转换的收入。 用于计算每次转换收入的公式 (收入/转换) 。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的 RevenuePerConversion 报表列中排除数据。 AllRevenuePerConversion 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| 协助 | 来自同一帐户中其他广告的转换数，该广告之前点击了一次或多次。 如果在最近点击的广告之前点击了该广告，则视为该广告有助于转换。 此外，与助攻对应的单击必须在目标转换期间进行。 |
| AverageCpc | 每次点击的平均成本 (CPC) 。 广告上所有点击的总成本除以点击次数。 这是每次点击广告时实际收取的平均费用。 例如，如果共为 300 次点击支付了 48.35 次，则平均 CPC 为 0.16。 用于计算平均 CPC 的公式是 (支出/单击) 。 |
| AverageCpm | 广告总成本除以数千) (展示次数。<br/ 在拉丁语中，mille 的意思是一千。 此外，有时称为每千 (CPT) 的平均成本。 这是一个标准广告行业绩效指标，我们根据你的支出和展示次数来计算。 基于 CPM 的广告预算的目标是向大量受众建立品牌认知度。 CPM 会告知你向目标用户类型投放广告的费用。 |
| AveragePosition | 广告在网页上的平均位置。 自 2021 年 3 月 31 日起，此列已弃用。 今后，性能报告将返回平均位置“0” (零) 。 根据每个报告类型的已发布 数据保留期 ，仍将提供弃用日期之前时间段的历史平均位置数据。 |
| BidMatchType | 关键字出价匹配类型。 这可以不同于 DeliveredMatchType 列，例如，如果竞价的是广泛匹配项，而搜索词是完全匹配项。 有关详细信息，请参阅 预算和投标策略。 可能的值包括“Broad”、“Exact”、“Phrase”和“Unknown”。 |
| CampaignId | 市场活动的Microsoft广告分配标识符。 |
| CampaignName | 市场活动名称。 |
| CampaignStatus | 市场活动状态。 |
| CampaignType | 市场活动类型。 可能的值包括 访问群体、 动态搜索、 搜索 & 内容和 购物。 |
| 点击 | 点击是你支付的费用。 点击通常包括客户单击搜索结果页上或搜索网络上的网站上的广告。 点击也可以来自其他来源 (例如蜘蛛、机器人和测试服务器) 。 有关详细信息，请参阅 Microsoft广告点击度量：方法说明。 |
| ConversionRate | 以百分比表示的转换率。 转换次数除以单击总数。 例如，如果市场活动中的广告获得了 300 次点击和 4 次转换，则转换率为 1.33 (%) 。 用于计算转换率的公式是 (转换/单击) x 100。 对于 ExcludeFromBidding 属性设置为 true 的任何转换目标，将从 ConversionRate 报表列中排除数据。 AllConversionRate 列将包括所有转换目标的数据，而不管其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| 转换 | 转换的次数。 转换是客户在查看广告后完成的操作。 该操作可能是购买你的产品、注册网络研讨会、加入组织，或者你认为你的目标以及广告成功率的最佳衡量标准。 通过向网站页面添加少量代码来衡量转换，以便跟踪访问者在网站中的进度。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的转换报告列中排除数据。 AllConversions 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 此列自 2022 年已弃用，因此应改用 ConversionsQualified 列。 今后，性能报告将在此列中返回“0” (零) 。 根据已发布 的数据保留期，在弃用日期之前的时间段内的历史数据仍可用。 |
| ConversionsQualified | 转换的次数。 转换是客户在查看广告后完成的操作。 该操作可能是购买你的产品、注册网络研讨会、加入组织，或者你认为你的目标以及广告成功率的最佳衡量标准。 通过向网站页面添加少量代码来衡量转换，以便跟踪访问者在网站中的进度。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的转换报告列中排除数据。 AllConversions 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 无论是否存在部分外部特性化脱机转换，都应期望数据类型为 double 。 还不是每个人都有此功能。 如果你没有，别担心 - 它即将推出！ |
| CostPerAssist | 每次协助的费用。 计算每个助手成本的公式 是 (支出/协助) 。 |
| CostPerConversion | 每次转换的成本。 用于计算每次转换成本的公式 (支出/转换) 。 只有启用转换跟踪的营销活动中的广告才会影响转换编号，因此除非帐户中的所有市场活动都启用了转换跟踪，否则该数字将不准确。 对于 ExcludeFromBidding 属性设置为 true 的任何转换目标，数据将从 CostPerConversion 报表列中排除。 AllCostPerConversion 列将包括所有转换目标的数据，而不管其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| 点击率 | 点击率 (点击率) 是广告被点击的次数除以广告 (展示) 的次数。 例如，如果你的广告在 2,348 次展示中获得了 50 次点击，则你的 CTR 为 2.13 (%) 。 用于计算 CTR 的公式是 ) x 100 (点击/展示次数。 |
| CustomerId | 客户的Microsoft广告分配标识符。 |
| CustomerName | 客户名称。 |
| DeliveredMatchType | 用于传递广告的匹配类型。 这可以不同于 BidMatchType 列，例如，如果对广泛匹配进行出价，并且搜索词完全匹配。 有关详细信息，请参阅 预算和投标策略。 可能的值包括“Broad”、“Exact”、“Exact (close variant) ”、“Phrase”、“Phrase (close variant) ”和“Unknown”。 从 2019 年 10 月开始，搜索词 (（即搜索查询) 报告）中提供了“精确 (关闭变体) ”和“短语 (关闭变体) ”提供的匹配类型。 这些匹配类型的数据在 2019 年 7 月的时间段内可用。 2019 年 7 月之前的搜索词报告数据以及其他报表类型的数据将不包括“关闭变体”详细信息。 例如，如果搜索词传递的匹配类型为“Exact”或“Exact (close variant) ”，则关键字性能报告会将传递的匹配类型返回为“Exact”。 同样，如果搜索词传递的匹配类型为“Phrase”或“Phrase (close variant) ”，则关键字性能报告会将传递的匹配类型返回为“Phrase”。 “Exact”和“Exact (close variant) ”之和的性能指标应与同一搜索词的其他报表中的性能指标匹配。 例如，如果搜索词报表包含 3 个“精确 (接近变体) ”的印象和 2 次“精确”的印象，则 (假设相同关键字的等效日期范围、筛选器或其他报告条件) ，关键字性能报告中应有 5 次展示。 |
| DestinationUrl | 广告、关键字或广告组条件的目标 URL 属性。 如果目标 URL 包含动态文本替换参数 (例如 {param1}) ，则替换发生后，报表将包含该 URL。 |
| DeviceOS | 在 DeviceType 列中报告的设备的操作系统。 可能的值包括 Android、 Blackberry、 iOS、 Other、 Unknown 和 Windows。 如果无法确定设备的操作系统或不是可面向的操作系统之一，则此列中的值将为 “未知”。 |
| DeviceType | 设备 OS 目标出价的设备名称属性。 显示广告的设备类型。 可能的值包括 “计算机”、“ 智能手机”、“ 平板电脑”和 “未知”。 |
| 目标 | 你为所需转换设置的目标的名称，表示客户在点击广告后执行的操作。 |
| GoalType | 转换目标的类型。 可能的值包括 AppInstall、 Duration、 Event、 InStoreTransaction、 OfflineConversion、 PagesViewedPerVisit 和 Url。 |
| 展现量 | 广告在搜索结果页面上的显示次数。 如果没有展示，就没有点击或转换。 |
| 关键字 | 关键字文本。 |
| KeywordId | Microsoft广告分配的关键字标识符。 |
| KeywordStatus | 关键字状态。 |
| 语言 | 显示广告的发布者的语言。 有关可能的值，请参阅广告语言的 “语言”列。 语言显示名称将在报表中提供，例如 英语。 |
| 网络 | 整个Microsoft广告网络由Microsoft网站和选择流量组成，自 2024 年 7 月) 起，仅此网络类型 (合作伙伴流量已弃用。 使用此数据对广告组的网络选择做出最佳决策。 可能的值包括 AOL 搜索、受众、Microsoft网站和选择流量、内容和联合搜索合作伙伴。 注意：并非所有人都可以 使用值Microsoft网站并选择流量 。 如果你不能，别担心 - 它即将推出！ |
| ReturnOnAdSpend | 广告支出的回报 (ROAS) 。 用于计算 ROM 的公式 (收入/支出) 。 对于将 ExcludeFromBidding 属性设置为 true 的任何转换目标，数据将从 ReturnOnAdSpend 报表列中排除。 AllReturnOnAdSpend 列将包括所有转换目标的数据，而不管其 ExcludeFromBiding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| 收入 | 广告客户选择性地报告因转换而报告的收入。 任何转换目标的数据将从 “收入 报告”列中排除，并将 ExcludeFromBidding 属性设置为 true。 AllRevenue 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| RevenuePerAssist | 每个协助的收入。 用于计算每个助手收入的公式 (收入/助手) 。 |
| RevenuePerConversion | 每次转换的收入。 用于计算每次转换收入的公式 (收入/转换) 。 如果 ExcludeFromBidding 属性设置为 true，则会从任何转换目标的 RevenuePerConversion 报表列中排除数据。 AllRevenuePerConversion 列将包括所有转换目标的数据，无论其 ExcludeFromBidding 设置如何。 适用于设置为将分析与 Microsoft 广告通用事件跟踪配合使用的帐户。 有关详细信息，请参阅 跟踪销售和其他转换 帮助主题。 |
| SearchQuery | 潜在受众使用的搜索词。 |
| 花费 | 每次单击费用 (每次点击) 总和。 |
| TimePeriod | 每个报表行的时间段。 如果请求对象的 Aggregation 元素设置为 Summary，则不能包含此列。 有关详细信息，请参阅 时间段列。 |
| TopImpressionRatePercent | 广告在主线（广告显示在搜索结果上方的顶部位置）中占总展示次数的百分比。 这指示广告位置的变化如何影响性能。 如果数据不可用，则此列的值为空。 不支持 Hourly 或 HourOfDay 聚合。 如果将此列包含在 Hourly 或 HourOfDay 聚合中，则服务不会返回错误，并且应忽略为此列返回的任何性能数据。 |
| TopVsOther | 指示广告展示是显示在顶部位置还是其他位置。 可能的值包括 AOL 搜索 - Top、AOL 搜索 - 其他、受众网络、必应和 Yahoo！ search - Top、必应和 Yahoo！ search - 其他、联合搜索合作伙伴 - Top、Syndicated 搜索合作伙伴 - 其他、内容网络和未知。 |
备注
所需列
报表必须至少包含以下列。 一般情况下，每个报表必须至少包含一个属性列和至少一个非印象共享性能统计信息列。 有关详细信息，请参阅 报表属性和性能统计信息。
注意
除“摘要”之外，所有聚合类型都应使用 TimePeriod 列。 请务必注意，如果未包括 TimePeriod，则将忽略所选聚合，并且无论如何都将使用摘要聚合。
| Column |
|---|
| SearchQuery |
| TimePeriod |
要求
服务： ReportingService.svc v13
命名空间： https://bingads.microsoft.com/Reporting/v13