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 號，該功能會影響啟動功能的使用。同時對於海外客戶，海外手機基本使用的是 Google 服務，基於此種情況需採用 GAID 的方式來進行管道追蹤，所以神策 Android SDK 中新增 GAID 的支援。

第一步：客戶呼叫 trackInstallation 並傳入 $gaid 屬性

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

JAVA

第二步：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
	}
}

XML

注意

properties 裡已沒有 $gaid 屬性
屬性 $ios_install_source 內容為
："android_id=4f295025f34c171a##imei=##mac=B0:55:08:28:14:7C##gaid=e4fe9bde-caa0-47b6-908d-ffba3fa184f2"

1.2. Appsflyer SDK 接入

Appsflyer SDK接入文件：https://support.appsflyer.com/hc/en-us/categories/201114756-SDK-integration-

2. 神策後台設定

2.1. 打開“管道匹配結果啟動”事件開關

當您需要使用神策的“導入第三方歸因數據工具”時，需要開啟「管道匹配結果」開關：

2.2. 取得 Appid

請您向 Appsflyer 申請取得到 appid。appid 是登入 AF 後台的這個 app，連結裡的最後一部分就是，ios 的 app id 都以 id 開頭。安卓的 appid 如下所示：

appid 範例：

ios的id：id1493xxxx08
安卓的id：com.Lingxiang.HundouLuo

取得到的 appid 配置到神策後台：

3. Appsflyer 後台設定

3.1. 取得神策 URL

開啟「管道匹配結果」開關後，介面上會出現專屬三個管道的數據接收網址 URL，點擊圖標複製 Appsflyer 列的 URL 到 Appsflyer 的後台：

3.2. 開啟 push API

請您登入 AppsFlyer 後台，左側導航欄點擊「API數據介面」；
往下滑找到 Push API，選擇勾選回呼參數；

注意：

1、push API 選擇回呼參數時，推薦全選所有參數；

2、push API 設定的時候一定要選擇增加 AppsFlyer_ID 這個參數；

3.3. 填寫管道資訊

請您在 HTTP 方式中選擇「GET」，回傳網址請填寫神策提供的 URL 網址，填好後點擊「傳送測試」；
在應用程式內事件中選擇要回傳的應用內事件，注意不論自然流量還是非自然流量，都需勾選回傳給神策，否則數據不精準；
請確認全部設定完成，點擊螢幕右下角的「保存」；

4. 聯調測試

請您準備一台專用海外版的測試手機裝置，參考下列連結將測試裝置加入白名單：
- https://support.appsflyer.com/hc/en-us/articles/207031996-Registering-test-devices-
成功加入白名單後，下載安裝並啟動您的app；
請您登入神策分析（SA），選擇分析→事件分析，查看訪問管道追蹤連結、App啟動、管道匹配結果啟動這三個事件數據；
確保客戶已下載安裝並啟動了整合神策 SDK 和 appsflyer SDK 的 APP ，請查看：
- 訪問管道追蹤連結事件（$AppChannelMatching）：存放 AF 傳過來的啟動事件；
- APP 啟動事件（AppInstall）：存放神策 SDK 上報的啟動事件；
- 管道匹配結果啟動事件（$ChannelMatchedInstall）：存放神策和 Appsflyer 匹配結果的啟動事件，帶有管道資訊並可用於管道追蹤分析。
若某事件沒有找到聯調裝置號碼（一般為 gaid），請聯繫神策技術支援人員逐一排查問題。若以上三個事件都有數據且聯調裝置號碼能對應上，則表示聯調成功。

現在，您便可在 SA 上進行多維度管道追蹤數據分析了。