酷特海外运营营销活动花费报表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-reporting-marketing-campaign-report。
技能介绍
要解决什么问题
海外运营侧需要按活动维度核对营销投放花费,数据在酷特海外运营平台的后台报表接口里,而不是本地表格或通用 BI。若你在 agent 流程里要拉「某段时间、某活动组」的花费汇总,需要走正式环境的 reportMarketingCampaign 查询,并带上当前租户/用户的登录态与权限。
本技能是最小颗粒度接口 skill:只完成 marketing_campaign_report 这一次 GET 调用,不负责登录、翻页编排或多报表拼接;多步业务由上层 agent 按聚合 skill 或计划文档组合其它原子 skill。
技能如何工作
- 固定使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api/marketing路径下的/campaign-group/reportMarketingCampaign),不接受用户输入覆盖域名或环境。 - 工具参数统一放在顶层
params对象内:Query 写入params.query(类型为BusinessReportRequest),Path 写入params.path;params.accessToken用于生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 执行器按表选择 GET,将查询参数拼到 URL query;以接口响应为唯一事实来源,向上层返回报表字段或原始错误码/错误信息。
适用边界与注意点
- 仅覆盖营销活动花费报表这一动作;若要订单、库存、其它经营报表,需选用同聚合下的其它接口 skill。
- 仍为登录态与权限受控的查询类接口:认证失败、参数不合法或业务拒绝时,应把原始错误交给上层处理,不要在 agent 侧编造花费金额、活动 ID 或优惠数据。
- 最外层参数结构必须为
{ "params": { ... } },不要使用params.xxx形式的顶层点号 key。
使用场景
- 海外运营周报里,需要按活动组从酷特平台拉取指定周期的营销活动花费汇总。
- 搭建 agent 时,在登录拿到 accessToken 后,单独调用 reportMarketingCampaign 填充花费字段。
- 财务与投放对账时,用 BusinessReportRequest 查询条件核对各营销活动实际花费。
- 多报表链路中只需「花费报表」一步,由上层编排其它原子 skill 处理登录与后续动作。
适合人员
- 负责酷特海外店铺投放复盘、需在对话或自动化里查活动花费的运营专员
- 把 platform-reporting 拆成原子 skill 集成进业务 agent 的后端或集成工程师
- 按租户权限从正式环境接口取营销花费、对接内部分析看板的数据分析同学
- 管理多活动组预算、要核对平台报表而非手工估算花费的营销负责人