Quick Tracking:SDK のインポートと構成

基本的な SDK 情報

HarmonyNext SDK の必要な操作を使用すると、統合が失敗したり、データが失われたりする可能性があります。

1. クイック統合

Quick Tracking のバックグラウンドでは、アプリケーションごとに専用の統合コードが生成されます。 プロダクト内のガイダンスに基づいてアプリケーションを統合できます。

1.1. プロダクト バックグラウンドに移動する

QuickTracking [ホームページ]-[管理コンソール]

1.2. アプリケーションが属する組織を見つける。

管理コンソールにログインし、組織リスト ページに移動します。組織リスト ページで、アプリケーションが属する組織を見つけます。

1.3. 統合するアプリケーションを見つける。

2. 統合コードの詳細

特定の理由で上記のページにアクセスできない場合は、このセクションを参照して SDK を統合できます。

2.1. パラメータの準備

appKey：アプリケーション リストから取得

収集 ドメイン名：[管理コンソール]-[追跡情報] モジュールで取得

2.2. SDK の導入

システム API 要件：HarmonyNext API 12 以降。現在、一般的なアプリケーションのステージ モデルのみがサポートされています。メタ サービスはサポートされていません。

2.2.1. SDK をオフラインでインストールする

オフライン版の Hongmeng 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": "Your application's own appKey", // アプリケーション独自の appKey（オプション）
  "channel": "The release channel of your application", // アプリケーションのリリース チャンネル（オプション）
}

初期化中に UMConfig が構築されるときに上記の情報が渡された場合、初期化時の値が優先されることに注意してください。

2.2.3. 権限の構成

SDK を使用する必要があるモジュールの module.json5 ファイルに権限宣言を追加します

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    "name": "ohos.permission.APP_TRACKING_CONSENT" // Huawei広告IDを収集する必要がある場合（オプション）
  }
],

! ! 注：Huawei 公式 Web サイトのドキュメントによると、デバイス設定ページで OAID 追跡を有効にする必要があります。詳細については、Huawei のドキュメント をご参照ください。

2.2.4. 標準化された OHMUrl 形式を使用する

エンジニアリングレベルの build-profile.json5 を表示するには、useNormalizedOHMUrl を true に設定します。

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