AdGroupBidLandscape Data Object - Ad Insight

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

Note

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

Syntax

XML

<xs:complexType name="AdGroupBidLandscape" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdGroupId" type="xs:long" />
    <xs:element minOccurs="0" name="AdGroupBidLandscapeType" type="tns:AdGroupBidLandscapeType" />
    <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

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

Elements

The AdGroupBidLandscape object has the following elements: AdGroupBidLandscapeType, AdGroupId, BidLandscapePoints, EndDate, StartDate.

Element	Description	Data Type
AdGroupBidLandscapeType	Indicates whether all or a subset of an ad group's existing keywords were used to determine the bid landscape.	AdGroupBidLandscapeType
AdGroupId	The ad group identifier.	long
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
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 ad group.	DayMonthAndYear

Requirements

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

Used By

GetBidLandscapeByAdGroupIds