通过

SearchQueryPerformanceReportRequest 数据对象 - 报告

  • 项目

定义搜索查询性能报告请求。 使用此报表查看显示广告时受众正在搜索的内容。 可以使用此信息对关键字 (keyword) 列表和负关键字 (keyword) 列表进行明智的添加、删除或编辑。

您可以请求已触发广告的搜索词的展示次数、点击次数、点击率和平均位置。 例如，如果你是抵押贷款贷款人，他正在开展具有以下关键字的竞选活动：抵押贷款、住房抵押贷款和房屋权益贷款;报告显示，搜索查询“抵押贷款利率”会导致广告的很多印象，你可能会在关键字 (keyword) 列表中添加“利率”。 但是，如果不提供反向抵押贷款，并且报告显示搜索查询“反向抵押贷款”会导致许多印象，你可能会将“反向抵押贷款”添加到否定关键字列表。

报告将仅包含在过去 30 天内导致大量点击的搜索词。

由于此数据可能会随着时间的推移而更改，因此请使用 KeywordPerformanceReportRequest 获取关键字的性能指标。

若要请求此类型的报表，请将此对象传递给 SubmitGenerateReport 操作。

语法

<xs:complexType name="SearchQueryPerformanceReportRequest" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ReportRequest">
      <xs:sequence>
        <xs:element name="Aggregation" type="tns:ReportAggregation" />
        <xs:element name="Columns" nillable="true" type="tns:ArrayOfSearchQueryPerformanceReportColumn" />
        <xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchQueryPerformanceReportFilter" />
        <xs:element name="Scope" nillable="true" type="tns:AccountThroughAdGroupReportScope" />
        <xs:element name="Time" nillable="true" type="tns:ReportTime" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

SearchQueryPerformanceReportRequest 对象具有以下元素：Aggregation、Columns、Filter、Scope、Time。

元素 说明 数据类型
集合体 用于聚合报表数据的聚合类型。 例如，可以按天或周聚合报表数据，或者请求摘要报表。

默认聚合为“摘要”。 请务必注意，如果未在 列列表中包括 TimePeriod，则将忽略所选聚合，并且无论如何都会使用摘要聚合。		 ReportAggregation
列数 要包含在报表中的属性和性能统计信息的列表。 报表将按指定列的顺序包含列。 SearchQueryPerformanceReportColumn 数组
筛选器 用于筛选报表数据的筛选器信息。 SearchQueryPerformanceReportFilter
范围 报表的实体范围。

使用此元素将报表数据限制为特定帐户、广告组或市场活动。		 AccountThroughAdGroupReportScope
时间 用于报表的时间段。 可以指定自定义日期范围或选择预定义的日期范围，例如 Today 或 ThisWeek。

有关可为每个聚合类型指定的时间段的列表，请参阅 聚合和时间。

可以在 ReportTime 对象中设置时区，这有助于准确确定所请求时间段的数据范围。

如果未选择时区，则报告服务默认使用 PacificTimeUSCanadaTijuana。		 ReportTime

SearchQueryPerformanceReportRequest 对象具有 Inherited Elements。

继承的元素

从 ReportRequest 继承的元素

SearchQueryPerformanceReportRequest 对象派生自 ReportRequest 对象，并继承以下元素：ExcludeColumnHeaders、ExcludeReportFooter、ExcludeReportHeader、Format、FormatVersion、ReportName、ReturnOnlyCompleteData。 下面的说明特定于 SearchQueryPerformanceReportRequest，可能不适用于从 ReportRequest 对象继承相同元素的其他对象。

元素 说明 数据类型
ExcludeColumnHeaders 确定下载的报表是否应包含每列的标题说明。 报表列标题与请求的列名称匹配，例如“展示次数”和“点击次数”。

如果希望从下载的报表中排除报表列标题，请将此属性设置为 true 。 默认值为 false。		 boolean
ExcludeReportFooter 确定下载的报表是否应包含页脚元数据，例如Microsoft版权 (@2020 Microsoft Corporation。保留所有权限。) 。

如果希望从下载的报表中排除报表页脚元数据，请将此属性设置为 true 。 默认值为 false。		 boolean
ExcludeReportHeader 确定下载的报表是否应包含标头元数据，例如报表名称、日期范围和聚合。

如果希望从下载的报表中排除报表标头元数据，请将此属性设置为 true 。 默认值为 false。		 boolean
格式 报表数据的格式。 例如，可以请求以逗号分隔值 (Csv) 格式或制表符分隔值 (Tsv) 格式的数据。

默认值为 Csv。

所有下载的文件都是 ZIP 压缩的。		 ReportFormat
FormatVersion 确定下载的报表文件中某些字段的格式。

某些字段的数据格式可以在当前 API 版本中更新，而不会中断现有客户端应用程序。 可以通过将此可选请求字段设置为 2.0 来获取最新的数据格式。 如果未设置此字段，则服务默认为版本 1.0。

有关格式版本之间的更改的详细信息，请参阅 报表格式版本。		 string
ReportName 报表的名称。 名称包含在报表标头中。 如果未指定报表名称，系统会以 ReportType-ReportDateTime 格式生成名称。

报表名称的最大长度为 200。		 string
ReturnOnlyCompleteData 确定服务是否必须确保所有数据都已处理且可用。

如果设置为 true ，并且系统尚未根据请求的 聚合、 范围和 时间完成所有数据的处理，则服务将返回错误代码 NoCompleteDataAvaliable (2004) 。 否则，默认情况下，请求可以成功，则不会指示数据是否完成，并且报告将仅包含系统在请求时已完成处理的数据。

请注意，由于今天仍在进行中，并且数据不完整，因此如果“时间段” (自定义日期还是预定义日期) 包括今天日期，则无法将此元素设置为 true。 有关详细信息，请参阅 Reporting 中的时区。		 boolean

要求

服务： ReportingService.svc v13
Namespace： https://bingads.microsoft.com/Reporting/v13