SuperAPI AI 工具集

ecommerce-amazon-ads-sp-insights-report

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:通过 Nexscope 调用 Amazon Ads Reporting API v1 beta,获取 Sponsored Products 的受众表现报告与搜索词展示份额/排名报告。

主要能力:包含广告主账户映射、报告创建、轮询以及 multipart CSV 下载。提供两个脚本: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 连接。设置环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY,请求头使用 Authorization: Bearer <key>。运行示例:python scripts/get_sp_audience_report.py '<JSON parameters>' --no-cache。请求前应依据 references/api.md 校验字段、类型、枚举、范围与限制,并确认市场、账户、筛选、日期与分页。响应保存至 nexscope/<date>/<session>/data,并返回简要摘要与路径。

限制:不替代普通 SP 搜索词表现报告、Sponsored Brands、Sponsored Display 或 DSP 报告。该操作消耗积分,需保留响应头 X-Cost-Token 与 X-Cost-Credit。HTTP 401 表示 Nexscope 认证失败,402 表示积分不足。授权或网络异常后不得自动重试或替换账户、市场、区域、创建者、产品或操作。凭证与上游令牌由后端持有,不得接受、打印或持久化。缺失信息暂未提供。