SuperAPI AI 工具集

ae-generate-tracking-plan

数据与分析

查看项目

更新于 10-15 14:59

技能介绍

用途

该技能用于以交互方式生成 AE 跟踪方案(tracking plan)并将其上传到 AE 平台。当用户提及「埋点方案」「埋点模板」「tracking plan」「AE 方案生成」「create tracking plan」「トラッキングプラン」「트래킹 플랜」等触发词时启用。覆盖的应用类型包括 H5 / Web / iOS / Android / 小程序 / Unity。

主要能力

  • 交互式分阶段引导,严格按照 Phase 0 → 1 → 2 → 3 → 4 的顺序执行,不跳步。
  • 支持多种素材来源:产品文档(md/pdf/docx/xlsx/pptx/URL/图片)、详细口头描述、代码库、内置行业与游戏品类模板、已有 AE 格式 xlsx 方案、数据样本(来自 ae-data-integration inspect 的文件画像)。
  • 支持最多选取两种素材来源进行组合(除数据样本为独立单源路径外),并按优先级合并:existing_plan → template → codebase → prd → chat。
  • 修改已有跟踪方案:导入现有 xlsx 作为基线,结合校验与修复后继续编辑。
  • 方案校验(validation)与冲突检测、上传、追加/替换、归档等操作。
  • 输出语言跟随用户输入语言(中文→zh,英文→en,日文→ja,韩文→ko,其它默认 en)。

使用方式

通过 ae-cli 命令行工具执行,主要命令包括:

  • ae-cli tracking plan draft
  • ae-cli auth login
  • ae-cli tracking plan upload
  • ae-cli tracking plan delete
  • ae-cli tracking code import-template --template <path> --out .ae-cli/draft.json
  • ae-cli tracking plan validate --in .ae-cli/draft.json --fix
  • AE_LANG=<user_lang> ae-cli tracking plan list-templates --json

所有 CLI 命令必须以 AE_LANG=<user_lang> 为前缀,上传命令还需传入 --lang <user_lang>,以保证 CLI 输出信息与生成的 xlsx 表头、服务端解析语言一致。

流程分阶段进行:

  • Phase 0(Anchor):逐条提问收集信息(每次只问一个问题),包括语言初始化、应用场景、素材来源与业务维度。
  • Phase 1 / 3 / 4 通过 ae-cli tracking CLI 执行。
  • 语言规则:新生成内容中面向用户的字段(display_name、event_desc、event_tag、属性 display_name、属性 desc 等)使用用户输入语言;标识符字段(event_name、prop_name)保持英文,属性名用 snake_case,事件名默认小写,除非用户要求保留大写。每个事件、事件属性、公共事件属性、用户属性都必须有非空的 display_name。模板导入内容不可手动翻译,须通过 src/tracking/i18n 模块与 AE_LANG=<user_lang>、draft.meta.lang 处理。

适用场景

  • 需要从零创建 AE 跟踪方案的产品或数据团队。
  • 需要基于产品文档、代码库或口头描述自动提取事件与属性的场景。
  • 需要在已有 AE 跟踪方案基础上修改、追加事件的场景。
  • 需要从数据样本(CSV/Excel/JSONL)的 inspect 画像映射列到事件与属性的场景。

限制

  • 已有方案 + 内置模板的组合不被允许(两者均提供事件基线,语义冲突)。
  • 数据样本为独立单源路径,不可与其它选项组合。
  • 产品文档在沙箱环境中仅可读取沙箱工作区内可读的文件(含用户上传/附件的文件),无法读取沙箱外任意本地路径,除非文件已挂载或附加。
  • 代码库选项在沙箱环境中默认隐藏,除非代码库已存在于可读工作区。
  • 本技能只关注命令行为,不涉及内部实现。

关于具体的收费、价格、平台支持细节及更多未提供的信息,暂未提供。