KeywordPerformanceReportFilter Data Object - Reporting

Defines the criteria to use to filter the keyword performance report data.

Syntax

<xs:complexType name="KeywordPerformanceReportFilter" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AccountStatus" nillable="true" type="tns:AccountStatusReportFilter" />
    <xs:element minOccurs="0" name="AdDistribution" nillable="true" type="tns:AdDistributionReportFilter" />
    <xs:element minOccurs="0" name="AdGroupStatus" nillable="true" type="tns:AdGroupStatusReportFilter" />
    <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AdRelevance" nillable="true" type="q4:ArrayOfint" />
    <xs:element minOccurs="0" name="AdType" nillable="true" type="tns:AdTypeReportFilter" />
    <xs:element minOccurs="0" name="BidMatchType" nillable="true" type="tns:BidMatchTypeReportFilter" />
    <xs:element minOccurs="0" name="BidStrategyType" nillable="true" type="tns:BidStrategyTypeReportFilter" />
    <xs:element minOccurs="0" name="CampaignStatus" nillable="true" type="tns:CampaignStatusReportFilter" />
    <xs:element minOccurs="0" name="DeliveredMatchType" nillable="true" type="tns:DeliveredMatchTypeReportFilter" />
    <xs:element minOccurs="0" name="DeviceType" nillable="true" type="tns:DeviceTypeReportFilter" />
    <xs:element xmlns:q5="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ExpectedCtr" nillable="true" type="q5:ArrayOfint" />
    <xs:element minOccurs="0" name="KeywordStatus" nillable="true" type="tns:KeywordStatusReportFilter" />
    <xs:element xmlns:q6="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Keywords" nillable="true" type="q6:ArrayOfstring" />
    <xs:element xmlns:q7="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="LandingPageExperience" nillable="true" type="q7:ArrayOfint" />
    <xs:element minOccurs="0" name="Language" nillable="true" type="tns:LanguageReportFilter" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="QualityScore" nillable="true" type="q8:ArrayOfint" />
  </xs:sequence>
</xs:complexType>

Elements

The KeywordPerformanceReportFilter object has the following elements: AccountStatus, AdDistribution, AdGroupStatus, AdRelevance, AdType, BidMatchType, BidStrategyType, CampaignStatus, DeliveredMatchType, DeviceType, ExpectedCtr, Keywords, KeywordStatus, LandingPageExperience, Language, QualityScore.

Element	Description	Data Type
AccountStatus	The report will include data for only the account status. For example, you can use the filter to include data for only active accounts. You can specify one or more account statuses.	AccountStatusReportFilter
AdDistribution	The report will include data for only the specified distribution medium. For example, you can use the filter to include data for only search ads. You can specify one or more distribution mediums.	AdDistributionReportFilter
AdGroupStatus	The report will include data for only the ad group status. For example, you can use the filter to include data for only active ad groups. You can specify one or more ad group statuses.	AdGroupStatusReportFilter
AdRelevance	How closely related your ads is to the customer's search query or other input. It tells you how relevant your ad and landing page are to potential customers. A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average. If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score. Data for this column is typically updated 14-18 hours after the UTC day ends.	int array
AdType	The report will include data for only the specified ad types. For example, the report can include data for product or expanded text ads. You can specify one or more ad types.	AdTypeReportFilter
BidMatchType	The report will include data for only the specified bid match types. For example, you can use the filter to include data for ads that were bid on using the exact or phrase match type. You can specify one or more bid match types. To filter on delivered match types, see the DeliveredMatchType element.	BidMatchTypeReportFilter
BidStrategyType	The report will include data for only the specified bid strategy type or types. For example, you can use the filter to include data only for keywords that were bid on using the enhanced bid strategy type. You can specify one or more bid strategy types.	BidStrategyTypeReportFilter
CampaignStatus	The report will include data for only the campaign status. For example, you can use the filter to include data for only active campaigns. You can specify one or more campaign statuses.	CampaignStatusReportFilter
DeliveredMatchType	The report will include data for only the specified delivered match types. For example, you can use the filter to include data for ads that were delivered using the exact or phrase match type. You can specify one or more delivered match types. To filter on bid match types, see the BidMatchType element.	DeliveredMatchTypeReportFilter
DeviceType	The report will include data for only the specified types of devices on which the ad is displayed. For example, you can use the filter to include data for only text ads displayed on smartphones. You can specify one or more device types.	DeviceTypeReportFilter
ExpectedCtr	How well your keyword competes against other keywords targeting the same traffic. Ads that are relevant to searchers' queries or other input are more likely to have a higher click-through rate. This metric tells you if a keyword is underperforming and causing a loss in impression share, so you can make keyword changes or remove ads altogether. A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average. If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score. Data for this column is typically updated 14-18 hours after the UTC day ends.	int array
Keywords	The report will include data for only the specified keywords. You can specify a maximum of 75 keywords. Each keyword can contain a maximum of 100 characters.	string array
KeywordStatus	The report will include data for only the keyword status. For example, you can use the filter to include data for only active keywords. You can specify one or more keyword statuses.	KeywordStatusReportFilter
LandingPageExperience	An aggregate quality assessment of all landing pages on your site. The landing page experience score measures whether your landing page is likely to provide a good experience to customers who click your ad and land on your website. A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average. If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score. Data for this column is typically updated 14-18 hours after the UTC day ends.	int array
Language	The report will include data for only websites that used the specified languages. You can specify one or more languages.	LanguageReportFilter
QualityScore	The report will include data for only keywords with the specified quality scores. You can filter the report based on one or more of the following relevance values: 0 - N/A (as shown in the web application) 1 - Underperforming 2 - Underperforming 3 - Underperforming 4 - Underperforming 5 - Underperforming 6 - Average performance 7 - Competitive 8 - Competitive 9 - Competitive 10 - Competitive	int array

Requirements

Service: ReportingService.svc v13
Namespace: https://bingads.microsoft.com/Reporting/v13

Used By

KeywordPerformanceReportRequest