1. 集成 SDK
- 1.1. 神策 SDK 接入
  - 1.1.1. 激活支持 GAID 匹配
- 1.2. Adjust SDK 接入
2. 神策配置
- 2.1. 打开“渠道匹配结果激活”事件开关
- 2.2. 获取神策 URL
- 2.3. 自定义参数配置
3. Adjust 后台回传设置
4. 联调测试

1. 集成 SDK

1.1. 神策 SDK 接入

神策 SDK 接入文档： https://manual.sensorsdata.cn/sa/latest/tech_sdk_client-1573786.html 。

1.1.1. 激活支持 GAID 匹配

随着 Android 系统版本不断升级，在 Android Q 版本中已经禁止普通 App 获取 IMEI 号，该功能会影响激活功能的使用。同时对于海外客户，海外手机基本使用的是谷歌服务，基于此种情况需采用 GAID 的方式来进行渠道追踪，所以神策 Android SDK 中新增 GAID 的支持。

第一步：客户调用 trackAppInstall 并传入 $gaid 属性（注：需要先确认元事件中存在 $AppInstall 事件，否则会影响事件采集）

try {
    JSONObject properties = new JSONObject();
    properties.put("$gaid", "e4fe9bde-caa0-47b6-908d-ffba3fa184f2");
    SensorsDataAPI.sharedInstance().trackAppInstall(properties);
} catch (Exception e) {
    e.printStackTrace();
}

第二步：Android SDK 内部处理结果

{
    "_track_id": 1288325158,
    "time": 1563592064368,
    "type": "track",
    "distinct_id": "4f295025f34c171a",
    "lib": {
        "$lib": "Android",
        "$lib_version": "3.2.1",
        "$app_version": "1.0",
        "$lib_method": "code",
        "$lib_detail": "com.sensorsdata.analytics.android.sdk.SensorsDataAPI##trackEvent##SensorsDataAPI.java##3067"
    },
    "event": "$AppInstall",
    "properties": {
        "$lib": "Android",
        "$os_version": "8.0.0",
        "$device_id": "4f295025f34c171a",
        "$lib_version": "3.2.1",
        "$model": "FRD-AL10",
        "$os": "Android",
        "$screen_width": 1080,
        "$screen_height": 1920,
        "$manufacturer": "HUAWEI",
        "$app_version": "1.0",
        "$wifi": true,
        "$network_type": "WIFI",
        "$ios_install_source": "android_id=4f295025f34c171a##imei=##mac=B0:55:08:28:14:7C##gaid=e4fe9bde-caa0-47b6-908d-ffba3fa184f2",
        "$is_first_day": true
    }
}

注意

properties 里已没有 $gaid 属性
属性 $ios_install_source 内容为："android_id=4f295025f34c171a##imei=##mac=B0:55:08:28:14:7C##gaid=e4fe9bde-caa0-47b6-908d-ffba3fa184f2"

1.2. Adjust SDK 接入

Adjust SDK 接入文档： https://github.com/adjust/sdks

2. 神策配置

2.1. 打开“渠道匹配结果激活”事件开关

当您需要使用神策的“导入第三方归因数据工具”时，需要开启「渠道匹配结果」开关：

2.2. 获取神策 URL

开启「渠道匹配结果」开关后，界面上会出现三个渠道的数据接收地址 URL，点击小图标复制 URL 到 Adjust 后台的 install callback 中。

2.3. 自定义参数配置

神策海外归因新增自定义参数功能，支持用户以自定义参数方式接收更多 Adjust 变量数据。

添加自定义参数时，左侧输入框填写用户自定义参数名，右侧输入框填写 Adjust 支持的宏参，注意 Adjust 的宏变量需带大括号。

注意：以上配置完成后，请务必联系神策对接人员帮忙重启海外归因服务，方可进行后续操作。

3. Adjust 后台回传设置

广告主必须有自己的服务器用来接收 Adjust 的实时回传数据。回传链接的设置很简单，即服务器终端地址和 Adjust 占位符的拼接。

Adjust 可用的占位符列表： https://partners.adjust.com/placeholders/
回传链接的拼接实例： https://help.adjust.com/manage-data/raw-data-exports/callbacks/best-practices-callbacks
进入到 Adjust 后台，点击 App →Raw Data Export → Real-time callbacks，选择需要回传的事件，填入回传链接。
注意不论自然流量还是非自然流量，都需选择回传给神策，否则数据不准确。