# 百度bd_vid注入

> 来源：https://help.gravity-engine.com/docs/client-sdk/android/advanced/baidu-bd-vid
> 说明 Android 应用如何获取并向 Gravity Engine SDK 注入百度 bd_vid，以支持百度广告转化归因。



为了提升应用类广告投放的转化归因成功率，百度在保障用户隐私的前提下，基于安卓 APK 签名能力提出了一种创新型的安卓应用归因方案。百度将“广告ID”（即 bd\_vid）作为应用类转化归因中的新一代归因参数，将其动态注入到广告主渠道包 V2 签名区域，用户下载安装广告主 APP 后，通过提取 V2 签名内的“广告ID”即可实现应用广告投放的精准转化归因。目前引力引擎已完成百度创新性安卓应用归因方案的服务端接入。

## 接入步骤 [#接入步骤]

### 1. SDK 版本要求 [#1-sdk-版本要求]

* **Android SDK**：请确保引力引擎 SDK 版本升级至 5.0.8 或以上
* **Unity SDK**：当前版本暂不支持此功能

### 2. 获取 bd\_vid 参数 [#2-获取-bd_vid-参数]

按照[百度的文档](https://ocpx-devcenter.bj.bcebos.com/Android_dev_docs/%E7%99%BE%E5%BA%A6Android%20BD_VID%E6%B3%A8%E5%85%A5%E5%BD%92%E5%9B%A0%E5%A2%9E%E5%BC%BA%E6%96%B9%E6%A1%88_%E5%BA%94%E7%94%A8API_20250303.pdf?authorization=bce-auth-v1/e2ea496b5e7f4e20bd0e5d1ce5533588/2025-03-03T10:09:22Z/-1/host/dc2142d84a866757e4b51b8102b4239f93e2f261745df16a0400d855e7cb4ff7)获取 bd\_vid 字符串（即百度文档中的 2.2 部分）

### 3. 参数注入方式 [#3-参数注入方式]

获取到 bd\_vid 后，请按照以下顺序进行注入：

* **先注入 bd\_vid 参数：**

```java
//传入 bd_vid
BaiduVidHelper.setsBdVid("您的bd_vid字符串");
```

* **再初始化引力引擎：**

```java
//调用引力的 initialize 方法
gravityEngineSDKInstance.initialize(ACCESS_TOKEN, USER_CLIENT_ID, USER_CLIENT_NAME, CHANNEL, new InitializeCallback() {
    @Override
    public void onFailed(String errorMsg, JSONObject initializeBody) {
        Log.d(TAG, "initialize failed " + errorMsg);
    }

    @Override
    public void onSuccess(JSONObject responseJson, JSONObject initializeBody) {
        Log.d(TAG, "initialize success");
    }
}, ENABLE_SYNC_ATTRIBUTION);
```

### 4. 注意事项 [#4-注意事项]

* 百度文档中"2.3 部分"的内容无需接入，引力引擎后端已实现相关功能
* 参数注入顺序非常重要：必须先设置 bd\_vid，再进行初始化