August 5 2026 Changelog

Suggested bid recommendations are now available for keywords already included in Sponsored Products, Sponsored Brands, and Sponsored Videos campaigns. Integrate the new Selected Keyword Bid Recommendations type to retrieve competitive bid suggestions that are refreshed daily without changing existing recommendation integrations.

• Submit a recommendation snapshot request using
  POST /api/v2/snapshot/recommendations.
  Set
  
  recommendationType

  Identifies the recommendation report to generate. Use selectedKeywords to request bid recommendations for keywords already included in a campaign.

  Request Field
  to selectedKeywords

  Campaign Recommendations API value for Selected Keyword Bid Recommendations.

  Enum Value
  .

• Include
  
  advertiserId

  Unique numeric identifier for the advertising account. Each snapshot request supports one advertiser ID.

  Request Field
  , set format

  Output compression format for the snapshot report. The supported value is gzip.

  Request Field
  to gzip, and provide campaignIds

  Array of valid campaign IDs for which selected keyword recommendations should be generated. This field is required for the selectedKeywords report.

  Request Field
  .

• Request the following values in
  
  reportMetrics

  Array of fields to include in the generated recommendation report.

  Request Field
  : campaignId, adGroupId, keywordId, keywordText, matchType, and suggestedBid.

• Retrieve the snapshot status using
  
  GET /api/v2/snapshot

  Retrieves the generation status and download information for a Campaign Recommendations snapshot.

  Endpoint
  with the advertiser ID and returned snapshot ID.

• Poll until
  
  jobStatus

  Indicates the snapshot generation state. Possible values are pending, processing, done, failed, and expired.

  Response Field
  is done. The details

  Provides the report download URL after snapshot generation reaches the done state.

  Response Field
  field then contains the download URL for the gzip-compressed CSV report.

• Parse
  
  matchType

  Match type associated with the keyword and suggested bid. Possible values are exact, phrase, and broad.

  Response Field
  together with suggestedBid

  Suggested bid value for the existing keyword in the specified campaign and ad group.

  Response Field
  so the recommendation is applied to the correct keyword and match type.

• Existing Campaign Recommendations integrations are not impacted. Add support for the new selectedKeywords type only when adopting this feature.

Best Practice: Generate a new Selected Keyword Bid Recommendations report when current bid guidance is needed because suggested bids are refreshed daily.

To learn more, see the
Create Campaign Recommendations documentation.