---
topic: SDK 选型指南
sources:
  - raw/接入指南/客户端-sdk.md
  - raw/接入指南/服务端-sdk.md
  - raw/接入指南/数据导入.md
  - raw/接入指南/restful-api-使用指南.md
  - raw/接入前准备工作/数据规则.md
generated: 2026-04-15
---

# SDK 选型指南

本页综合各接入方式的特点，帮助您快速选择最适合场景的 AE 数据接入方案。

## 接入方式总览

| 接入方式 | 适用场景 | 数据延迟 | 开发成本 | 批量历史数据 |
|---|---|---|---|---|
| 客户端 SDK | 移动端/Web/游戏客户端行为采集 | 实时 | 低 | 不适合 |
| 服务端 SDK + LogBus | 后端业务事件、高精度数据 | 近实时 | 中 | 支持 |
| LogBus2（独立） | 日志文件监听、Kafka消费、大批量历史数据 | 近实时 | 低（配置型） | 最优 |
| DataX Writer | 多数据源迁移、离线同步 | 批量 | 中 | 适合 |
| Filebeat + Logstash | 已有ELK栈、日志管道复用 | 近实时 | 中（吞吐低） | 不推荐 |
| RESTful API | 无法集成SDK的场景、快速验证 | 实时 | 中（需自行处理） | 支持（手动） |

## 客户端 SDK

[[raw/接入指南/客户端-sdk.md]] 中列出的客户端覆盖范围：

**移动原生**：Android、iOS、OpenHarmony、macOS

**Web**：JavaScript（Vue2/3、React、Angular、Electron，~58 KB）

**小程序/小游戏**：微信小程序等

**游戏引擎**：Unity、Unreal、Cocos2d-x、Cocos2d-Lua、CocosCreator、LayaAir、Egret、Corona

**跨平台框架**：React Native、Flutter、uni-app、C++客户端、C#客户端

客户端 SDK 自动管理访客 ID、账号 ID 的绑定，并在本地缓存 ID，适合需要自动采集用户行为的场景。

## 服务端 SDK

[[raw/接入指南/服务端-sdk.md]] 中支持的语言：Java、Golang、C、C#、Erlang、Ruby、Lua、Node.js、PHP、Python、C++。

服务端 SDK 的推荐模式是 **SDK 写本地日志文件 + LogBus 监听上传**，既保证数据不丢失，又避免对业务线程产生阻塞影响（[[raw/接入指南/服务端-sdk/java.md]]）。

## 批量日志接入（LogBus / DataX / Filebeat）

| 工具 | 推荐版本 | 特点 |
|---|---|---|
| LogBus2 | v2.1.2.2（推荐） | 内存占用减至 LogBus v1 的 1/5、速度提升 5 倍，支持 Kafka/SLS/CLS [[raw/接入指南/数据导入/logbus2-使用指南.md]] |
| LogBus v1 | v1.5.17（维护中） | 经典版本，仍可用，但建议迁移至 v2 [[raw/接入指南/数据导入/logbus-使用指南.md]] |
| DataX Writer | — | 适合从 MySQL/HDFS 等多数据源迁移数据，使用 ta-datax-writer 插件 [[raw/接入指南/数据导入/ta-datax-writer-插件使用指南.md]] |
| Filebeat + Logstash | Logstash 6.x+ | 已有 ELK 栈时复用，**吞吐量低，不适合大批量历史数据** [[raw/接入指南/数据导入/filebeat-logstash-使用指南.md]] |

## RESTful API

[[raw/接入指南/restful-api-使用指南.md]] 提供两种上报方式：

- **form-data**：`POST /sync_data`，参数 `appid`、`data`（urlencode）、`client`
- **raw JSON**：`POST /sync_json`，Body 直接包含 `appid` + `data` 字段

适用于：不便集成 SDK 的脚本/工具、快速数据验证、第三方系统对接。数据格式必须遵循 AE 数据规则（[[raw/接入前准备工作/数据规则.md]]）。

## 选型决策树

```
需要采集客户端行为？
  └─ 是 → 选对应平台的客户端 SDK
需要服务端业务事件？
  └─ 是 → 服务端 SDK + LogBus2
需要同步历史数据/多数据源迁移？
  └─ 大量 → LogBus2 或 DataX Writer
  └─ 少量 → RESTful API
已有 ELK 栈？
  └─ 是 → Filebeat + Logstash（注意吞吐限制）
```
