Amazon Ads 报告获取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-ads-report-107。
技能介绍
要解决的实际问题
运营或数据分析同学常被问到:「上周各 campaign 花了多少钱」「用户搜什么词进到我广告」「哪个 ASIN 在 SP 上转化最好」。这些答案散落在 Amazon Ads 的不同 reportType 里,而且报告不是即时出数——创建后要轮询 2~10 分钟,再下载并解压才能得到可读数据。若只靠手工在后台点选,还要自己核对 groupBy、columns 是否与官方 API 一致,很容易拉错表或缺列。
技能如何工作
本技能通过 POST /amazonAds/developerProxy(或 get_report.py)在服务端用 profileId 完成整条链路:创建报告 → 等待生成 → 下载 → 解压,并把完整响应落到当前工作目录下的 JSON 文件。脚本不会替你做业务选型;Agent 应先打开 references/report-types/<reportTypeId>.md,从 frontmatter 与 Base metrics 表取出 adProduct、groupBy、可用列名,再按用户意图构造 columns(含默认的 timeUnit、主键维度、基础曝光/点击/花费等),显式传入三个必填参数后执行。
多账号时必须先调用依赖技能 linkfox-amazon-ads-auth 的 authorized_stores.py,把「美国站」「日本站」等自然语言映射为数字 profileId;同站点多账号必须向用户澄清,不能默认挑第一个。若客户端等满默认窗口仍返回 status=STILL_PROCESSING,可用返回的 reportId 切到仅轮询模式续跑,而不是当成失败。
适用边界
覆盖 SP / SB / SD 常见广告报告(以 references/report-types/ 下文档为准);ST / DSP、Brand Analytics、报告定时任务与实体元数据(campaign 名称维护等)不在本技能内,授权与 token 归 linkfox-amazon-ads-auth。多数报告日期跨度上限约 31 天(部分类型更长),数据有约 12 小时延迟;空数组或全零指标也可能是「当期无投放」而非接口故障。
使用场景
- 复盘上周 SP 各广告活动曝光、点击与花费,按日拆分导出给运营填周会表
- 拉取 SP 搜索词报告,核对高花费低转化词并决定是否加否定关键词
- 查看 SB/SB 归因列,对比 purchases7d 与 acosClicks7d 评估活动 ROI
- 上次拉报告超时后,用返回的 reportId 仅轮询续跑直至下载完成
适合人员
- 负责美国/欧洲多站点投放的亚马逊广告运营,需按站点拉标准 performance 报告
- 做周报月报的数据分析师,要把官方报告字段对齐到内部分析模板
- 代理多家卖家账号的投手,需在多个 profileId 间先澄清账号再拉数
- 排查 ACOS 异常的负责人,需按 campaign 或 search term 维度回溯固定日期窗口