KeywordEstimatedPosition Data Object - Ad Insight

Defines an object that contains the keyword and the estimated position in the search results for each match type.

Note

The estimates are not a prediction or guarantee of future performance.

Syntax

XML

<xs:complexType name="KeywordEstimatedPosition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Keyword" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EstimatedPositions" nillable="true" type="tns:ArrayOfEstimatedPositionAndTraffic" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "EstimatedPositions": [
    {
      "AverageCPC": DoubleValueHere,
      "CTR": DoubleValueHere,
      "CurrencyCode": "ValueHere",
      "EstimatedAdPosition": DoubleValueHere,
      "MatchType": "ValueHere",
      "MaxClicksPerWeek": DoubleValueHere,
      "MaxImpressionsPerWeek": "LongValueHere",
      "MaxTotalCostPerWeek": DoubleValueHere,
      "MinClicksPerWeek": DoubleValueHere,
      "MinImpressionsPerWeek": "LongValueHere",
      "MinTotalCostPerWeek": DoubleValueHere
    }
  ],
  "Keyword": "ValueHere"
}

Elements

The KeywordEstimatedPosition object has the following elements: EstimatedPositions, Keyword.

Element	Description	Data Type
EstimatedPositions	An array of EstimatedPositionAndTraffic data objects that contains the position in the search results corresponding to the specified maximum bid. Each object also contains estimates of clicks, average cost per click (CPC), impressions, click-through rate (CTR), and total cost given the specified bid. If there is no data available for a match type, the array will not include estimates for the match type.	EstimatedPositionAndTraffic array
Keyword	The keyword to which the estimates apply.	string

Requirements

Service: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13

Used By

GetEstimatedPositionByKeywords
KeywordIdEstimatedPosition