为分析工具命名 ID

Adapty SDK 会将每次屏幕浏览和每个回答上报给您的应用。每个事件都包含其所属屏幕或元素的 ID，而这些 ID 正是您自己的分析工具所展示的内容。默认情况下，屏幕 ID 的格式类似 scr_oAPBHPa7，因此在 Amplitude 或 Mixpanel 中查看漏斗时，看到的全是一列代码，还需要有人手动维护一份代码与名称的对照表。

您可以自定义这些 ID。输入控件和可选组的命名在付费墙编辑工具中设置，屏幕 ID 则通过 flow-generator skill 来设置——修改后，该 ID 在整个流程中所有引用该屏幕的地方都会同步更新。

用途说明

• 团队成员都能看懂的漏斗：welcome → signup → paywall 这样的序列一目了然，三个自动生成的代码却让人摸不着头脑。
• 与自有工具共用同一套命名体系：应用转发的每个事件都以相同方式命名页面，这样漏斗、同期群和看板筛选器无需对照表即可保持一致。
• 便于查询的答案：命名为 beginner 的测试选项是分析师可以直接筛选的值，而自动生成的 ID 则需要先解码。

您的分析工具能看到哪些 ID

两个事件会携带 ID。flow_screen_showed 在用户打开某个屏幕时触发，flow_user_input 在用户填写输入框、选择测验答案或拨动开关时触发。每份指南都记录了对应事件的所有参数，本表仅涵盖用于标识屏幕或元素的参数。

命名输入框和测验选项

输入框和可选组在编辑工具中都有 ID 字段。输入框的 Element ID 位于 Input settings 中，这也是你在流程其他地方引用该值时使用的 ID — 详见输入框与表单。可选组的 Group ID 位于 Screen settings > Selectable groups 中，其中每个选项也有各自的 Element ID。

给每个 ID 起一个一看就懂的名字，因为这个字符串就是你的分析工具里显示的内容。birthday 和 beginner 无需解释，而 el_024F 就需要额外维护一份映射表了。

添加元素时就设置好 ID，不要事后再改。条件和文本变量指向的是元素 ID，修改 ID 不会自动更新它们——它们会直接失效，且不报任何错误。如果要重命名一个已正常运行的流程中的 ID，需要逐一更新所有引用了该 ID 的条件和变量。详见元素 ID 修改后条件与变量失效。

flow-generator 技能会在构建流程时自动为元素命名。flow-audit 技能会报告所有缺失 ID 的元素。

重命名屏幕

流程编辑工具没有提供屏幕 ID 的输入字段，可以向技能发出请求：

Give the screens in my onboarding flow readable IDs.

技能会为每个屏幕提出一个名称，然后在流程中所有引用该屏幕的地方统一完成重命名——包括屏幕本身、每个指向该屏幕的导航动作，以及关联的产品。之所以要一起修改，是因为只在一处改名而其他地方没有同步，流程将无法发布。

它会告诉你修改了哪些名称以及移动了多少个引用，并且不会执行与已有页面冲突的重命名操作。在已正常运行的流程中，页面 ID 可以安全重命名，但 Element ID 则不同：重命名后，系统会将所有相关引用一并迁移。

检查内容

• 在流程上线前重命名：已收集的事件会保留旧 ID。跨越该变更的漏斗会显示两个填充了一半的屏幕，且重命名回去也无法合并它们。Adapty 的流程数据图表也会以同样的方式拆分，因为它按 ID 对屏幕行进行分组——被重命名的屏幕会生成第二行，与第一行使用相同的标签。
• 同一组内的每个选项都需要有独立的 Element ID：如果某个选项缺少 Element ID、两个选项共用同一个，或者 Group ID 在另一个屏幕上被重复使用，则整个组都不会上报任何数据——不只是该选项。编辑工具中没有任何提示，因此在添加选项后请仔细检查该组。
• ID 会原样传入你的分析系统：选定一种命名风格，例如 plan_selection 或 planSelection，并在整个流程中保持一致。风格混用比生成的代码更难查询。

限制

• 屏幕 ID 只能通过技能重命名：付费墙编辑工具中没有对应的字段。
• Adapty 的流程数据图表不会显示这些名称：流程数据图表 会以流程已发布版本的 <位置>. <标题> 格式标注屏幕，因此无论屏幕 ID 是什么，显示的都是 9. Paywall A。这里的 ID 只会传入您自己的分析系统。
• 重命名不会迁移历史数据：旧事件仍保留旧 ID。
• 部分元素不会发送输入事件：密码字段、产品选择和标签切换始终不上报。为这些元素命名只会影响流程本身，不会影响您的分析数据。