account | DynamicAccount | Yes | - | Select the Amazon Ads profile (advertiser + marketplace) to create the targets in. |
ad_product | string or SelectableOption | Yes | - | The Amazon ad product of the campaign. Options: SPONSORED_PRODUCTS, SPONSORED_BRANDS, SPONSORED_DISPLAY, or SPONSORED_TELEVISION. Target type support varies: Sponsored Products and Brands take KEYWORD, PRODUCT, PRODUCT_CATEGORY, and THEME; Sponsored Display also takes PRODUCT_AUDIENCE; Sponsored TV takes AUDIENCE. |
target_type | string or SelectableOption | Yes | - | What to target. KEYWORD (search keywords with match types), PRODUCT (specific ASINs/SKUs), PRODUCT_CATEGORY (category with refinements), THEME (Amazon-managed keyword groups), AUDIENCE (audience ID), or PRODUCT_AUDIENCE (viewers/purchasers of a product). |
ad_group_id | string or SelectItem | No | - | The Amazon Ads ad group to create the targets in. Required except for Sponsored Products campaign-level negative targets (set campaign_id instead). |
campaign_id | string or SelectItem | No | - | Only for Sponsored Products campaign-level negative targets: the campaign to attach the negatives to (leave ad_group_id empty). |
negative | boolean | No | False | Set true to create negative (excluding) targets, for example negative keywords or negative product targets. Default false. |
state | string or SelectableOption | No | {'value': 'ENABLED', 'label': 'Enabled'} | Target state on creation. Options: ENABLED, PAUSED, DRAFT, PROPOSED. Default: ENABLED. |
bid | number | No | - | Bid for these targets in the profile’s currency (for example 0.75 for $0.75). Applied to every target created by this run. Not allowed on negative targets. Required for Sponsored Brands targets. |
keywords | array of string (also accepts a comma-separated string) | No | - | For KEYWORD targets: the keywords to add, as a list or comma/newline separated text. One target is created per keyword. |
match_type | string or SelectableOption | No | - | For KEYWORD targets: match type applied to all keywords. Options: BROAD, PHRASE, EXACT. |
product_ids | array of string (also accepts a comma-separated string) | No | - | For PRODUCT targets: the product IDs (ASINs like B07FZ8S74R, or SKUs) to target, as a list or comma-separated text. One target is created per product. |
product_id_type | string or SelectableOption | No | {'value': 'ASIN', 'label': 'ASIN'} | For PRODUCT targets: whether product_ids are ASINs or SKUs. Default: ASIN. |
product_match_type | string or SelectableOption | No | {'value': 'PRODUCT_EXACT', 'label': 'Product Exact'} | For PRODUCT targets: PRODUCT_EXACT (the exact product), PRODUCT_SIMILAR, PRODUCT_COMPLEMENTS, or PRODUCT_REMARKETING. Default: PRODUCT_EXACT. |
product_category_refinement | object or string | No | - | For PRODUCT_CATEGORY targets: the raw Amazon Ads API v1 productCategoryRefinement object, sent as-is. Keys: productCategoryId, productBrandId, productGenreId, productAgeRangeId, productPriceGreaterThan, productPriceLessThan, productRatingGreaterThan, productRatingLessThan, productPrimeShippingEligible. Example: {“productCategoryId”: “679255011”, “productRatingGreaterThan”: 4} |
theme_match_type | string or SelectableOption | No | - | For THEME targets: the Amazon-managed theme to target, for example KEYWORDS_RELATED_TO_YOUR_BRAND or PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS. |
audience_id | string | No | - | For AUDIENCE targets: the Amazon audience ID to target. |
product_audience | object or string | No | - | For PRODUCT_AUDIENCE targets: the raw Amazon Ads API v1 productAudienceTarget object, sent as-is. Keys: asin ({“defaultValue”: “B0…”}), event, lookback, matchType (PRODUCT_EXACT or PRODUCT_SIMILAR). All four are required by Amazon. |
targets | array of object or string | No | - | Advanced alternative to the fields above: the raw Amazon Ads API v1 targets array, sent as-is (each entry needs adProduct, negative, state, targetType, targetDetails, and adGroupId or campaignId). Use for mixed batches or target types not covered by the simple fields. Example: [{“adGroupId”: “123”, “adProduct”: “SPONSORED_PRODUCTS”, “negative”: false, “state”: “ENABLED”, “targetType”: “KEYWORD”, “targetDetails”: {“keywordTarget”: {“keyword”: “running shoes”, “matchType”: “EXACT”}}}] |