ShareOfVoiceReportFilter Data Object - Reporting

Defines the criteria to use to filter the share of voice report data.

Syntax

<xs:complexType name="ShareOfVoiceReportFilter" 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 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 minOccurs="0" name="KeywordStatus" nillable="true" type="tns:KeywordStatusReportFilter" />
    <xs:element xmlns:q13="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Keywords" nillable="true" type="q13:ArrayOfstring" />
    <xs:element minOccurs="0" name="Language" nillable="true" type="tns:LanguageReportFilter" />
  </xs:sequence>
</xs:complexType>

Elements

The ShareOfVoiceReportFilter object has the following elements: AccountStatus, AdDistribution, AdGroupStatus, BidMatchType, BidStrategyType, CampaignStatus, DeliveredMatchType, DeviceType, Keywords, KeywordStatus, Language.

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
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 only for expanded text ads displayed on smartphones.

You can specify one or more device types.
DeviceTypeReportFilter
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
Language The report will include data for only websites that used the specified languages.

You can specify one or more languages.
LanguageReportFilter

Requirements

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

Used By

ShareOfVoiceReportRequest