商品推广(Sponsored Products)
创建、调整和审查 SP 广告活动——广告活动、广告组、关键词、商品投放、竞价、否定投放和亚马逊自己的优化建议——用对话或代码完成。
一句话
说出你想要的广告活动,AI 搭好整个结构、向亚马逊要建议竞价,上线前先把方案给你看。日常它从已同步的广告报表读取表现,只修改你批准的竞价和投放。
一步一步上线一个广告活动
一句话描述
“给 B0EXAMPLE1 建一个 SP 广告活动,日预算由我定,投放关键词 'organic protein powder'。” AI 规划广告活动、广告组、商品广告和关键词,先把结构给你看。
问亚马逊该出多少价
ads_get_theme_based_bid_recommendation_for_ad_group_v1 返回亚马逊对关键词和投放的建议竞价;ads_get_ranked_keyword_recommendation 推荐更多值得加的关键词。
一次请求建好
ads_sp_bulk_create 一次原子请求创建广告活动、广告组、关键词和商品广告——比逐个创建快得多。单个实体用 ads_create_campaign、ads_create_ad_group、ads_create_ad 和 ads_create_target。
每周调整
query_report_data 从已同步的 SP 报表读取广告活动、关键词和搜索词表现。AI 把拟调整的竞价写进表格;你同意后 ads_update_target_bid 执行。否定关键词和否定投放减少浪费;ads_get_history 显示最近 90 天的变更。
日常工作中
- 亚马逊自己的建议——
ads_list_recommendations列出亚马逊的优化建议;ads_apply_recommendations应用你接受的那些。 - 用规则代替手动修改——
ads_sp_create_optimization_rules和ads_associate_optimization_rules_to_campaign设置按时间表执行的竞价规则。 - 广告组合——
ads_list_portfolios、ads_create_portfolio和ads_update_portfolio把广告活动归到共享预算下。 - 完整快照——
ads_campaign_export等导出工具导出全部实体;ads_get_export下载文件。
可以这样问
“给 B0EXAMPLE1 建一个 SP 广告活动,投放 'organic protein powder',用亚马逊建议竞价——创建之前先把结构给我看。”
“把表格里这批关键词竞价按建议价上调 10%,先写到表格我确认再提交。”
列出广告活动的两种调用方式
同一个工具、同样的参数——通过 AI 客户端,或者从你自己的代码。
MCP——你说:“列出我的 SP 广告活动。” AI 调用 ads_query_campaign 并逐页读取。
在 AI 客户端中(MCP)
{
"name": "ads_query_campaign",
"arguments": {
"store": "myStore-US",
"countryCode": "US",
"body": {
"adProductFilter": {
"include": [
"SPONSORED_PRODUCTS"
]
},
"maxResults": 100
}
}
}在代码中(Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_query_campaign \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"US","body":{"adProductFilter":{"include":["SPONSORED_PRODUCTS"]},"maxResults":100}}'需要写权限
创建广告活动、修改竞价、预算和投放、应用建议都会改动你的广告账户,所以该店铺需要广告写权限(见掌控你的 AI)。读取广告活动、建议和报表只需读权限。
本页用到的工具
构建时从工具目录读取,每个工具带有自己的权限标签。
| 工具 | 权限 | 作用(英文) |
|---|---|---|
ads_sp_bulk_create | write | Create complete Sponsored Products campaign structures in one call (Amazon Ads API v1) — campaign → ad groups → product ads → targets, with the created ids chained server-side. |
ads_query_campaign | read | Query (read) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon |
ads_create_campaign | write | Create advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_create_ad_group | write | Create ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_create_ad | write | Create ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_create_target | write | Create targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_update_target_bid | destructive | Change ONE target's (keyword, product or audience target) bid. |
ads_get_theme_based_bid_recommendation_for_ad_group_v1 | read | Sponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one. |
ads_get_ranked_keyword_recommendation | read | Sponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs. |
ads_get_history | read | Get the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads. |
query_report_data | read | Query the synced report warehouse (rpt_* tables) — rows without calling Amazon. |
所有广告类型通用的广告活动、广告组、广告和投放工具:
| 工具 | 权限 | 作用(英文) |
|---|---|---|
ads_create_ad | write | Create ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_create_ad_association | write | Create ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product link in |
ads_create_ad_group | write | Create ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_create_campaign | write | Create advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_create_target | write | Create targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_delete_ad | destructive | Delete (archive) ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_delete_ad_association | destructive | Delete (archive) ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the produc |
ads_delete_ad_group | destructive | Delete (archive) ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_delete_campaign | destructive | Delete (archive) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Ama |
ads_delete_target | destructive | Delete (archive) targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (neg |
ads_query_ad | read | Query (read) ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_query_ad_association | read | Query (read) ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product li |
ads_query_ad_group | read | Query (read) ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_query_campaign | read | Query (read) advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon |
ads_query_target | read | Query (read) targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negativ |
ads_update_ad | destructive | Update ads (creatives) across ALL ad products via the unified Amazon Ads API v1. |
ads_update_ad_association | destructive | Update ad<->ad-group associations via the unified Amazon Ads API v1 — an AMAZON_DSP resource (creative rotation across ad groups); sponsored-ads products embed the product link in |
ads_update_ad_group | destructive | Update ad groups across ALL ad products via the unified Amazon Ads API v1 (adProduct is a payload field; one shape for SP/SB/SD/ST/DSP). |
ads_update_campaign | destructive | Update advertising campaigns across ALL ad products via the unified Amazon Ads API v1 common model — one shape for Sponsored Products, Brands, Display, Television and Amazon DSP; t |
ads_update_campaign_budget | destructive | Change ONE campaign's budget amount — nothing else about the campaign. |
ads_update_campaign_state | destructive | Enable or pause ONE campaign — nothing else about it. |
ads_update_target | destructive | Update targets across ALL ad products via the unified Amazon Ads API v1 — keywords, product and category targets, audiences, themes and locations, and every negative (negative=true |
ads_update_target_bid | destructive | Change ONE target's (keyword, product or audience target) bid. |
SP 的建议、广告组合、规则和导出:
| 工具 | 权限 | 作用(英文) |
|---|---|---|
ads_create_portfolio | write | Create portfolios (cross-product: Sponsored Products, Brands and Display). |
ads_get_category_recommendations_for_asins | read | Sponsored Products: category targets recommended for a list of ASINs — the coarse half of SP product targeting; narrow one further with ads_get_refinements_for_category. |
ads_get_negative_brands | read | Sponsored Products: brands Amazon recommends excluding from targeting (no input needed). |
ads_get_ranked_keyword_recommendation | read | Sponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs. |
ads_get_refinements_for_category | read | Sponsored Products: the refinements (brand / age-range / genre facets) targetable WITHIN a category — e.g. |
ads_get_theme_based_bid_recommendation_for_ad_group_v1 | read | Sponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one. |
ads_list_portfolios | read | List portfolios (group campaigns across Sponsored Products, Brands and Display for shared budget caps and reporting). |
ads_search_brands | read | Sponsored Products: search for a brand by name, to exclude it from targeting (negative brand target) — use this to find a specific named competitor. |
ads_sp_bulk_create | write | Create complete Sponsored Products campaign structures in one call (Amazon Ads API v1) — campaign → ad groups → product ads → targets, with the created ids chained server-side. |
ads_sp_get_budget_recommendations | read | Sponsored Products: the recommended daily budget and missed opportunities for existing campaigns — campaigns that are budget-capped, losing impressions/clicks/sales because they ru |
ads_sp_get_product_recommendations | read | Sponsored Products: suggested target ASINs (product targets) for your advertised ASINs — competitor / complementary ASINs Amazon considers relevant, each with the themes that produ |
ads_update_portfolio | destructive | Update portfolios (cross-product: Sponsored Products, Brands and Display). |
ads_ad_export | read | Submit a bulk export of every product ad across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_ad_group_export | read | Submit a bulk export of every ad group across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_apply_recommendations | destructive | Accept Amazon-generated Sponsored Products campaign recommendations — Amazon applies the proposed change to the campaign. |
ads_associate_optimization_rules_to_campaign | destructive | Attach Sponsored Products bid optimization rules to a campaign — a rule changes nothing until it is associated. |
ads_campaign_export | read | Submit a bulk export of every campaign across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file. |
ads_create_optimization_rule | destructive | Sponsored Products rule-based bidding — hand bid control to Amazon under a ROAS guardrail you declare; Amazon raises and lowers the campaign's base bids itself to increase conversi |
ads_delete_campaign_optimization_rule | destructive | Sponsored Products: delete a rule-based-bidding rule — unlike ads_sp_update_optimization_rules's API (which has no delete), this one really does support delete; the campaign return |
ads_generate_brand_metrics_report | read | Request a Brand Metrics report — your brand's shopper-funnel metrics in a category against category peers (engaged-shopper rate, customer conversion rate, new-to-brand customer rat |
ads_get_brand_metrics_report | read | Poll a Brand Metrics report; when the server sees it finished, the same call also downloads the file, so there is no separate download step. |
ads_get_campaign_optimization_rule | read | Sponsored Products: get one rule-based-bidding rule by its id. |
ads_get_export | read | Poll a bulk export submitted with ads_campaign_export / ads_ad_group_export / ads_target_export / ads_ad_export; downloads the file once status=COMPLETED. |
ads_get_history | read | Get the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads. |
ads_get_optimization_rule_eligibility | read | Sponsored Products: check which campaigns are eligible for rule-based bidding (a ROAS guardrail Amazon manages itself) before creating a rule with ads_create_optimization_rule — Am |
ads_get_rule_notification | read | Sponsored Products: the daily health-check for a rule-based-bidding rule — whether Amazon has silently disabled it. |
ads_insights_get_audiences_overlapping_audiences | read | Get the audiences that OVERLAP one given audience segment — audience-overlap insights for a single audienceId, not a catalog of audiences. |
ads_list_recommendations | read | List Amazon-generated recommendations for SP, SB, SD and ST campaigns (budget, bid, bidding strategy, new keywords, new campaigns, …) — filter by AD_PRODUCT. |
ads_search_optimization_rules | read | Search Sponsored Products bid optimization rules — rules that raise bids on a SCHEDULE or, with apiVersion='v2', while a PERFORMANCE condition holds (ROAS, CVR, CTR, …). |
ads_sp_create_optimization_rules | write | Create a Sponsored Products bid optimization rule — schedule or performance bid rules that raise bids automatically. |
ads_sp_get_all_rule_events | read | Sponsored Products: list the special shopping events (Prime Day, Black Friday, …) with Amazon's suggested date range in this profile's marketplace. |
ads_sp_update_optimization_rules | destructive | Update a Sponsored Products bid optimization rule — Amazon replaces the rule, it does not merge, so send the FULL rule object(s) including optimizationRuleId. |
ads_target_export | read | Submit a bulk export of every targeting clause (keywords, product targets and all negatives) across Sponsored Products, Brands and Display — an asynchronous full snapshot in one fi |
ads_update_optimization_rule | destructive | Sponsored Products: update a rule-based-bidding rule — same shape as ads_create_optimization_rule plus campaignOptimizationId. |
ads_update_recommendation | destructive | Modify one Amazon-generated Sponsored Products campaign recommendation before accepting it. |
常见问题
表现数据从哪里来?
来自已同步的广告报表——query_report_data 立即返回,不用等亚马逊。见已同步报表和广告报表。
AI 会自己改竞价吗?
除非你让它这么做。通常是:先把方案写进表格,你审核,再提交。
预算呢?
ads_campaigns_budget_usage 显示本周哪些广告活动预算用完;预算规则见广告账户,其他广告类型见品牌推广和展示型推广。
有对应的技能吗?
有——amazon-ads 技能。见安装技能。