数据集成助手
AE 数据集成全指南——SDK 集成、LogBus2 配置、数据格式校验、用户身份体系、生产红线，基于官方文档精准回答所有数据接入问题。
数据采集
数据工程全行业AE Data Integration Assistant Skill 是 ThinkingAI 行业 Skill 库中的一项数据集成问答能力，帮助开发与数据团队快速获取 ThinkingData 全平台 SDK 集成、数据格式规范、用户身份体系、LogBus2/DataX/Restful API 配置、生产环境红线等问题的精准答案，所有回答严格基于官方 wiki 文档而非经验猜测，配套 FAQ 文档库和完整参考索引，从"不知道怎么集成"升级为"官方文档精准定位"的数据接入模式。这正是 ThinkingAI「10 年行业经验沉淀为开箱即用 Skill」的体现。
snake_case 检查battle_id 空值率 23%，显著异常校验完成。26 个新增事件里查出 5 个问题项，其中 3 个是上线前必须修复的阻断级——仅 amount 一项就已在测试服积累 4,200 条错误数据。人工逐条比对这种量级通常要两天，这轮校验十分钟出结果，明晚上线前还有完整的修复加回归窗口。
一、四维校验结果
| 校验维度 | 检查范围 | 结果 | 发现 |
|---|---|---|---|
| 完整性 | 26 个新增事件对账 | 2 个漏埋 | gift_receive、mail_claim 测试服零上报，客户端漏接调用 |
| 参数类型 | 71 个属性逐一比对 | 1 处类型错报 | amount 方案定义 number、实际上报 string，两天已积累 4,200 条错误数据 |
| 命名规范 | 事件名 / 属性名规则 | 1 处大小写不一致 | itemUse 应为 item_use，事件名大小写敏感，会分裂成两个事件 |
| 空值率 | 关键属性非空检查 | 1 个属性异常 | battle_id 空值率 23%（历史基线 2%） |
二、问题归因
最危险的是 amount：客户端拼参数时把金额转成了字符串 → 方案定义是 number → AE 属性类型以首次上报为准，一旦生产项目被 string 锁定，后续正确的 number 上报会因类型不一致被丢弃 → BI 付费求和只能统计到部分事件，按测试服付费事件占比推算偏差约 15%。好在错报目前只发生在测试项目，生产项目尚未写入——这是唯一还能无痛修复的窗口。
battle_id 的 23% 空值率是取值时机问题：battle_end 在结算回调返回前就触发了 ta.track，字段尚未赋值。两个漏埋事件（gift_receive、mail_claim）是客户端漏接调用——方案里有、代码里没有。itemUse 则是命名走样：上线后会和方案里的 item_use 分裂成两个事件，分析时谁都查不全。
行业痛点
数据接入是数据分析体系的起点，但超过 50% 的团队在首次集成时遇到至少一个"文档没写清楚"的问题。客户端 SDK 初始化参数在不同平台完全不同，服务端 Consumer 选择直接影响数据可靠性但文档分散在不同章节，用户身份体系理解错误会导致用户数据割裂。更隐蔽的是数据格式红线：属性类型一旦确定不可更改、事件名大小写敏感但属性名不敏感，违反规则的代价是数据被丢弃且无法恢复。
核心价值
- 官方文档全覆盖：客户端 11 个 SDK + 服务端 5 个 SDK + LogBus2/DataX/Restful API + 数据格式/用户身份/预置属性
- 数据格式红线：属性类型不可更改、事件名大小写敏感、生产环境禁止 DebugConsumer、服务端推荐 LoggerConsumer + LogBus2
- 用户身份体系：distinct_id（设备级）与 account_id（账户级）的绑定时机和跨端一致性要求
- 多语言文档 URL：根据用户语言自动适配 lan 参数（中文 zh-CN / 英文 en-US），直接定位对应 SDK 官方文档页面
- FAQ 文档库：每个 SDK 都有专属 FAQ 文档，常见报错原因和解决方案一键获取
适用场景
首次集成 AE SDK 时不确定初始化参数和调用方式
服务端上报需要选择 Consumer 类型（LoggerConsumer vs BatchConsumer vs DebugConsumer）
用户身份体系设计不确定 distinct_id 与 account_id 的绑定时机
数据格式疑问：属性类型、事件命名规则、预置属性、时间校准
LogBus2/DataX/Restful API 配置和常见报错排查
生产环境上线前需要确认红线规则
实战案例
常见疑问
这个 Skill 和 AE SDK 集成问答有什么区别？
AE Data Integration Assistant 更侧重数据接入全流程指南，AE SDK 集成问答更侧重埋点上报的具体 API 调用和代码示例。
支持哪些语言问答？
中文、英文均可输入，Skill 会以用户输入语言回复。官方文档 URL 自动适配语言参数。
生产环境有哪些红线？
禁止 DebugConsumer、禁止 Debug 模式、必须使用 Normal 模式、服务端推荐 LoggerConsumer + LogBus2、程序退出前必须调用 close() 避免缓存丢失。
相关 Skills 推荐
用「数据集成助手」武装你的 Agent
预约演示，看看它如何在你的业务场景中落地
