account | DynamicAccount | Yes | - | Select the Amazon Ads profile to get bid recommendations for. |
recommend_for | string or SelectableOption | Yes | - | Get Sponsored Products theme-based bid recommendations for an existing ad group or for a new ad group planned around a list of ASINs. Options: existing_ad_group or new_ad_group. |
campaign_id | string or SelectItem | No | - | The campaign of the ad group. Required when recommend_for is existing_ad_group. |
ad_group_id | string or SelectItem | No | - | The ad group to recommend bids for. Required when recommend_for is existing_ad_group. |
asins | array of string (also accepts a comma-separated string) | No | - | The ad ASINs planned for the new ad group, as a list or comma-separated text. Required when recommend_for is new_ad_group. |
targeting_expressions | array of object or string | Yes | - | Raw Amazon targeting expressions to get bid recommendations for, sent as-is (up to 100). Each entry: {“type”: …} with optional “value”. Types: CLOSE_MATCH, LOOSE_MATCH, SUBSTITUTES, COMPLEMENTS (auto targeting); KEYWORD_BROAD_MATCH, KEYWORD_PHRASE_MATCH, KEYWORD_EXACT_MATCH with a keyword value; PAT_ASIN, PAT_CATEGORY, PAT_CATEGORY_REFINEMENT with an ASIN or category value. Example: [{“type”: “KEYWORD_EXACT_MATCH”, “value”: “running shoes”}, {“type”: “CLOSE_MATCH”}] |
bidding | object or string | No | - | Only for new_ad_group: the raw bidding control configuration of the planned campaign, sent as-is. Example: {“strategy”: “AUTO_FOR_SALES”} |
include_analysis | boolean | No | False | Include bid analyzer impact data with the recommendations. Default false. |
