混合上报模式
约 516 字大约 2 分钟
混合上报模式
如果您应用内有些事件需要通过自有后端直接报送给引力引擎，那我们推荐您使用 混合上报模式 来完成接入，继续阅读本篇文档，我们将以付费事件为例讲解混合上报模式的接入步骤。
1. 客户端接入
客户端接入引力引擎提供的 SDK，不同客户端技术栈，对应不同的 SDK，具体可以参考 接入前准备工作。
提示
客户端 SDK 会负责自采集很多基础事件和属性，这部分工作引力提供的 SDK 已经完成封装。
2. 后端接入
后端接入事件收集上报接口，完成事件的后端报送功能，您需要注意以下几点：
- 后端仅负责事件的收集上报，不负责用户的注册，用户注册需要调用客户端 SDK 的
initialize方法完成； - 前后端使用的用户
client id需要保持一致； - 在客户端完成
initialize方法调用之后，后端才能开始做事件采集上报，否则上报不成功； - 后端接入事件上报时，请参考 元事件页面 下关于事件的详情属性；
- 请尽量上报事件的公共属性，引力不做强制要求，但是上报足够多属性，可以方便您后续在引力平台使用数据分析功能（
$city、$province、$country、$browser、$browser_version属性可以不上报，引力后端会自动采集）； - 关于属性的更多信息，请您参考 事件属性页面。
以后端上报付费事件为例，您需要传入如下属性
{
"type": "track",
"event": "$PayEvent",
"time": 1669860000000,
"time_free": true,
"properties": {
"$lib_version": "1.0",
"$lib": "api",
"$network_type": "4g",
"$manufacturer": "HONOR",
"$brand": "HONOR",
"$model": "JLH-AN00",
"$screen_width": 360,
"$screen_height": 796,
"$system_language": "zh_CN",
"$os": "android",
"$os_version": "Android 12",
"$pay_amount": 600,
"$pay_type": "CNY",
"$order_id": "你的订单ID",
"$pay_reason": "月卡",
"$pay_method": "微信",
"$is_first_pay": false,
"$ip": "用户真实IP"
}
}