商品推广(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)

tools/call
{
  "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}}'
抢先体验 — 如需 Tool API 访问,请 联系我们.

需要写权限

创建广告活动、修改竞价、预算和投放、应用建议都会改动你的广告账户,所以该店铺需要广告写权限(见掌控你的 AI)。读取广告活动、建议和报表只需读权限。

本页用到的工具

构建时从工具目录读取,每个工具带有自己的权限标签。

工具权限作用(英文)
ads_sp_bulk_createwriteCreate 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_campaignreadQuery (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_campaignwriteCreate 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_groupwriteCreate 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_adwriteCreate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_create_targetwriteCreate 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_biddestructiveChange ONE target's (keyword, product or audience target) bid.
ads_get_theme_based_bid_recommendation_for_ad_group_v1readSponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one.
ads_get_ranked_keyword_recommendationreadSponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs.
ads_get_historyreadGet the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads.
query_report_datareadQuery the synced report warehouse (rpt_* tables) — rows without calling Amazon.

所有广告类型通用的广告活动、广告组、广告和投放工具:

工具权限作用(英文)
ads_create_adwriteCreate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_create_ad_associationwriteCreate 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_groupwriteCreate 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_campaignwriteCreate 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_targetwriteCreate 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_addestructiveDelete (archive) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_delete_ad_associationdestructiveDelete (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_groupdestructiveDelete (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_campaigndestructiveDelete (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_targetdestructiveDelete (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_adreadQuery (read) ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_query_ad_associationreadQuery (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_groupreadQuery (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_campaignreadQuery (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_targetreadQuery (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_addestructiveUpdate ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
ads_update_ad_associationdestructiveUpdate 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_groupdestructiveUpdate 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_campaigndestructiveUpdate 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_budgetdestructiveChange ONE campaign's budget amount — nothing else about the campaign.
ads_update_campaign_statedestructiveEnable or pause ONE campaign — nothing else about it.
ads_update_targetdestructiveUpdate 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_biddestructiveChange ONE target's (keyword, product or audience target) bid.

SP 的建议、广告组合、规则和导出:

工具权限作用(英文)
ads_create_portfoliowriteCreate portfolios (cross-product: Sponsored Products, Brands and Display).
ads_get_category_recommendations_for_asinsreadSponsored 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_brandsreadSponsored Products: brands Amazon recommends excluding from targeting (no input needed).
ads_get_ranked_keyword_recommendationreadSponsored Products: ranked keyword recommendations with per-match-type suggested bids, from either an ad group or a list of ASINs.
ads_get_refinements_for_categoryreadSponsored Products: the refinements (brand / age-range / genre facets) targetable WITHIN a category — e.g.
ads_get_theme_based_bid_recommendation_for_ad_group_v1readSponsored Products: suggested bid amounts for keywords or targeting expressions, for an existing ad group or a new one.
ads_list_portfoliosreadList portfolios (group campaigns across Sponsored Products, Brands and Display for shared budget caps and reporting).
ads_search_brandsreadSponsored 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_createwriteCreate 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_recommendationsreadSponsored 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_recommendationsreadSponsored Products: suggested target ASINs (product targets) for your advertised ASINs — competitor / complementary ASINs Amazon considers relevant, each with the themes that produ
ads_update_portfoliodestructiveUpdate portfolios (cross-product: Sponsored Products, Brands and Display).
ads_ad_exportreadSubmit a bulk export of every product ad across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_ad_group_exportreadSubmit a bulk export of every ad group across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_apply_recommendationsdestructiveAccept Amazon-generated Sponsored Products campaign recommendations — Amazon applies the proposed change to the campaign.
ads_associate_optimization_rules_to_campaigndestructiveAttach Sponsored Products bid optimization rules to a campaign — a rule changes nothing until it is associated.
ads_campaign_exportreadSubmit a bulk export of every campaign across Sponsored Products, Brands and Display — an asynchronous full snapshot in one file.
ads_create_optimization_ruledestructiveSponsored 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_ruledestructiveSponsored 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_reportreadRequest 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_reportreadPoll 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_rulereadSponsored Products: get one rule-based-bidding rule by its id.
ads_get_exportreadPoll 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_historyreadGet the entity change history — an audit log of edits to campaigns, ad groups, keywords, targets and product ads.
ads_get_optimization_rule_eligibilityreadSponsored 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_notificationreadSponsored Products: the daily health-check for a rule-based-bidding rule — whether Amazon has silently disabled it.
ads_insights_get_audiences_overlapping_audiencesreadGet the audiences that OVERLAP one given audience segment — audience-overlap insights for a single audienceId, not a catalog of audiences.
ads_list_recommendationsreadList 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_rulesreadSearch 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_ruleswriteCreate a Sponsored Products bid optimization rule — schedule or performance bid rules that raise bids automatically.
ads_sp_get_all_rule_eventsreadSponsored 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_rulesdestructiveUpdate 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_exportreadSubmit 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_ruledestructiveSponsored Products: update a rule-based-bidding rule — same shape as ads_create_optimization_rule plus campaignOptimizationId.
ads_update_recommendationdestructiveModify one Amazon-generated Sponsored Products campaign recommendation before accepting it.

常见问题

表现数据从哪里来?

来自已同步的广告报表——query_report_data 立即返回,不用等亚马逊。见已同步报表和广告报表。

AI 会自己改竞价吗?

除非你让它这么做。通常是:先把方案写进表格,你审核,再提交。

预算呢?

ads_campaigns_budget_usage 显示本周哪些广告活动预算用完;预算规则见广告账户,其他广告类型见品牌推广和展示型推广。

有对应的技能吗?

有——amazon-ads 技能。见安装技能。

本页内容

操作

查看 Markdown

询问助手

问 ChatGPT问 Claude