KeywordBidLandscape Data Object - Ad Insight

Defines an object that contains a list of estimated clicks, cost, and impressions from 1 to 7 days for the keyword identifier given the suggested bid.

Note

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

Syntax

XML

<xs:complexType name="KeywordBidLandscape" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="KeywordId" type="xs:long" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:DayMonthAndYear" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:DayMonthAndYear" />
    <xs:element minOccurs="0" name="BidLandscapePoints" nillable="true" type="tns:ArrayOfBidLandscapePoint" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "BidLandscapePoints": [
    {
      "Bid": DoubleValueHere,
      "Clicks": DoubleValueHere,
      "Cost": DoubleValueHere,
      "CurrencyCode": "ValueHere",
      "Impressions": "LongValueHere",
      "MarginalCPC": DoubleValueHere,
      "TopImpressions": "LongValueHere"
    }
  ],
  "EndDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "KeywordId": "LongValueHere",
  "StartDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  }
}

Elements

The KeywordBidLandscape object has the following elements: BidLandscapePoints, EndDate, KeywordId, StartDate.

Element	Description	Data Type
BidLandscapePoints	The list of the total estimated clicks, cost, and impressions from StartDate to EndDate given the suggested bid.	BidLandscapePoint array
EndDate	The most recent date used to calculate the bid landscape. The end date should be approximately 2 days prior to today's date when the service is called.	DayMonthAndYear
KeywordId	The keyword identifier.	long
StartDate	The first date used to calculate the bid landscape. The start date is usually seven days prior to the end date. The difference between the start and end dates could be less than seven if performance data is not available, for example with a new keyword.	DayMonthAndYear

Requirements

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

Used By

GetBidLandscapeByKeywordIds