SuperAPI AI 工具集

linkfox-amazon-ads-sp-insights-report

营销与增长

查看项目

更新于 10-15 23:43

技能介绍

用途:统一获取两类亚马逊 Sponsored Products 专项报告——Audience 受众细分表现,以及 Search Term Impression Share/Rank 搜索词展示份额与排名。

主要能力:脚本经 developerProxy 传入 profileId,服务端解析 token,自动完成 advertiser account 映射、报告创建、轮询等待(通常约 2–10 分钟)、多分片 CSV 下载与落盘。字段使用 Amazon Reporting API v1 beta 允许的固定组合,不接受调用方自由拼接。

可用脚本:get_sp_audience_report.py(SP Audience 受众细分表现,支持 ACCOUNT/CAMPAIGN/AD_GROUP 粒度);get_sp_search_impression_share.py(搜索词展示份额与排名)。依赖 linkfox-amazon-ads-auth,未安装时 exit 42。

用法示例:python scripts/get_sp_audience_report.py '{"profileId":1234567890,"region":"NA","startDate":"2026-08-01","endDate":"2026-08-07","timeUnit":"DAILY","detailLevel":"ACCOUNT"}';搜索词展示份额使用 get_sp_search_impression_share.py,参数相同但不含 detailLevel。轮询未完成报告时仅传 profileId、region、reportId 与轮询参数并加 --no-cache。多账号场景须先通过 Ads Auth 解析唯一 profileId,候选多个时向用户确认,禁止让用户直接提供 profileId 数字,也禁止默认选择第一个。

结果策略:完整响应写入当前会话 data 目录,响应体超过 8 KB 时 stdout 只输出摘要,可加 --inline 全量打印;status=STILL_PROCESSING 不是失败,应复用原 reportId 继续轮询,不得创建重复报告;totalRows=0 是合法空报告。

限制:只覆盖上述两类 v1 beta 报告,普通 SP 搜索词表现报告应使用 linkfox-amazon-ads-report 的 spSearchTerm;创建报告必须提供 startDate/endDate,格式 YYYY-MM-DD 且 endDate 不晚于今天。Amazon 将 Reporting API v1 标为 open beta,账号开放范围、字段和限流可能变化。连续触发亚马逊接口保护状态(450/453/454/459)时须停止重试并等待冷却。本工具不消耗算力,成功结果默认缓存 24 小时。