メインコンテンツまでスキップ

OpenHarmony

最終更新 2026/10/05
ヒント

接続する前に、まず接続前の準備をお読みください。

SDKの最小システムバージョンはAPI 10です

SDK（har形式）のサイズは約56 KBです

SDK名：ThinkingData SDK

開発者：数数信息科技(上海)有限公司

バージョン番号：2.0.0

機能：SDKはイベントとユーザープロパティの形式でクライアントのログを収集し、DAU、利用時間、継続などの行動分析を行う機能を備えています。

プライバシーに関する声明：ThinkingData SDKプライバシーに関する声明

コンプライアンスガイド：ThinkingData SDKコンプライアンスガイド

最新バージョン: 2.0.0

リソースのダウンロード: SDKのダウンロード

SDKパッケージ名：@thinkingdata/analytics

MD5値：997d05310dbe82eb02b1536deeb4645f

更新日: 2026-08-19

1. SDKの統合​

  1. SDKの導入
  • 以下のコマンドを実行します
ohpm i @thinkingdata/analytics
  • oh-package.json5のdependenciesに依存関係を手動で追加します。IDEにohpm installが表示されたら、クリックしてインストールします
"dependencies": {
  "@thinkingdata/analytics": "2.0.0",
}

2. 初期化​

import { TDAnalytics, TDConfig, TDMode } from '@thinkingdata/analytics';

//方法1
TDAnalytics.init(context, "appId", "serverUrl")

//方法2
let config = new TDConfig()
config.appId = 'appId'
config.serverUrl = 'serverUrl'
config.mode = TDMode.NORMAL
config.enableAutoCalibrated = true
TDAnalytics.initWithConfig(context, config)

SDKは初期化時に、OS バージョン、デバイスのメーカー、OS、画面解像度、デバイスモデル、APPバージョン、ネットワーク状態、通信キャリア、アプリのインストール時間、システム言語などの情報を収集し、統計分析機能に使用します。

パラメータの説明:

  • APPID: プロジェクトのAPPIDです。AEの「プロジェクト管理」ページで取得できます

  • SERVER_URL: データの送信先URL

    • クラウドサービスをご利用の場合は、「プロジェクト管理」->「プロジェクト構成」でデータ受信URLを確認してください。
    • プライベートデプロイ版をご利用の場合は、データ収集先のURLをカスタマイズできます。

  • mode: SDKの送信モードです。デフォルトはNormalモードです。

  • enableAutoCalibrated : 時刻の自動校正を有効にします。

3. よく使う機能​

よく使う機能を使用する前に、まずユーザー識別ルールを確認することをお勧めします。SDKはデフォルトで乱数を生成してゲストIDとし、ゲストIDをローカルに永続的に保存します。ユーザーがログインするまでは、ゲストIDが識別IDとして使われます。注意:ゲストIDは、ユーザーがAppを再インストールしたり、デバイスを変更したりすると変わります。

3.1 アカウントIDの設定​

ユーザーがログインする際にloginを呼び出して、ユーザーのアカウントIDを設定できます。AEプラットフォームはアカウントIDを識別IDとして使用し、設定したアカウントIDはlogoutを呼び出すまで保持されます。loginを複数回呼び出すと、以前のアカウントIDが上書きされます。

// ユーザーのログイン時の一意の識別子。このデータは送信データの#account_idに対応し、この場合#account_idの値はTAになります
TDAnalytics.login("TA");

このメソッドはログインイベントを送信しません

3.2 共通イベントプロパティの設定​

共通イベントプロパティとは、すべてのイベントに付与されるプロパティのことです。setSuperPropertiesを呼び出して共通イベントプロパティを設定できます。イベントを送信する前に、共通イベントプロパティを設定しておくことを推奨します。ユーザーの会員レベルや流入チャネルなどの重要なプロパティは、すべてのイベントに設定する必要があります。その場合は、これらのプロパティを共通イベントプロパティとして設定できます。

