同步归因
约 510 字大约 2 分钟
同步归因
如果您需要在用户注册引力完成之后,立即获知当前用户的买量归因等信息,您可以在调用引力注册接口时,开启同步归因(具体如何开启,可以参考具体技术栈对接文档中注册引力的接口调用)。
开启之后,引力将同步执行归因逻辑,并阻塞注册接口调用,在归因完成之后,才会返回归因数据。此时返回的归因数据,即为最终归因结果。
警告
开启之后极端情况会有长达 10s
的接口阻塞,请谨慎开启!如您不需要立即获知归因接口,则您可以参考归因回调链接功能,可能更符合您的数据分析需求!
开启之后,返回的归因接口 JSON
字段如下所示,具体请参考注释描述:
{
"token": "123456789", // 用户token,可忽略
"click_company": "bytedance", // 归因平台,允许的枚举值请参考:https://doc.gravity-engine.com/turbo-integrated/others/enum.html
"turbo_promoted_object_id": "af12sdafga6", // 引力推广活动ID
"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"
}
兜底回调链接
为了避免每个推广活动都需要配置一遍归因回调链接,我们提供了兜底回调链接,在回调触发时,会优先使用推广活动下的归因回调链接,若当前推广活动没有配置,则取兜底回调链接来完成归因信息的数据回调。
您可以在引力后台-设置-应用管理-配置中添加兜底回调链接