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.
<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