let superProperties = {};
superProperties["channel"] = "ta";//文字列
superProperties["age"] = 1;//数値
superProperties["isSuccess"] = true;//ブール値
superProperties["birthday"] = new Date();//時間
superProperties["object"] = {key:"value"};//オブジェクト
superProperties["object_arr"] = [{key:"value"}];//オブジェクトグループ
superProperties["arr"] = ["value"];//配列
TDAnalytics.setSuperProperties(superProperties)

共通イベントプロパティはキャッシュに保存されるため、Appを起動するたびに呼び出す必要はありません。setSuperPropertiesを呼び出して、以前に設定済みの共通イベントプロパティを送信した場合は、以前のプロパティが上書きされます。

3.3 自動収集の有効化​

enableAutoTrackはonWindowStageCreateの後に有効にすることをお勧めします。次のコード例では、すべての自動収集イベントを有効にしています：

//APPインストールイベント TDAutoTrackEventType.APP_INSTALL
//APP起動イベント TDAutoTrackEventType.APP_START
//APP終了イベント TDAutoTrackEventType.APP_END
//APPページ閲覧イベント TDAutoTrackEventType.APP_VIEW_SCREEN
//APPコントロールクリックイベント TDAutoTrackEventType.APP_CLICK
//APPクラッシュイベント TDAutoTrackEventType.APP_CRASH
TDAnalytics.enableAutoTrack(context,TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CLICK | TDAutoTrackEventType.APP_CRASH)

3.4 イベントの送信​

trackを呼び出してイベントを送信できます。事前に整理したトラッキングドキュメントに従ってイベントのプロパティを設定することをお勧めします。ここでは、ユーザーが商品を購入する場合を例にします：

TDAnalytics.track({
  eventName: 'product_buy',
  properties: {
      product_name:"商品名"
  }
})

イベント名は文字列型で、英字で始まる必要があります。数字、英字、アンダースコア "_"を含めることができます。

3.5 ユーザープロパティの設定​

一般的なユーザープロパティは、userSetを呼び出して設定できます。このインターフェースで送信したプロパティは、既存のプロパティ値を上書きします。そのユーザープロパティが以前に存在しない場合は新しく作成され、タイプは渡されたプロパティのタイプと同じになります。ここでは、ユーザー名の設定を例にします：

// usernameはTA
TDAnalytics.userSet({
  properties: {
    username: "TA"
  }
})
//usernameはAE
TDAnalytics.userSet({
  properties: {
    username: "AE"
  }
})

4. ベストプラクティス​

次のサンプルコードには、上記のすべての操作が含まれています。次の手順で使用することをお勧めします:

import { TDAnalytics, TDConfig, TDMode, TDAutoTrackEventType } from '@thinkingdata/analytics';
let config = new TDConfig()
config.appId = 'appId'
config.serverUrl = 'serverUrl'
config.enableAutoCalibrated = true
config.mode = TDMode.NORMAL
// 初期化
TDAnalytics.initWithConfig(context, config)
//自動収集を有効化
TDAnalytics.enableAutoTrack(context,TDAutoTrackEventType.APP_START | TDAutoTrackEventType.APP_INSTALL | TDAutoTrackEventType.APP_END | TDAutoTrackEventType.APP_VIEW_SCREEN | TDAutoTrackEventType.APP_CLICK | TDAutoTrackEventType.APP_CRASH)
// ユーザーのログイン固有識別子。このデータは送信データの#account_idに対応し、この時点で#account_idの値はTA
TDAnalytics.login("TA");
//共通イベントプロパティを設定
let superProperties = {
    channel : "ta", //文字列
    age : 1,//数値
    isSuccess : true,//ブール値
    birthday :  new Date(),//時間
    object : { key : "value" },//オブジェクト
    object_arr : [ { key : "value" } ],//オブジェクトグループ
    arr : [ "value" ]//配列
};
TDAnalytics.setSuperProperties(superProperties);
//イベントを送信
TDAnalytics.track({
    eventName: "product_buy", // イベント名
    properties: {
        product_name: "商品名"
    } //イベントプロパティ
});
//ユーザープロパティを設定
TDAnalytics.userSet({
    properties: { 
        username: "AE" 
    }
});
このページは役に立ちましたか？
このページの内容