1.自动采集
引力引擎 SDK 支持自动采集一些基础事件以降低您的接入成本,您可以参考自动采集一文来快速开启。
2.开启 Debug 模式
Debug
模式可能会影响数据采集质量和 App 的稳定性,只用于集成阶段数据验证,不要在线上环境使用。
当前 SDK 实例支持两种运行模式:
- "none": 不开启 Debug
- "debug": 开启 Debug 模式,并入库
可以在 SDK 初始化的时候配置 Debug 模式:
var config = {
mode: "debug",
};
// 调用init的时候,传入此config
3.绑定三方平台
引力支持与数数BI打通,具体如下:
在用户归因成功之后,引力将使用数数的 数据接收接口 透传数据到数数后台,方便您在数数平台实时查看用户买量数据(如广告主账户ID、计划ID等等)。你需要完整完成以下两步,才能正常接收数据到数数系统:
- 引力后台配置数数相关
- 客户端代码触发三方绑定事件上报
3.1 引力后台配置
您需要先在引力后台-设置-应用管理页面配置项中配置好数数科技回调,需提供以下信息:
数数应用id:从数数后台获取对应产品的id
数数采集地址:根据数数接收接口文档找到您公司对应的采集地址,采集地址以sync_json结尾
回传模式选择:
- user_set:多次回调数据到数数时,将会覆盖原有的属性值
- user_setOnce:多次回调数据到数数时,如该属性之前已经有值,则忽略本次更新

回传数据映射:
- 键:填入您在数数后台创建的用户属性,用于存放回传的值
- 值:选择宏参数,可选的宏参数相关信息请参考引力后台显示
- 快速调试:输入上报给引力的用户clientid,测试该用户的归因信息是否正常回调给数数。需要注意,自然量不会回调给数数,仅归因为买量平台的用户会进行回调。

3.2 触发【三方绑定事件】
为确保引力能正常执行数数回调,请务必在接入完成后进行以下验证:
- 触发【三方绑定事件】上报
- 在用户细查-深度挖掘模块中检查该用户的行为序列
- 确认行为序列中已包含【三方绑定事件】
若未检测到该事件,请检查接入流程是否完整。此验证步骤对确保回调功能正常运行至关重要。
引力会自动将引力
client ID
和您传入的数数account_id
以及distinct_id
做关联,在回调数数接口时,通过这个关联传递对应的account_id
、distinct_id
给数数后台
方法示例
ge.bindTAThirdPlatform(CURRENT_USER_TA_ACCOUNT_ID, CURRENT_USER_TA_DISTINCT_ID);
参数说明
参数名称 | 参数含义 | 参数类型 | 是否必传 |
taAccountId | 当前用户的数数账户 ID (#account_id) | string | 是 |
taDistinctId | 当前用户的数数访客 ID (#distinct_id) | string | 是 |