进阶功能

1.自动采集事件

引力引擎 SDK 支持自动采集一些基础事件以降低您的接入成本，您可以参考自动采集一文来快速开启。

2.开启 Debug 模式

SDK 支持在两种模式下运行：

• Normal: 线上模式，数据会存入缓存，并依据一定的缓存策略上报
• Debug: 测试模式，数据逐条上报。当出现问题时会以日志和异常的方式提示用户，您也可以去事件流中查看实时上报的数据数，辅助您判断数据接入是否正常。

您在调用 StartGravityEngine 初始化引擎时，可以传入 SDKRunMode 参数来指定 SDK 运行模式。

Debug 模式仅仅用于集成阶段数据校验，不要在生产模式下使用！

3.绑定三方平台

引力支持与数数BI打通，具体如下：

在用户归因成功之后，引力将使用数数的 数据接收接口 透传数据到数数后台，方便您在数数平台实时查看用户买量数据（如广告主账户ID、计划ID等等）。你需要完整完成以下两步，才能正常接收数据到数数系统：

1. 引力后台配置数数相关相关
2. 客户端代码触发三方绑定事件上报

3.1 引力后台配置

您需要先在引力后台-设置-应用管理页面配置项中配置好数数科技回调，需提供以下信息：

数数应用id：从数数后台获取对应产品的id

数数采集地址：根据数数接收接口文档找到您公司对应的采集地址，采集地址以sync_json结尾

回传模式选择：

• user_set：多次回调数据到数数时，将会覆盖原有的属性值
• user_setOnce：多次回调数据到数数时，如该属性之前已经有值，则忽略本次更新

 

回传数据映射：

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

3.2 触发【三方绑定事件】

为确保引力能正常执行数数回调，请务必在接入完成后进行以下验证：

• 触发【三方绑定事件】上报
• 在用户细查-深度挖掘模块中检查该用户的行为序列
• 确认行为序列中已包含【三方绑定事件】

若未检测到该事件，请检查接入流程是否完整。此验证步骤对确保回调功能正常运行至关重要。

引力会自动将引力 client ID 和您传入的数数 account_id 以及 distinct_id 做关联，在回调数数接口时，通过这个关联传递对应的 account_id、distinct_id 给数数后台

方法示例

GravityEngineAPI.BindTAThirdPlatform(CURRENT_USER_TA_ACCOUNT_ID, CURRENT_USER_TA_DISTINCT_ID);

参数说明

参数名称	参数含义	参数类型	是否必传
taAccountId	当前用户的数数账户 ID (#account_id)	string	是
taDistinctId	当前用户的数数访客 ID (#distinct_id)	string	是

4.校准时间

4.1 通过时间戳校准 

SDK 默认会使用本机时间作为事件发生时间上报，如果用户手动修改设备时间会影响到您的业务分析，您可以使用从服务端获取的当前时间戳对 SDK 的时间进行校准。此后，所有未指定时间的调用，包括事件数据和用户属性设置操作，都会使用校准后的时间作为发生时间。

代码示例

//时间戳,单位毫秒 对应时间为1668982523000 2022-11-21 06:15:23
GravityEngineAPI.CalibrateTime(1668982523000);

4.2 通过 NTP 服务器校准 

我们也提供了从 NTP 获取时间对 SDK 校准的功能。您需要传入您的用户可以访问的 NTP 服务器地址。之后 SDK 会尝试从传入的 NTP 服务地址中获取当前时间，并对 SDK 时间进行校准。如果在默认的超时时间（3 秒）之内，未获取正确的返回结果，后续将使用本地时间上报数据。

除了以上校准时间接口外，SDK 还提供了所有用户属性接口的时间函数重载，您可以在调用用户属性相关接口时，传入 DateTime 对象，则系统会使用传入的 DateTime 对象来设定数据的 time 字段。

代码示例

//NTP 时间服务器校准，如：time.apple.com
GravityEngineAPI.CalibrateTimeWithNtp("time.apple.com");

• 使用 NTP 服务进行时间校准存在一定的不确定性，建议您优先考虑用时间戳校准的方式

• 您需要谨慎地选择您的 NTP 服务器地址，以保证网络状况良好的情况下，用户设备可以很快的获取到服务器时间

• 关于 NTP 服务器相关更多信息请参考：https://dns.icoa.cn/ntp/