EstimatedPositionAndTraffic Data Object - Ad Insight

Defines an object that contains the estimated search results position and estimated keyword statistics such as clicks, average cost per click (CPC), impressions, click-through rate (CTR), and total cost for the specified keyword given the specified bid.

Note

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

Syntax

<xs:complexType name="EstimatedPositionAndTraffic" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="MatchType" type="tns:MatchType" />
    <xs:element minOccurs="0" name="MinClicksPerWeek" type="xs:double" />
    <xs:element minOccurs="0" name="MaxClicksPerWeek" type="xs:double" />
    <xs:element minOccurs="0" name="AverageCPC" type="xs:double" />
    <xs:element minOccurs="0" name="MinImpressionsPerWeek" type="xs:long" />
    <xs:element minOccurs="0" name="MaxImpressionsPerWeek" type="xs:long" />
    <xs:element minOccurs="0" name="CTR" type="xs:double" />
    <xs:element minOccurs="0" name="MinTotalCostPerWeek" type="xs:double" />
    <xs:element minOccurs="0" name="MaxTotalCostPerWeek" type="xs:double" />
    <xs:element minOccurs="0" name="CurrencyCode" type="tns:CurrencyCode" />
    <xs:element minOccurs="0" name="EstimatedAdPosition" type="xs:double" />
  </xs:sequence>
</xs:complexType>

Elements

The EstimatedPositionAndTraffic object has the following elements: AverageCPC, CTR, CurrencyCode, EstimatedAdPosition, MatchType, MaxClicksPerWeek, MaxImpressionsPerWeek, MaxTotalCostPerWeek, MinClicksPerWeek, MinImpressionsPerWeek, MinTotalCostPerWeek.

Element Description Data Type
AverageCPC The estimated average CPC.

The formula used to calculate the average CPC is (maximum total cost / maximum number of clicks).
double
CTR The estimated CTR.

The formula used to calculate the CTR is (maximum number of clicks / maximum number of impressions) * 100.
double
CurrencyCode The ISO code for the monetary unit of the cost values such as AverageCPC. CurrencyCode
EstimatedAdPosition The position in the search results given the specified bid.

This element is deprecated as of March 31st, 2021 and '0' (zero) is returned going forward.
double
MatchType The keyword match type used to determine the estimates. MatchType
MaxClicksPerWeek The estimated maximum number of clicks per week. double
MaxImpressionsPerWeek The estimated maximum number of impressions per week. long
MaxTotalCostPerWeek The estimated maximum cost per week. double
MinClicksPerWeek The estimated minimum number of clicks per week. double
MinImpressionsPerWeek The estimated minimum number of impressions per week. long
MinTotalCostPerWeek The estimated minimum cost per week. double

Requirements

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

Used By

KeywordEstimatedPosition