AE 埋点代码生成

从埋点方案自动生成 AE SDK 初始化、事件上报、公共属性设置、用户属性上报的完整代码，覆盖客户端与服务端全平台，配套 LogBus2 配置与校验脚本。

数据采集

数据工程游戏电商工具社交内容数据接入

AE 埋点代码生成 Skill 是 ThinkingAI 行业 Skill 库中的一项代码生成能力，帮助开发与数据团队从埋点方案（xlsx 或 AE 项目）一键生成各平台 SDK 的初始化代码、事件上报代码、公共属性设置、用户属性上报代码、LogBus2 配置文件及校验脚本，覆盖 Android / iOS / Web / 小程序 / Unity / Java / Python / Go 等十余个平台，告别手动逐事件逐属性拼接代码的低效模式。这正是 ThinkingAI「10 年行业经验沉淀为开箱即用 Skill」的体现。

Agent存为 Agent导出会话

ae-tracking-code-generation

三消小游戏的埋点方案已经在 AE 项目里了，一共 45 个事件。这周五前要把 H5 端和 Java 服务端的上报代码全写完——上次手写一版，包名和 API 签名错了一堆。H5 端直接注入项目代码，服务端给我独立文件就行。

读取 AE 项目埋点方案

45 个事件 / 120 个属性；客户端事件 28 个、服务端事件 17 个

强制读取 Web JS SDK 与 Java SDK 官方 wiki 文档，锁定包名与 API 签名

生成 H5 端代码（insert 模式）— 初始化、公共属性、ta.track 上报注入项目

改写 src/lib/ta-tracking.js 等 6 个文件，覆盖 28 个客户端事件

生成 Java 服务端代码（snippet 模式）— LoggerConsumer 架构 + LogBus2 daemon.json

生成校验脚本 TaDebugTest.java

抽样 5 个事件模拟上报，用于 AE Debug 页面验证

双端代码生成完毕。45 个事件、120 个属性按端拆分：H5 端 28 个事件以 insert 模式直接注入项目，Java 服务端 17 个事件以 snippet 模式输出独立文件——所有包名与 API 签名生成前都对照了官方 wiki 文档，不会再出现凭记忆拼 API 的问题。

一、H5 端代码节选（初始化与上报）

javascript

// 初始化 AE JS SDK（appId / serverUrl 来自 AE 项目设置）
ta.init({
  appId: 'demo-appid-2c9f81',
  serverUrl: 'https://receiver.demo-project.com'
});

// 公共属性统一携带，28 个客户端事件不再逐个重复定义
ta.setSuperProperties({ channel: 'official_h5', app_version: '1.8.2' });

// 登录成功回调内绑定账号（distinct_id 与 account_id 关联）
ta.login(accountId);

// 关卡结算上报：事件名、属性名与类型均对齐方案
ta.track('stage_end', {
  stage_id: 'level_042',
  result: 'win',
  duration: 97,
  coin_gain: 380
});

二、埋点规范要点

数值属性传 number：duration、coin_gain 这类字段的类型以首次上报为准，传成 string 会把后续 BI 口径整个带偏

ta.login 只在登录成功回调里调用——过早调用会把游客行为错绑到账号上

公共属性初始化后设置一次即可，28 个客户端事件里不再重复携带 channel、app_version

payment 等 17 个资产类事件全部走服务端上报，客户端不留任何金额相关调用

三、各端输出产物与模式

平台	输出模式	产物	覆盖事件
H5（Web JS SDK）	insert	注入 src/lib/ta-tracking.js 等 6 个文件	28 个
Java 服务端	snippet	TaTracker.java（LoggerConsumer 架构）	17 个
LogBus2	配置文件	daemon.json（目录与 appId 已按项目填好）	—
校验脚本	snippet	TaDebugTest.java	抽样 5 个

← 左右滑动查看

建议

上线前先跑 TaDebugTest：脚本会向测试项目上报 5 个抽样事件，到 AE Debug 页面确认数据到达、再把 appId 切到生产项目。同规模（45 事件）双端代码手写平均 3-5 天，这批产物从生成到验证预计半天内可以走完。

产物已输出至项目目录；Java SDK 与 LogBus2 的官方文档链接附在各文件头部注释里。

行业痛点

埋点方案设计完成后，落地到代码是最耗时也最容易出错的环节。一个中等规模项目（30 个事件、80 个属性）的埋点代码手动编写通常需要 3-5 天，且不同平台的 SDK 初始化方式、API 调用规范、包名引用完全不同。超过 40% 的首次埋点代码集成存在包名引用错误、初始化参数遗漏、公共属性未设置、用户身份关联缺失等典型问题。服务端上报还涉及 LoggerConsumer + LogBus2 的架构选择和配置文件编写，多数开发者不熟悉这套机制。

核心价值

全平台覆盖：客户端（Android / iOS / OpenHarmony / Web / 小程序 / Unity / Cocos）+ 服务端（Java / Python / Go / Node.js / PHP / C#）
双输出模式：insert（直接注入项目代码）和 snippet（生成独立代码文件），按项目阶段灵活选择
服务端标配 LoggerConsumer + LogBus2：默认生成安全的数据上报架构，配套 daemon.json 配置文件和官方文档链接
校验脚本自动生成：一键生成验证上报是否正确的测试代码，从"写完代码"到"确认数据到达 AE"只需一步
严格对齐 SDK 官方文档：每次生成代码前强制读取对应 SDK 的官方 wiki 文档，绝不猜测包名或 API 签名

适用场景

埋点方案完成后需要快速生成各平台 SDK 代码落地

多端上报项目需要同时生成客户端和服务端代码

手动编写埋点代码反复出错需要自动化生成

新项目从零集成 AE SDK 需要初始化代码和上报模板

服务端上报需要配置 LoggerConsumer + LogBus2 架构

上线前需要校验脚本验证埋点上报是否正确

实战案例

某游戏项目 · Android 与 Java 双端上报

埋点方案包含 45 个事件和 120 个属性。Skill 分别生成 Android 客户端 `android-sdk.kt`、Java 服务端 `java-sdk.java`、LogBus2 `daemon.json` 与校验脚本 `te-debug.java`。运行校验脚本后 AE Debug 页面确认数据到达，3 天内完成从方案到代码上线的全流程，对比过往手动编写平均耗时 7 天，效率提升超过一倍。

常见疑问

和埋点方案生成 Skill 有什么区别？

埋点方案生成产出方案文档；AE 埋点代码生成产出可执行代码，包括 SDK 初始化、track() 调用和配置文件。前者是设计，后者是落地。

insert 和 snippet 模式怎么选？

已有项目代码且希望直接注入时选 insert；新项目或只想拿到代码参考时选 snippet。同一项目的不同平台可以混选。

服务端为什么默认用 LoggerConsumer？

LoggerConsumer 将数据写入本地日志文件，由 LogBus2 批量同步至 AE，具备数据不丢失、可控重传的优势；生产环境推荐 LoggerConsumer + LogBus2 架构。

校验脚本能验证什么？

校验脚本会模拟上报测试数据，开发者运行后在 AE Debug 页面确认数据是否到达，快速验证 SERVER_URL、APP_ID 和上报逻辑。