AdPosition Value Set - Ad Insight

Defines the possible positions of an ad in the search results.

Note

Sidebar ads no longer serve on Bing owned and operated sites in the United States. If you only request first page data e.g., FirstPage1 for the United States (US), then the KeywordKPIs element in the result will be nil/empty. If you include additional countries/regions e.g., US and CA in the same request, then any first page results are only attributed to countries/regions outside the United States.

Syntax

<xs:simpleType name="AdPosition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="All" />
    <xs:enumeration value="MainLine1" />
    <xs:enumeration value="MainLine2" />
    <xs:enumeration value="MainLine3" />
    <xs:enumeration value="MainLine4" />
    <xs:enumeration value="FirstPage1" />
    <xs:enumeration value="FirstPage2" />
    <xs:enumeration value="FirstPage3" />
    <xs:enumeration value="FirstPage4" />
    <xs:enumeration value="FirstPage5" />
    <xs:enumeration value="FirstPage6" />
    <xs:enumeration value="FirstPage7" />
    <xs:enumeration value="FirstPage8" />
    <xs:enumeration value="FirstPage9" />
    <xs:enumeration value="FirstPage10" />
    <xs:enumeration value="Aggregate" />
  </xs:restriction>
</xs:simpleType>

Values

Value Description
Aggregate Aggregates the data for all supported positions.

The following are examples of how the data is aggregated: Average bid would be the average bid of all the keywords in all the ad positions; Impressions is the sum of the number of impressions in all the ad positions; Clicks is the sum of the number of clicks in all the ad positions; Total cost is the sum of the cost of using the keywords in all the ad positions; AverageCTR is calculated by dividing the number of clicks by the number of impressions and multiplying the result by 100; AverageCPC is calculated by dividing the cost of all clicks by the number of clicks.
All Indicates all search result positions.
FirstPage1 The first ad to appear on the right side of the first search results page.
FirstPage10 The tenth ad to appear on the right side of the first search results page.
FirstPage2 The second ad to appear on the right side of the first search results page.
FirstPage3 The third ad to appear on the right side of the first search results page.
FirstPage4 The fourth ad to appear on the right side of the first search results page.
FirstPage5 The fifth ad to appear on the right side of the first search results page.
FirstPage6 The sixth ad to appear on the right side of the first search results page.
FirstPage7 The seventh ad to appear on the right side of the first search results page.
FirstPage8 The eighth ad to appear on the right side of the first search results page.
FirstPage9 The ninth ad to appear on the right side of the first search results page.
MainLine1 The first ad to appear at the top of the search results page.
MainLine2 The second ad to appear at the top of the search results page.
MainLine3 The third ad to appear at the top of the search results page.
MainLine4 The fourth ad to appear at the top of the search results page.

Requirements

Service: AdInsightService.svc v12
Namespace: Microsoft.Advertiser.AdInsight.Api.Service.V12

Used By

GetHistoricalKeywordPerformance
KeywordKPI