プリセットプロパティ

最終更新 2026/10/07

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

以下のプリセットプロパティは、SDKのすべてのイベントに付与されるプリセットプロパティです

プロパティ名	日本語名	プロパティタイプ	説明
#ip	IPアドレス	テキスト	ユーザーのIPアドレス。AEはこれを基にユーザーの位置情報を取得します
#country	国	テキスト	ユーザーの所在国。IPアドレスに基づいて生成されます
#country_code	国コード	テキスト	ユーザーの所在国の国コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province	省	テキスト	ユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city	都市	テキスト	ユーザーの所在都市。IPアドレスに基づいて生成されます
#os_version	OS バージョン	テキスト	iOS 11.2.2、Android 8.0.0など
#manufacturer	デバイスのメーカー	テキスト	ユーザーのデバイスのメーカー。Apple、vivoなど
#os	OS	テキスト	Android、iOSなど
#device_id	デバイスID	テキスト	ユーザーのデバイスID。iOSではユーザーのIDFVまたはUUID、AndroidではandroidIDを取得
#app_version	APPバージョン	テキスト	APPのバージョン
#bundle_id	アプリの一意の識別子	テキスト	アプリのパッケージ名またはプロセス名
#lib	SDKタイプ	テキスト	接続したSDKのタイプ。Android、iOSなど
#lib_version	SDKバージョン	テキスト	接続したSDKのバージョン
#zone_offset	タイムゾーンオフセット	数値	データ時刻のUTCからのオフセット時間数
#install_time	アプリのインストール時間	時間	ユーザーがアプリをインストールした時間。値はシステムから取得されます
#system_language	システム言語	テキスト	ユーザーのデバイスのシステム言語(ISO 639-1、つまり小文字の英字2文字)。zh、enなど

2. その他のプリセットプロパティ

上記のプリセットプロパティのほかに、対応するインターフェースを呼び出した場合にのみ記録されるプリセットプロパティもあります：

プロパティ名	日本語名	プロパティタイプ	説明
#duration	イベントの所要時間	数値	計測機能のインターフェースtimeEvent:を呼び出す必要があります。イベントの継続時間を記録します。単位は秒です
#background_duration	バックグラウンド滞在時間	数値	計測機能のインターフェースtimeEventを呼び出す必要があります。イベントの発生期間中に、アプリがバックグラウンドに滞在した時間を記録します。単位は秒です

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

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

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

Objective-C

//プロパティオブジェクトを取得
TDPresetProperties *presetProperties = [TDAnalytics getPresetProperties];

//イベントのプリセットプロパティを生成
NSDictionary *properties = [presetProperties toEventPresetProperties];
/*
   {
        "#os": "OSX",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "Apple",
        "#system_language": "zh",
        "#os_version": "10",
        "#zone_offset": 8,
        "#app_version":"1.0.0"
    }
*/

//特定のプリセットプロパティを取得
NSString *bundle_id = presetProperties.bundle_id;//パッケージ名
NSString *os = presetProperties.os;//OSの種類。OSXなど
NSString *system_language = presetProperties.system_language;//システム言語の種類
NSString *os_version = presetProperties.os_version;//システムのバージョン番号
NSNumber *zone_offset = presetProperties.zone_offset;//タイムゾーンオフセット

Swift

let presetProperties = TDAnalytics.getPresetProperties();

//イベントのプリセットプロパティを生成
let properties = presetProperties.toEventPresetProperties();

//特定のプリセットプロパティを取得
let bundle_id = presetProperties.bundle_id;//パッケージ名
let os = presetProperties.os;//OSの種類。OSXなど
let system_language = presetProperties.system_language;//システム言語の種類
let os_version = presetProperties.os_version;//システムのバージョン番号
let zone_offset = presetProperties.zone_offset;//タイムゾーンオフセット値

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