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

プリセットプロパティ

最終更新 2026/10/03

1. すべてのイベントに付与されるプリセットプロパティ​

以下のプリセットプロパティは、OpenHarmony SDKのすべてのイベント（自動収集イベントを含む）に付与されるプリセットプロパティです

プロパティ名画面表示名プロパティタイプ収集タイミング説明

#ip

IPアドレス

テキスト

サーバー側で収集

ユーザーのIPアドレス。AEはこれを基にユーザーの位置情報を取得します
#country国テキストサーバー側で収集ユーザーの所在国。IPアドレスに基づいて生成されます

#country_code

国コードテキスト

サーバー側で収集

ユーザーの所在国の国コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province省テキストサーバー側で収集ユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city都市テキストサーバー側で収集ユーザーの所在都市。IPアドレスに基づいて生成されます
#os_versionOS バージョンテキスト初期化時に1回収集iOS 11.2.2、Android 8.0.0など

#manufacturer

デバイスのメーカーテキスト初期化時に1回収集ユーザーのデバイスのメーカー。Apple、vivoなど
#osOSテキスト初期化時に1回収集Android、iOS、HarmonyOSなど
#device_idデバイスIDテキスト初期化時に1回収集ユーザーのデバイスID。iOSではユーザーのIDFVまたはUUID、AndroidではandroidIDを取得
#screen_height画面の高さ数値初期化時に1回収集ユーザーのデバイスの画面の高さ。1920など
#screen_width画面の幅数値初期化時に1回収集ユーザーのデバイスの画面の幅。1080など
#device_modelデバイスモデルテキスト初期化時に1回収集ユーザーのデバイスのモデル。iPhone 8など
#device_typeデバイスタイプテキスト初期化時に1回収集デバイスタイプ。"Tablet"、"Phone"など
#app_versionAPPバージョンテキスト初期化時に1回収集APPのバージョン
#bundle_idアプリの一意の識別子テキスト初期化時に1回収集アプリのパッケージ名またはプロセス名

#lib

SDKタイプテキスト

初期化時に1回収集

接続したSDKのタイプ。Android、iOSなど
#lib_versionSDKバージョンテキスト初期化時に1回収集接続したSDKのバージョン
#network_typeネットワーク状態テキスト初期化時に1回収集、ネットワーク状態の変化時に収集イベント送信時のネットワーク状態。WIFI、3G、4Gなど

#carrier

通信キャリアテキスト

初期化時に1回収集

ユーザーのデバイスの通信キャリア。中国移动、中国电信など

#zone_offset

タイムゾーンオフセット

数値

イベント発生時に収集

データ時刻のUTCからのオフセット時間数
#install_timeアプリのインストール時間時間初期化時に1回収集ユーザーがアプリをインストールした時間。値はシステムから取得されます

#system_language

システム言語テキスト初期化時に1回収集ユーザーのデバイスのシステム言語(ISO 639-1、つまり小文字の英字2文字)。zh、enなど

2. プリセットプロパティの取得​

getPresetProperties()メソッドを呼び出して、プリセットプロパティを取得できます。

サーバー側のトラッキングでApp側のプリセットプロパティが必要な場合は、このメソッドでApp側のプリセットプロパティを取得してから、サーバー側に渡すことができます。

TDAnalytics.getPresetProperties()

/**
{
    "#os": "HarmonyOS",
    "#os_version": 10,
    "#bundle_id": "com.example.tdharmonyosdemo",
    "#install_time": "2023-10-19 18:46:00.105",
    "#manufacturer": "HUAWEI",
    "#device_model": "NOH-AN00",
    "#device_type": "phone",
    "#screen_width": 1344,
    "#screen_height": 2772,
    "#system_language": "zh-Hans",
    "#carrier": "中国电信",
    "#app_version": "1.0.1",
    "#device_id": "9811b90b-ee24-45c1-950a-77ee0ffc7a1c",
    "#zone_offset": 8
}
*/

3. プリセットプロパティの無効化​

シナリオによっては、コンプライアンスや実際の業務要件などを考慮して、一部のプリセットプロパティの収集を禁止したい場合があります。SDKの初期化時にdisablePresetPropertiesパラメータを設定して、収集を無効にするプロパティの配列を指定できます。サンプルコードは次のとおりです：

let config = new TDConfig()
config.appId = 'appId'
config.serverUrl = 'url'
config.disablePresetProperties =["#lib", "#lib_version", "#os", "#os_version", "#bundle_id", "#install_time", "#manufacturer", "#device_model",
"#device_type", "#screen_width", "#screen_height","#system_language","#carrier","#app_version","#device_id","#network_type","#ip"]
TDAnalytics.initWithConfig(context, config)
このページは役に立ちましたか？
このページの内容