# 同步归因

> 来源：https://help.gravity-engine.com/docs/attribution/synchronous-attribution
> 说明如何在用户注册时开启同步归因，以便立即取得当前用户的买量归因结果。



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

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

> **开启之后极端情况会有长达 `10s` 的接口阻塞，请谨慎开启！** 如您不需要立即获知归因结果，则可以参考 [归因回调链接](/docs/attribution/attribution-callback) 功能，可能更符合您的数据分析需求！

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

| 字段                         | 类型     | 说明                                                         |
| -------------------------- | ------ | ---------------------------------------------------------- |
| `token`                    | string | 用户 token，可忽略                                               |
| `click_company`            | string | 归因平台，允许的枚举值请参考 [广告平台枚举值](/docs/appendix/ad-platform-enums) |
| `turbo_promoted_object_id` | string | 引力推广活动 ID                                                  |
| `ad_params`                | object | 在归因回调链接里拼接的参数，可参考下方「参数拼接」部分                                |

示例：

```json
{
  "token": "123456789",
  "click_company": "bytedance",
  "turbo_promoted_object_id": "af12sdafga6",
  "ad_params": {}
}
```

## 参数拼接 [#参数拼接]

您可以在推广活动页面配置拼接参数，具体支持参数，请参考：[归因回调链接](/docs/attribution/attribution-callback)，我们将把您配置的归因回调参数拼接到 `ad_params` 参数中。

举例：

```text
?advertiser_id=__ADVERTISER_ID__&your_ad_id=__AD_ID__&a=b
```

则这个推广活动带来的用户，返回的 `ad_params` 为：

```json
{
  "advertiser_id": "123456",
  "your_ad_id": "123456",
  "a": "b"
}
```

## 兜底回调链接 [#兜底回调链接]

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

您可以在[引力后台-设置-应用管理-配置](https://web.gravity-engine.com/#/manage/appmanage)中添加兜底回调链接。
