SuperAPI AI 工具集

ecommerce.amazon-ads-sp-insights-report

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:通过 Nexscope 调用 Amazon Ads Reporting API v1 beta,获取 Sponsored Products 受众表现报告与搜索词展示份额/排名报告,涵盖广告主账户映射、报告创建、轮询与 multipart CSV 下载。它不替代普通 SP 搜索词表现报告,也不涉及 Sponsored Brands、Sponsored Display 或 DSP 报告。

主要能力:提供两个入口脚本 get_sp_audience_report.py 与 get_sp_search_impression_share.py,均走 POST /api/v1/tools/research/amazonAds/developerProxy。需先具备 ecommerce.amazon-ads-api-access 及已授权的 Amazon Ads 连接,并在请求前确定目标 profile。

使用方式:设置 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY,以 Authorization: Bearer <key> 发送密钥。运行示例:python scripts/get_sp_audience_report.py '<JSON parameters>' --no-cache。请求前须对照 references/api.md 校验必填字段、类型、枚举、范围与操作限制;references/api.json 为机器可读操作目录。响应需外层 code 为 0 才可使用 data,非零为平台失败,仅展示 outer msg,不将其措辞当作重试指令;HTTP 200 或嵌套业务码不能替代平台校验。

限制与安全:该操作消耗积分,需保留响应头 X-Cost-Token 与 X-Cost-Credit 作为计费元数据;_nexscope.cost 为耗时而非积分。HTTP 401 为 Nexscope 认证失败,402 为积分不足。授权或网络异常后不得替换账户、市场、区域、创建者、产品或操作。凭据与上游令牌由后端持有,禁止接受、打印或持久化;不得暴露 API 密钥、令牌、预签名 URL 查询串或内部账户记录。超时或上游失败不要自动重试,先报告 trace ID 并核对状态。缺失凭据或过期时访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。