Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Defines a Search Term Landing Page report request. Use this request with the SubmitGenerateReport operation to generate a report that includes the search term, delivered headline, and landing page URL for each ad impression.
Syntax
<xs:complexType name="SearchTermLandingPageReportRequest" 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:ArrayOfSearchTermLandingPageReportColumn" />
<xs:element minOccurs="0" name="Filter" nillable="true" type="tns:SearchTermLandingPageReportFilter" />
<xs:element name="Scope" nillable="true" type="tns:AccountThroughCampaignReportScope" />
<xs:element name="Time" nillable="true" type="tns:ReportTime" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elements
The SearchTermLandingPageReportRequest object has the following elements: Aggregation, Columns, Filter, Scope, Time.
| Element | Description | Data Type |
|---|---|---|
| Aggregation | The type of aggregation to use to aggregate the report data. For example, you can aggregate the report data by day or week. Supported values are Hourly, Daily, We*ekly, Monthly, Yearly, DayOfWeek, and HourOfDay. This element is required. |
ReportAggregation |
| Columns | The list of attributes and performance statistics to include in the report. The report will include the columns in the order that you specify them. You must specify Final URL and at least one performance statistics column, e.g., Impressions. This element is required. |
SearchTermLandingPageReportColumn array |
| Filter | The filter information to use to filter the report data. This element is optional. |
SearchTermLandingPageReportFilter |
| Scope | The entities and their scope to include in the report. Use this element to limit the report data to specific accounts and campaigns. This element is required. |
AccountThroughCampaignReportScope |
| Time | The time frame to use to aggregate the report data. You can specify a custom date range or select a predefined date range, for example, Today or ThisWeek. This element is required. |
ReportTime |
The SearchTermLandingPageReportRequest object has Inherited Elements.
Inherited Elements
Inherited Elements from ReportRequest
The SearchTermLandingPageReportRequest object derives from the ReportRequest object, and inherits the following elements: ExcludeColumnHeaders, ExcludeReportFooter, ExcludeReportHeader, Format, FormatVersion, ReportName, ReturnOnlyCompleteData. The descriptions below are specific to SearchTermLandingPageReportRequest, and might not apply to other objects that inherit the same elements from the ReportRequest object.
| Element | Description | Data Type |
|---|---|---|
| ExcludeColumnHeaders | Determines whether or not the report includes header descriptions for each column of data. This element is optional and defaults to false. |
boolean |
| ExcludeReportFooter | Determines whether or not the report includes footer information such as copyright. This element is optional and defaults to false. |
boolean |
| ExcludeReportHeader | Determines whether or not the report includes header information such as the report name and date range. This element is optional and defaults to false. |
boolean |
| Format | The format of the report file. For example you can specify to have the report data written to a file that uses comma-separated values (CSV). This element is optional and defaults to Csv. |
ReportFormat |
| FormatVersion | The format version of the report file. This element is optional. |
string |
| ReportName | The name of the report. The name will be used as the name of the download file. This element is optional. |
string |
| ReturnOnlyCompleteData | Determines whether the operation returns data for only fully processed time periods. This element is optional and defaults to false. |
boolean |
Requirements
Service: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13