Quick Application SDK - Quick Tracking - Alibaba Cloud ドキュメントセンター

Quick App SDK は一般的なトラッキングイベントとプロパティ（起動イベント、終了イベント、ページイベント、カスタムイベント、ユーザープロパティ、グローバルプロパティなど）をサポートしています。

1. SDK のインポートと構成

Quick Tracking サービスをクイックアプリケーションプロジェクトに統合するには、最新のクイックアプリケーション SDK を取得する必要があります。次のオンラインアドレスにアクセスして、最新バージョンの SDK ファイルをダウンロードするか、直接参照してください。

クイックアプリケーション SDK オンラインアドレス: https://g.alicdn.com/dt-f2e/qt-quickapp-sdk/1.0.0/qt_quickapp.js

クイックトラッキングプラットフォームにログインし、管理コンソール - 情報収集 - ミニプログラム sdk 情報に移動します
qt_quickapp.js ファイルをプロジェクトに対応するディレクトリに配置します（例：src/assets/js）
アプリのエントリファイル app.ux ファイルに、以下を追加します
```
// app.ux ファイルにヘッダーを追加します。
import qt from './assets/js/qt_quickapp.js';
```

SDK パラメーターを構成する

SDK を導入した後、setParams を呼び出して SDK を初期化します

// app.ux ファイルにヘッダーを追加します。
import qt from './assets/js/qt_quickapp.js';
qt.setParams({
  /************ 必須フィールド ************* /
  appKey: '現在のアプリケーションの AppKey', 
  trackDomain: '現在のアプリケーションのドメイン名',
  /************ オプションフィールド ************* /
  showLog: true, // SDK ログを表示するかどうかを指定します。 true または false。
  userId: 'test_user', // ユーザーアカウント。 login 操作を呼び出して構成することもできます
  globalproperty: { // イベントのグローバルプロパティ。
    a:1,
    b:2
  }
});

2. SDK の初期化

SDK のパラメーターを構成した後、init メソッドを呼び出して SDK を初期化します。

// app.ux ファイルの onCreate メソッド
export default {
  onCreate(options) {
    // SDK を初期化します。
    qt.init(); // qt をグローバルに登録します
  }
}

3. トラッキングの追加

3.1 アプリケーション起動トラッキング

API:qt.appLaunch ('アプリケーション起動のパラメーター')

// app.ux ファイルの onCreate メソッドで qt.appLaunch() メソッドを呼び出します。
export default {
  onCreate(options) {
    qt.init();
    qt.appLaunch(options);
  },
  ...
}

3.2 アプリケーション終了トラッキング

API:qt.appHide()

// app.ux ファイルの onHide メソッドで qt.appHide() メソッドを呼び出します。
export default {
	onHide() {
    qt.appHide();
  }
}

3.3 ページ閲覧イベントトラッキング

API:qt.sendPageStart ('イベントプロパティオブジェクト')

イベントプロパティオブジェクト: このフィールドは、イベントのカスタムパラメーターを表します。その値は JSON オブジェクトです（単純なタイル状のオブジェクトで、複数レイヤーにネストすることはできません）。パラメーター値は、JavaScript では文字列、数値、またはブール値です。パラメーター値が空の場合は、値 "" を渡します。

例:

// test page pages/TestPage/index.ux
export default {
  ...
  onShow() {
    qt.sendPageStart({
      page_name: 'test_page', // オプション。ページエンコーディング。
      page_title: 'ページタイトル', // (オプション) ページの名前。
      param1: 'xxx',
      param2: 'xxx'
    });
  }
	...
}

3.4 イベントトラッキング

API:qt.sendEvent ('イベントコード', 'イベントプロパティオブジェクト')

イベントコード: このフィールドは、Quicktracking 管理プラットフォームに登録されているクリック、露出などのカスタムイベントのイベントコードです。英語の文字列形式のみがサポートされ、最大長は 128 桁です。

例:

// test page pages/TestPage/index.ux
export default {
  ...
  onTestButtonClick() {
  	qt.sendEvent('test_clk', {
      page_name: 'test_page', // オプション。ページエンコーディング。
      page_title: 'ページタイトル', // (オプション) ページの名前。
      param1: 'xxx',
      param2: 'xxx'
    });
  }
	...
}

4. グローバル属性の構成

API:qt.setGlobalProperty ('グローバル属性オブジェクト')

// 方法 1
qt.setGlobalProperty({
  param1: '1111',
  param2: 2222,
  param3: true
});

// 方法 2
qt.setParams({
	....
  globalproperty: {
    param1: '1111',
    param2: 2222,
    param3: true
  }
});

上記の呼び出し後の globalproperty は次のとおりです:{ param1: '1111', param2: 2222, param3: true }

グローバル属性の追加

API:qt.appendGlobalProperty ('グローバル属性オブジェクト')

qt.appendGlobalProperty({
  param4: '4444',
  param5: 55555
});

上記の呼び出し後の globalproperty は次のとおりです:

{ param1: '1111', param2: 2222, param3: true, param4: '4444', param5: 55555 }

5. ユーザーアカウントの設定

API:qt.login ('ユーザーアカウント ID')

qt.login ('account id') // アカウントを報告し、アカウントをキャッシュします。

API:qt.logoff()

qt.logoff() // ユーザーアカウントキャッシュをクリアします

6. ユーザー属性の報告

API:qt.sendUserProfile ('ユーザー属性オブジェクト')

注: ユーザー属性を報告する前に、ユーザーアカウントを報告する必要があります

qt.sendUserProfile({
  name: 'Jack',
  age: '25',
  level: 'vip3'
});

7. 複数の種類の ID を収集する。

API:qt.setIds ('複数の ID で構成されるオブジェクト')

注: 各 ID のキーが正しく記述されていることを確認してください。

qt.setIds({
  openId: 'xxxx',
  unionid: 'xxxxx',
  androidId: 'xxxxx',
  advertisingId: 'xxxxx',
  phonenumber: 'xxxxx',
  mac: 'xxxxx',
  oaid: 'xxxxx',
  serial: 'xxxxx',
  deviceId: 'xxxxx'
});

上記の ID フィールドの意味の詳細については、Quick Application の公式ドキュメントをご参照ください。

https://doc.quickapp.cn/features/service/account.html?h=openid

https://doc.quickapp.cn/features/system/device.html?h=deviceId

8. SDK ログの表示

SDK の showLog パラメーターを true に設定します。

qt.setParams({
  ...
  showLog: true
})

9. トラッキング検証

トラッキング機能の実装後、開発者は QuickTracking プラットフォームのトラッキング検証機能を使用して既存のトラッキングを検証できます。まず、log_xxxx 形式の debugId を取得し、SDK 構成パラメーターに追加して、トラッキング検証モードでのログ報告を有効にします。

debugId を挿入してトラッキングを構成する

// app.ux ファイルにヘッダーを追加します。
import qt from './assets/js/qt_quickapp.js';
qt.setParams({
  ...
  debugId: 'log_xxxxxxxx', // トラッキング検証に使用されます
  ....
});