酷特海外运营 · 营销活动销售查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-reporting-query-sales。
技能介绍
要解决什么问题
海外运营同学在复盘营销活动时,往往需要把活动维度的销售结果从酷特海外运营平台里拉出来,而不是在多个报表页里手工对照。本技能对应平台侧的一个最小动作:query_sales,专门做营销活动销售查询,适合被上层 Agent 当成报表链路里的一个 HTTP 步骤。
技能如何工作
执行时固定向正式环境发起 POST 请求,路径为 /order/order/orden/querySales(完整 base_url 以技能 frontmatter 为准,不接受用户改写域名)。请求体按接口约定使用 MarketingCampaignSalesRequest 形态的 JSON;tool arguments 只使用顶层 params 对象,其中 Body 写在 params.body,登录态通过 params.accessToken 生成 Authorization: Bearer(若已带 Bearer 前缀则不再拼接)。
返回内容必须以接口响应为准:活动销售相关字段交给后续 skill 或聚合编排继续处理,本技能不负责拼完整业务故事。
适用边界与注意点
- 单接口原子能力:若用户需求包含登录、筛选多报表、导出等多步操作,需要由上层按
platform-reporting等聚合 skill 或计划文档组合多个原子 skill;本技能只完成本次查询调用。 - 权限与错误:仍受当前租户、用户权限约束;认证、参数或业务失败时,应把原始错误码与错误信息向上传递,不要本地编造销量、订单号或优惠金额。
- 参数形态:不要使用
params.xxx这类点号顶层 key;需要额外 Header 时写入params.headers。
使用场景
- 复盘某场海外营销活动时,需要从酷特运营平台拉取该活动的销售汇总数据
- Agent 编排报表链路时,在已具备 accessToken 的前提下调用 querySales 补齐活动销售一步
- 对比多场活动效果时,按活动维度重复调用本接口获取各次 query_sales 返回字段
- 上层聚合 skill 执行到「营销活动销售查询」节点,由本原子技能完成单次 POST 请求
适合人员
- 负责海外营销活动复盘、需要按活动查销售数据的运营同学
- 搭建酷特平台报表 Agent 的工程师,要把 query_sales 封装成可编排的原子步骤
- 用上层 skill 串联订单与报表链路的实施人员,缺活动销售查询这一环时接入本技能
- 海外运营数据分析岗,在自动化脚本里用固定正式环境地址查询 MarketingCampaignSales