Quick Tracking：引入&配置SDK

SDK基本資料

使用HarmonyNext SDK必備操作，缺少任意步驟都可能造成整合失敗或者資料丟失

1. 快速整合

在QuickTracking後台，為每一個應用產生了專屬的整合代碼，可以根據產品內的引導進行整合。

1.1. 進入產品後台

QuickTracking【首頁】-【管理主控台】

1.2. 找到應用歸屬組織

在【管理主控台】進入【組織列表】功能，組織列表展示當前建立的組織，找到應用歸屬組織

1.3. 找到待整合應用

2. 整合代碼明細

如果因為特定原因，無法訪問上述頁面，可以通過查看本章節進行SDK整合

2.1. 參數準備

appKey：在應用列表中擷取

收數網域名稱：在【管理主控台】-【採集資訊】模組中擷取

2.2. 引入SDK

系統 API 要求，HarmonyNext API 12及以上，目前僅支援普通應用的Stage模型，暫不支援元服務

2.2.1. 離線安裝SDK

引入離線版本鴻蒙SDK

{
  "modelVersion": "5.0.0",
  "description": "Please describe the basic information.",
  "dependencies": {
    "@quicktracking/common": "file:./lib/common.har",
    "@quicktracking/analytics": "file:./lib/qt_tongji.har",
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.18",
    "@ohos/hamock": "1.0.0"
  }
}

SDK檔案位置

2.2.2. 引入配置（非必選）

在專案工程的AppScope/resources/rawfile目錄下新增一個設定檔qtconfig.json

{
  "appKey": "您應用自己的appKey", //可選
  "channel": "您應用的發布渠道", //可選
}

注意如果初始化的時候構建UMConfig時傳入上述資訊，以初始化時的值為準

2.2.3. 許可權配置

在需要使用SDK的模組的module.json5檔案中添加許可權聲明

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    "name": "ohos.permission.APP_TRACKING_CONSENT"  //可選，如您需要採集華為廣告標識符
  }
],

！！注意：根據華為官網文檔說明對於OAID的採集需要使用者主動在裝置設定介面開啟，具體步驟請參考華為官方文檔

2.2.4. 使用標準化的OHMUrl格式

請設定useNormalizedOHMUrl為true，查看工程級build-profile.json5：

{
  "app": {
    "signingConfigs": [],
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "5.0.0(12)",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "useNormalizedOHMUrl": true
          }
        }
      }
    ],
  
  }
}