Agent Skills
返回列表
酷特海外运营营销活动花费报表

酷特海外运营营销活动花费报表

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 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 的后端或集成工程师
  • 按租户权限从正式环境接口取营销花费、对接内部分析看板的数据分析同学
  • 管理多活动组预算、要核对平台报表而非手工估算花费的营销负责人