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

プリセットプロパティ

最終更新 2026/10/03

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

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

非Nativeプラットフォーム(PC、Switchなどの端末)のプリセットプロパティ:

プロパティ名画面表示名プロパティタイプ説明

#ip

IPアドレス

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

テキスト

ユーザーの所在国の国コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province省テキストユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city都市テキストユーザーの所在都市。IPアドレスに基づいて生成されます
#os_versionOS バージョンテキストwindows10など
#manufacturerデバイスのメーカーテキストグラフィックカードのメーカー名
#osOSテキストMacOS、Windowsなど
#device_idデバイスIDテキストユーザーのデバイスID
#screen_height画面の高さ数値ユーザーのデバイスの画面の高さ。1920など
#screen_width画面の幅数値ユーザーのデバイスの画面の幅。1080など
#device_modelデバイスモデルテキストユーザーのデバイスのモデル。iPhone 8など
#app_versionAPPバージョンテキストAPPのバージョン
#bundle_idアプリの一意の識別子テキストアプリパッケージ名

#lib

SDKタイプテキスト接続したSDKのタイプ。Android、iOSなど
#lib_versionSDKバージョンテキスト接続したSDKのバージョン

#network_type

ネットワーク状態テキストイベント送信時のネットワーク状態。Mobile、LANなど
#carrier通信キャリアテキストユーザーのデバイスの通信キャリア。中国移动、中国电信など

#zone_offset

タイムゾーンオフセット

数値データ時刻のUTCからのオフセット時間数

#system_language

システム言語テキストユーザーのデバイスのシステム言語(ISO 639-1、つまり小文字の英字2文字)。zh、enなど
#start_reason起動理由テキストアプリを開いた、またはフォアグラウンドに切り替わったときの起動理由

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

v2.2.0以降のバージョンでは、TDAnalytics.GetPresetProperties()メソッドを呼び出してプリセットプロパティを取得できます。サーバー側のトラッキングでApp側のプリセットプロパティが必要な場合は、このメソッドでApp側のプリセットプロパティを取得してから、サーバー側に渡すことができます。

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

//イベントのプリセットプロパティを生成
Dictionary<string, object> eventPresetProperties = presetProperties.ToDictionary();
/*
   {
        "#carrier": "中国电信",
        "#os": "iOS",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#screen_height": 2264,
        "#bundle_id": "com.sw.thinkingdatademo",
         "#app_version": "0.1",
        "#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 appVersion = presetProperties.AppVersion;//Appのバージョン番号
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、国、都市の情報はサーバー側で解析して生成されるため、クライアントにはこれらのプロパティを取得するインターフェースはありません

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

v2.3.1以降のバージョンでは、指定したプリセットプロパティの送信をブロックできます。Resourcesディレクトリにta_public_config.xmlを追加してスイッチを設定すると、設定したフィールドに対応するプリセットプロパティは送信されなくなります。次のとおりです：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- ThinkingAnalytics DisablePresetProperties start -->
    <string-array name="TDDisPresetProperties">
       <item>#disk</item>
       <item>#fps</item>
       <item>#ram</item>
       <!-- <item>#app_version</item> -->
       <!-- <item>#os_version</item> -->
       <!-- <item>#manufacturer</item> -->
       <!-- <item>#device_model</item> -->
       <!-- <item>#screen_height</item> -->
       <!-- <item>#screen_width</item> -->
       <!-- <item>#carrier</item> -->
       <!-- <item>#device_id</item> -->
       <!-- <item>#system_language</item> -->
       <!-- <item>#lib</item> -->
       <!-- <item>#lib_version</item> -->
       <!-- <item>#os</item> -->
       <!-- <item>#bundle_id</item> -->
       <!-- <item>#install_time</item> -->
       <!-- <item>#start_reason</item> -->
       <!-- <item>#simulator</item> -->
       <!-- <item>#network_type</item> -->
       <!-- <item>#start_reason</item> -->
       <!-- <item>#resume_from_background</item> -->
       <!-- <item>#title</item> -->
       <!-- <item>#screen_name</item> -->
       <!-- <item>#url</item> -->
       <!-- <item>#referrer</item> -->
       <!-- <item>#element_type</item> -->
       <!-- <item>#element_id</item> -->
       <!-- <item>#element_position</item> -->
       <!-- <item>#element_content</item> -->
       <!-- <item>#element_selector</item> -->
       <!-- <item>#app_crashed_reason</item> -->
    </string-array>
    <!-- ThinkingAnalytics DisablePresetProperties end -->
</resources>

デバイスIDをブロックした状態で初回イベントを使用する場合は、必ずfirst_check_idプロパティを指定してください

このページは役に立ちましたか？
このページの内容