Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Ad Insight service defines the following service operations.
| Service Operation | Description | Request Limits |
|---|---|---|
| ApplyRecommendations | Apply one or more recommendations. | N/A. |
| DismissRecommendations | Dismiss one or more recommendations. | N/A. |
| GetAuctionInsightData | Gets auction insight data for an account, campaigns, ad groups, or keywords. | 200 EntityIds |
| GetAudienceFullEstimation | Gets the audience full estimation. | N/A. |
| GetAutoApplyOptInStatus | Get the auto-apply recommendations opt-in status for a single account. | The number of distinct recommendation types is no more than 100 |
| GetBidLandscapeByAdGroupIds | Given a list of existing ad groups, this operation returns for each a list of suggested bids and estimated performance statistics. | 1,000 AdGroupBidLandscapeInput |
| GetBidLandscapeByKeywordIds | Given a list of existing keywords, this operation returns for each a list of suggested bids and estimated performance statistics from 1 to 7 days. | 1,000 KeywordIds |
| GetBidOpportunities | Gets the keyword bid opportunities of the specified ad group. | 1 AdGroupId 1 CampaignId |
| GetBudgetOpportunities | Gets the campaign budget opportunities of the specified campaign. | 1 CampaignId |
| GetDomainCategories | Gets the list of categories available for the website domain and language. | 1 DomainName 1 Language |
| GetEstimatedBidByKeywordIds | Gets the estimated bid value of one or more keywords - specified by keyword identifier - that could have resulted in an ad appearing in the targeted position in the search results in the last 7 days. | 1,000 KeywordIds |
| GetEstimatedBidByKeywords | Gets the estimated bid value of one or more keywords that could result in an ad appearing in the targeted position in the search results. | 1 AdGroupId 1,000 Keywords |
| GetEstimatedPositionByKeywordIds | Gets the estimated position in the search results if the specified bid value had been used for the keywords in the last 7 days. | 1,000 KeywordIds |
| GetEstimatedPositionByKeywords | Gets the estimated position in the search results if the specified bid value would be used for the specified keywords. | 1 AdGroupId 1,000 Keywords |
| GetHistoricalKeywordPerformance | Gets the historical performance of the normalized search term. | 1,000 Keywords |
| GetHistoricalSearchCount | Gets the number of times the normalized term was used in a search during the specified time period. | 1,000 Keywords |
| GetKeywordCategories | Gets the keyword categories to which the specified keywords belong. | 1,000 Keywords 5 MaxCategories |
| GetKeywordDemographics | Gets the age and gender of users who have searched for the specified keywords. | 1,000 Keywords |
| GetKeywordIdeaCategories | Gets the list of keyword idea categories. | Not applicable |
| GetKeywordIdeas | Gets the list of keyword ideas. | Maximum 1 of each SearchParameter type within SearchParameters |
| GetKeywordLocations | Gets the geographical locations of users who have searched for the specified keywords. | 1,000 Keywords 10 MaxLocations |
| GetKeywordOpportunities | Gets a list of keyword suggestions that are relevant to the specified ad group. | 1 AdGroupId 1 CampaignId |
| GetKeywordTrafficEstimates | Provides traffic estimates for keywords e.g., average CPC, average position, clicks, CTR, impressions, and total cost. | N/A. |
| GetPerformanceInsightsDetailDataByAccountId | Gets the performance insights detail data for a single account. | N/A. |
| GetRecommendations | Discover your recommendations. | Returns a maximum of 2,000 Recommendations. |
| GetTextAssetSuggestionsByFinalUrls | Gets text asset suggestions by final URLs. | 5 FinalUrls |
| RetrieveRecommendations | Retrieve a list of recommendations. | N/A. |
| SetAutoApplyOptInStatus | Set the auto-apply recommendations opt-in status for a single account. | 100 AutoApplyOptInStatusInputs |
| SuggestKeywordsForUrl | Suggests the possible keywords for the content located at the specified URL. | 200 MaxKeywords 1 Url |
| SuggestKeywordsFromExistingKeywords | Suggests keywords that could perform better than the specified keywords. | 1,000 Keywords 100 MaxSuggestionsPerKeyword |
| TagRecommendations | Notifies Microsoft Advertising that the specific recommendation to create responsive search ads should be tagged as applied or dismissed. | 100 RecommendationsInfo |