1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| swads-weekly-report | 通过 SW Ads MCP 为当前或指定账户生成最近七个完整业务日的只读周报图片。用户提及周报、每周投放报告或周报图片时使用。 |
SW Ads 单图周报
先调用 swads_whoami 确认账户身份、时区和币种，再调用 metrics_catalog 后查询最近七个完整业务日。禁止依据商品标题或品牌词猜测账户映射。
报告必须包含账户核心指标及环比、Campaign/商品/素材要点、风险、局限和恰好 3 条数据支持的建议。区分平台原生归因与因果增量，低样本不下确定结论。
必须构建“曝光 → 点击 → 购买”漏斗。TikTok Shop 不得直接采用账户汇总层可能为 0 的 product_impressions，必须查询同一日期、账户和归因口径下的完整素材明细，并按以下口径计算：
商品曝光 = 所有视频素材行的 product_impressions 合计 + 所有 product_card:* 商品页行的 product_impressions 合计。商品点击 = 所有视频素材行的 product_clicks 合计 + 所有 product_card:* 商品页行的 product_clicks 合计。- 求和前按素材身份去重；同一
external_creative_id的重复同步记录先按最低可用唯一组合键聚合。 - 必须取全所有素材行，不得只汇总 Top N。结果截断时继续分页或改用能覆盖全量的聚合查询；无法取全或安全去重时显示
N/A，不得用部分数据冒充总量。 - 漏斗说明必须分别列出视频贡献、商品页贡献和两者合计。订单必须保持相同范围和归因口径，不得跨粒度拼接。
其他账户使用兼容的广告指标族。缺失、为零或无法安全去重时显示 N/A 并说明。
最终必须调用 save_report_image，传入 reportType: weekly，生成且只交付 swads-weekly-report.png。任何预算、状态、目标、素材或投放结构修改只列入人工确认区，不执行。