进阶功能

1.自动采集事件

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

2.开启 Debug 模式

Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

当前 SDK 实例支持两种运行模式：

• "none": 不开启 Debug
• "debug": 开启 Debug 模式，并入库

可以在 SDK 初始化的时候配置 Debug 模式：

var config = {
  debugMode: "debug",
};
var ge = new GE(config);

3.onComplete 回调函数

对于 track, userSet, userSetOnce, userAdd, userDel, userAppend, userUniqAppend、userNumberMax、userNumberMin 等方法，支持传入 onComplete 回调. 可以直接在原参数列表后传入 onComplete,

也可以使用参数对象的方式. 如果使用参数对象，参数对象中必须包含 onComplete, 否则会出现参数错误.

以上传事件为例：

// 以参数列表的形式传入回调
ge.track("test", { testkey: 123 }, new Date(), (res) => {
  console.log(res);
});

// 以参数对象的形式传入回调
ge.track({
  eventName: "test", // 必填
  properties: { testkey: 123 }, // 可选
  time: new Date(), // 可选
  onComplete: (res) => {
    console.log(res);
  }, // 必填
});

onComplete 的参数 res 为 object 类型，有两个属性 code 和 msg.

• res.code 为 int 类型，定义如下:

  • 0：成功
  • -3：网络或服务端异常
  • 2001：应用未授权或已过期
  • 2000：权限不足 该用户尚未初始化
  • 1004：参数错误 一般是参数类型错误，或者缺失参数
  • 1001：数据错误 json 解析错误

• res.msg 是对 res.code 的文字说明。

4.绑定三方平台

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

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

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

4.1 引力后台配置

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

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

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

回传模式选择：

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

 

回传数据映射：

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

4.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	是