Edit

Recommendation Data Object - Ad Insight

  • Article

Defines the base object of Recommendation. The ResponsiveSearchAdsRecommendation object derives from it.

Syntax

<xs:complexType name="Recommendation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AccountId" type="xs:long" />
    <xs:element minOccurs="0" name="AdGroupId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CampaignId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CurrentClicks" type="xs:long" />
    <xs:element minOccurs="0" name="CurrentConversions" type="xs:long" />
    <xs:element minOccurs="0" name="CurrentCost" type="xs:double" />
    <xs:element minOccurs="0" name="CurrentImpressions" type="xs:long" />
    <xs:element minOccurs="0" name="EstimatedIncreaseInClicks" type="xs:long" />
    <xs:element minOccurs="0" name="EstimatedIncreaseInConversions" type="xs:long" />
    <xs:element minOccurs="0" name="EstimatedIncreaseInCost" type="xs:double" />
    <xs:element minOccurs="0" name="EstimatedIncreaseInImpressions" type="xs:long" />
    <xs:element minOccurs="0" name="RecommendationHash" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="RecommendationId" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="RecommendationType" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

The Recommendation object has the following elements: AccountId, AdGroupId, CampaignId, CurrentClicks, CurrentConversions, CurrentCost, CurrentImpressions, EstimatedIncreaseInClicks, EstimatedIncreaseInConversions, EstimatedIncreaseInCost, EstimatedIncreaseInImpressions, RecommendationHash, RecommendationId, RecommendationType.

Element Description Data Type
AccountId The identifier of the account. long
AdGroupId The identifier of the ad group that owns the recommendation. long
CampaignId The identifier of the campaign for the ad group that owns the recommendation. long
CurrentClicks Actual clicks of the ad group in the past 7 days. long
CurrentConversions Actual conversions of the ad group in the past 7 days. long
CurrentCost Actual spending of the ad group in the past 7 days, in the currency of this account. double
CurrentImpressions Actual impressions of the ad group in the past 7 days. long
EstimatedIncreaseInClicks The estimated click opportunities corresponding to the suggested ad. long
EstimatedIncreaseInConversions The estimated impression opportunities corresponding to the suggested ad. long
EstimatedIncreaseInCost The estimated increase in spend corresponding to the suggested ad. double
EstimatedIncreaseInImpressions The estimated impressions opportunities corresponding to the suggested ad. long
RecommendationHash The hash of the recommendation. string
RecommendationId The identifier of the recommendation. string
RecommendationType The type of recommendation. string

Requirements

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

Used By

GetRecommendations