跳到主要内容
当前模块归因
AI-ready documentation

同步归因

说明如何在用户注册时开启同步归因,以便立即取得当前用户的买量归因结果。

查看 Markdown

如果您需要在用户注册引力完成之后,立即获知当前用户的买量归因等信息,您可以在调用引力注册接口时,开启同步归因(具体如何开启,可以参考具体技术栈对接文档中注册引力的接口调用)。

开启之后,引力将同步执行归因逻辑,并阻塞注册接口调用,在归因完成之后,才会返回归因数据。此时返回的归因数据,即为最终归因结果。

开启之后极端情况会有长达 10s 的接口阻塞,请谨慎开启! 如您不需要立即获知归因结果,则可以参考 归因回调链接 功能,可能更符合您的数据分析需求!

开启之后,返回的归因接口字段如下所示:

字段类型说明
tokenstring用户 token,可忽略
click_companystring归因平台,允许的枚举值请参考 广告平台枚举值
turbo_promoted_object_idstring引力推广活动 ID
ad_paramsobject在归因回调链接里拼接的参数,可参考下方「参数拼接」部分

示例:

{
  "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"
}

兜底回调链接

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

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

本页内容