海外运营营销活动花费报表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-reporting-marketing-campaign-report。
技能介绍
要解决什么问题
海外运营侧经常需要核对营销活动花费:按活动分组拉报表、对账或交给上层分析。若每次都在对话里手写 GET https://www.kutetailor.com/api/marketing/campaign-group/reportMarketingCampaign、拼 Query 和 Bearer,容易漏参、改错环境或把返回字段「脑补」成库存/订单号。
本技能是 platform-reporting 聚合下的原子接口 skill,只负责动作 marketing_campaign_report:在固定正式环境地址上完成一次查询,把接口原始响应交给上层 agent 或与其它原子 skill 编排成完整链路。
技能如何工作
- 固定端点:执行器使用 frontmatter 中的
base_url,不接受用户输入覆盖正式环境地址。 - 参数结构:tool arguments 最外层仅包含嵌套对象
params;Path →params.path,Query(本接口为BusinessReportRequest)→params.query,Body →params.body,额外 Header →params.headers。 - 登录态:通过
params.accessToken生成Authorization: Bearer <token>;若传入值已含Bearer前缀则不再重复拼接。 - 请求形态:
marketing_campaign_report为 GET/campaign-group/reportMarketingCampaign,查询参数走 URL query。
适用边界与注意点
- 仅覆盖单接口查询;若业务需要多步(登录、筛选、导出等),由上层 agent 按聚合 skill 或计划文档组合多个原子 skill,本 skill 只完成本步并把关键字段传出。
- 返回必须以接口响应为事实来源,不要补造优惠金额、订单号、物流状态等业务字段。
- 认证、权限、参数或业务错误时,应把原始错误码与错误信息向上传递,便于上层重试或改参。
使用场景
- 海外运营对账前,需按 BusinessReportRequest 从正式环境拉取营销活动分组花费报表
- 上层 agent 编排 platform-reporting 链路时,只需完成 marketing_campaign_report 一步并传递接口原始字段
- 用户询问某段时间营销活动花费,且只需 Kutetailor campaign-group 报表接口的查询结果
- 多接口业务中先查营销活动花费,再把返回数据交给后续 skill 做汇总或对比
适合人员
- 负责海外营销活动对账、需从 Kutetailor 后台报表接口取花费数据的运营
- 搭建 platform-reporting 原子 skill 编排的 agent 开发者,要插入单次 GET 报表步骤
- 按活动分组核对营销预算消耗、依赖正式环境 campaign-group 接口的财务或增长分析
- 在对话中查询营销活动花费、且不能手写或篡改 base_url 与 Bearer 的业务分析同学