AI-ready documentation
进阶功能
汇总 Gravity Engine Web SDK 的进阶配置与调用示例,包括第三方平台绑定等扩展能力。
1. 绑定三方平台
引力支持与数数 BI 打通,具体如下:
在用户归因成功之后,引力将使用数数的数据接收接口透传数据到数数后台,方便您在数数平台实时查看用户买量数据(如广告主账户 ID、计划 ID 等等)。你需要完整完成以下两步,才能正常接收数据到数数系统:
- 引力后台配置数数相关
- 客户端代码触发三方绑定事件上报
1.1 引力后台配置
您需要先在引力后台-设置-应用管理页面配置项中配置好数数科技回调,需提供以下信息:
数数应用 id:从数数后台获取对应产品的 id
数数采集地址:根据数数接收接口文档找到您公司对应的采集地址,采集地址以 sync_json 结尾
回传模式选择:
- user_set:多次回调数据到数数时,将会覆盖原有的属性值
- user_setOnce:多次回调数据到数数时,如该属性之前已经有值,则忽略本次更新

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

1.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 至少传一个 |
| taDistinctId | 当前用户的数数访客 ID (#distinct_id) | string | 二选一 | 与 taAccountId 至少传一个 |