AI-ready documentation
同步归因
说明如何在用户注册时开启同步归因,以便立即取得当前用户的买量归因结果。
如果您需要在用户注册引力完成之后,立即获知当前用户的买量归因等信息,您可以在调用引力注册接口时,开启同步归因(具体如何开启,可以参考具体技术栈对接文档中注册引力的接口调用)。
开启之后,引力将同步执行归因逻辑,并阻塞注册接口调用,在归因完成之后,才会返回归因数据。此时返回的归因数据,即为最终归因结果。
开启之后极端情况会有长达
10s的接口阻塞,请谨慎开启! 如您不需要立即获知归因结果,则可以参考 归因回调链接 功能,可能更符合您的数据分析需求!
开启之后,返回的归因接口字段如下所示:
| 字段 | 类型 | 说明 |
|---|---|---|
token | string | 用户 token,可忽略 |
click_company | string | 归因平台,允许的枚举值请参考 广告平台枚举值 |
turbo_promoted_object_id | string | 引力推广活动 ID |
ad_params | object | 在归因回调链接里拼接的参数,可参考下方「参数拼接」部分 |
示例:
{
"token": "123456789",
"click_company": "bytedance",
"turbo_promoted_object_id": "af12sdafga6",
"ad_params": {}
}参数拼接
您可以在推广活动页面配置拼接参数,具体支持参数,请参考:归因回调链接,我们将把您配置的归因回调参数拼接到 ad_params 参数中。
举例:
?advertiser_id=__ADVERTISER_ID__&your_ad_id=__AD_ID__&a=b则这个推广活动带来的用户,返回的 ad_params 为:
{
"advertiser_id": "123456",
"your_ad_id": "123456",
"a": "b"
}兜底回调链接
为了避免每个推广活动都需要配置一遍归因回调链接,我们提供了兜底回调链接,在回调触发时,会优先使用推广活动下的归因回调链接,若当前推广活动没有配置,则取兜底回调链接来完成归因信息的数据回调。
您可以在引力后台-设置-应用管理-配置中添加兜底回调链接。