同步归因

约 512 字大约 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"
}

兜底回调链接

为了避免每个推广活动都需要配置一遍归因回调链接,我们提供了兜底回调链接,在回调触发时,会优先使用推广活动下的归因回调链接,若当前推广活动没有配置,则取兜底回调链接来完成归因信息的数据回调。

您可以在引力后台-设置-应用管理-三方配置中添加兜底回调链接