プリセットプロパティ

最終更新 2026/08/27

1. プリセットプロパティの説明

iOSとAndroidのプラットフォームで収集されるプリセットプロパティには多少の違いがあります。詳しくは次のドキュメントを参照してください:

iOSプラットフォームのプリセットプロパティ、Androidプラットフォームのプリセットプロパティ

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

v2.0.1以降のバージョンでは、getPresetProperties()メソッドを呼び出してプリセットプロパティを取得できます。

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

//プロパティオブジェクトを取得
TDPresetProperties presetProperties = await TDAnalytics.getPresetProperties();

//イベントのプリセットプロパティを生成
Map<String, dynamic>? eventPresetProperties = presetProperties.toEventPresetProperties();
/*
   {
  "#carrier": "中国电信",
  "#os": "iOS",
  "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
  "#screen_height": 2264,
  "#bundle_id": "com.sw.thinkingdatademo",
  "#manufacturer": "Apple",
  "#device_model": "iPhone7",
  "#screen_width": 1080,
  "#system_language": "zh",
  "#os_version": "10",
  "#network_type": "WIFI",
  "#zone_offset": 8
    }
*/

//特定のプリセットプロパティを取得
String bundleId = presetProperties.bundleId;//パッケージ名
String os = presetProperties.os;//osタイプ。Android、iOSなど
String systemLanguage = presetProperties.systemLanguage;//携帯電話のシステム言語の種類
int screenWidth = presetProperties.screenWidth;//画面の幅
int screenHeight = presetProperties.screenHeight;//画面の高さ
String deviceModel = presetProperties.deviceModel;//デバイスモデル
String deviceId = presetProperties.deviceId;//デバイスの一意の識別子
String carrier = presetProperties.carrier;//携帯電話のSIMカードのキャリア情報。デュアルSIMの場合は、メインカードのキャリア情報を取得
String manufacture = presetProperties.manufacturer;//携帯電話のメーカー。HuaWei、Appleなど
String networkType = presetProperties.networkType;//ネットワークタイプ
String osVersion = presetProperties.osVersion;//システムのバージョン番号
double zoneOffset = presetProperties.zoneOffset;//タイムゾーンオフセット値

IP、国、都市の情報はサーバー側で解析して生成されるため、クライアントにはこれらのプロパティを取得するインターフェースはありません