进阶功能

1. 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 的文字说明。

2. 绑定三方平台

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

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

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

2.1 引力后台配置

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

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

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

回传模式选择：

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

回传数据映射：

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

2.2 触发【三方绑定事件】

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

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

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

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

方法示例

ge.bindTAThirdPlatform(CURRENT_USER_TA_ACCOUNT_ID, CURRENT_USER_TA_DISTINCT_ID);

参数说明