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. Branch SDK 接入文件

Branch SDK接入文件https://help.branch.io/developers-hub/docs

2. 神策後台設定

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

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

3. Branch後台設定

3.1. 取得神策 URL

開啟「管道匹配結果」開關後,界面上會出現三個管道的數據接收網址 URL,點擊圖標複製 URL 到 branch 的後台。

3.2. 開啟管道

Dashboard -> Data Feeds -> Data integration 搜尋

3.3. 填寫管道資訊

  1. Protocol:選擇http 或 https
  2. Request URL: 填寫神策後台URL,注意不要帶上http協定。
  3. Project:填寫神策相應project
  4. Token(選填):填寫相應Token值
  5. 點擊Enable/Save 打開或更新資訊

4. 聯調測試

  1. 請您進行數據聯調測試:手機點擊廣告連結,下載app並打開;
  2. 請您登入神策分析(SA),選擇分析→事件分析,查看訪問管道追蹤連結、App啟動、管道匹配結果啟動 這三個事件的多維度數據;

  3. 確保客戶已下載安裝並啟動了整合 神策 SDK 和 branch SDK 的 APP ,請查看:

    • 訪問管道追蹤連結 事件($AppChannelMatching):存放 adjust 傳過來的啟動事件;

    • APP啟動 事件(AppInstall):存放神策 SDK 上報的啟動事件;

    • 管道匹配結果啟動 事件($ChannelMatchedInstall):存放神策和 branch 匹配結果的啟動事件。帶有管道資訊並可用於管道追蹤分析。

  4. 若某事件沒有找到聯調裝置號(一般為 gaid),請聯繫神策技術支持人員逐一排查問題。若以上三個事件都有數據且聯調裝置號能對應上,則表示聯調成功。

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