酷特海外运营营销活动点击统计报表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-campaign-click-report。
技能介绍
要解决什么问题
海外运营平台上的营销活动需要复盘曝光与点击效果时,往往要查「点击统计报表」:按活动 ID 汇总点击相关指标。若让 Agent 自行拼 URL、猜参数形态,容易混用测试地址、漏传 campaignId 或把 Path/Query 写错。本技能把该能力收敛为单一原子动作 click_report,只负责一次 GET 调用并把接口原样结果交给上层编排。
技能如何工作
- 固定正式环境:执行器使用 frontmatter 中的
base_url(https://www.kutetailor.com/api/marketing/...),不接受用户输入覆盖。 - 统一参数壳:tool 参数最外层仅
params;Path 中的{campaignId}写入params.path.campaignId(或等价 path 字段,按 skill 约定替换 URL 占位符)。 - 登录态:需 Bearer 时在
params.accessToken传入;值已含Bearer前缀则不再重复拼接。 - 动作映射:
click_report→GET /campaign-click-history/clickReport/{campaignId},响应用途为点击统计报表(资料中记为 RS 返回)。
多步业务(例如先查活动列表再出报表)应由上层 Agent 按聚合 skill platform-marketing-campaign 或计划文档串联多个原子 skill;本 skill 只完成本接口。
边界与注意点
- 返回字段必须以接口响应为事实来源,不要补造库存、订单号、优惠金额等未在响应中出现的数据。
- 认证、权限、参数或业务错误时,应把原始错误码与错误信息传给上层 Agent,便于重试或换路。
- 这是查询/计算类接口,仍受当前登录态、租户与用户权限约束;无权限时不会「推断」报表内容。
使用场景
- 用户已拿到某次海外营销活动的 campaignId,需要拉取该活动的点击统计报表做复盘
- Agent 在编排「查活动→出报表」链路时,只需执行 click_report 这一步 GET 并向下游传递 RS 字段
- 运营同学在正式环境核对活动页点击汇总,要求固定 kutetailor 域名且带登录态 Bearer
- 接口返回权限或参数错误时,需要把原始错误码交给上层决定是否换活动 ID 或重新鉴权
适合人员
- 负责酷特海外营销活动复盘、需按活动 ID 导出点击报表的运营分析同学
- 把 platform-marketing-campaign 拆成原子 skill 集成进 Agent 的平台接口维护者
- 在对话里让用户口述 campaignId 后自动查点击报表的客服/运营助理场景搭建者
- 对接 kutetailor 营销接口、必须遵守 params 嵌套与不可覆盖 base_url 的后端协作者