プリセットプロパティ

全てのイベントが付帯するプリセットプロパティ

以下のプリセットプロパティはAndroid SDK 中で全てのイベント（自動収集イベント含め）が付帯するプリセットプロパティとなります。

プロパティ名	名称	タイプ	説明
#ip	IP アドレス	文字列	ユーザの IP アドレス、 TA はユーザの地理的位置情報
#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などのユーザーデバイスのメーカー
#os	OS	文字列	Android、 iOS など
#device_id	デバイス ID	文字列	ユーザーのデバイスID、 iOS はユーザーのIDFVやUUID、AndroidはAndroidIDを取得
#screen_height	スクリーン高さ	数値	ユーザーデバイスのスクリーンの高さ、1920など
#screen_width	スクリーン長さ	数値	ユーザーデバイスのスクリーンの長さ、1080など
#device_model	デバイスモデル	文字列	iPhone 8などのユーザーデバイスのモデル
#device_type	デバイスタイプ	文字列	デバイスタイプ："Tablet"、"Phone"など
#app_version	APPバージョン	文字列	APPバージョン
#bundle_id	アプリパッケージ名（ユニーク）	文字列	APPパッケージ名もしくはプロセス名
#lib	SDK タイプ	文字列	SDK のタイプ：Android， iOS など
#lib_version	SDK バージョン	文字列	SDK のバージョン
#network_type	ネットワークタイプ	文字列	データ送信時のネットワーク状態：WIFI、4G、5Gなど
#carrier	キャリア	文字列	ユーザーデバイスのキャリア：Docomo、Softbankなど
#zone_offset	タイムゾーン	数値	データ時間 UTC 時間との偏位時間数
#install_time	インストール時間	時間	APPのインストール時間
#simulator	シミュレーター	数値	デバイスはシミュレーター true/false
#ram	デバイスのram状態	文字列	ユーザーデバイスの現在残りramと総ram、単位はGB、1.4/2.4
#disk	デバイスのストレージ状態	文字列	ユーザーデバイスの現在残りストレージと総ストレージ、単位はGB　30/200
# fps	デバイスのフレームレート	数値	ユーザーデバイスの現在画面のフレームレート：60
#system_language	システム言語	文字列	ユーザーデバイスのシステム言語（ISO 639-1）jp, enなど

自動収集イベントのプリセットプロパティ

以下のプリセットプロパティは、自動収集イベントの中で特有のプリセットプロパティとなります。

• APP 起動イベント（ta_app_start）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#resume_from_background	バックグラウンドから再開かどうか	文字列	APPの起動は直接起動なのか、バックグラウンドから再開なのか。trueはバックグラウンドから再開で、falseは直接起動となります。

• APP クローズイベント（ta_app_end）的预置属性

プロパティ名	名称	タイプ	説明
#duration	イベント時間経過	数値	APP起動からの時間経過（起動からクローズ）、単位は秒

• APP 閲覧ページイベント（ta_app_view）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#title	ページタイトル	文字列	viewが属している Activity のタイトルで、 Activity の title プロパティで値を付与されます
#screen_name	ページ名称	文字列	viewが属している Activity のパッケージ名、カテゴリ名
#url	ページURL	文字列	現在ページのURL、 getScreenUrl を呼び出してURLの設定を行う必要があります。
#referrer	リファラー	文字列	本ページに移動する前のURLで、 getScreenUrl を呼び出して設定が必要です。

• APP viewクリックイベント（ta_app_click）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#title	ページタイトル	文字列	viewが属している Activity のタイトルで、 Activity の title プロパティで値を付与されます
#screen_name	ページ名称	文字列	viewが属している Activity のパッケージ名、カテゴリ名
#element_id	エレメント ID	文字列	viewのID、デフォルトで android:id を使用、 setViewID を呼び出しして設定可能です。
#element_type	エレメントタイプ	文字列	viewのタイプ
#element_selector	エレメントセレクター	文字列	viewの viewPath のスプライシング
#element_position	エレメント位置	文字列	viewの位置情報、viewが position プロパティが存在する時に送信されます
#element_content	エレメント内容	文字列	view上の内容

• APP のクラッシュイベント（ta_app_crash）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#app_crashed_reason	異常情報	文字列	クラッシュ発生時のスタックトレースを記録されます

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

上記以外のプリセットプロパティとして、一部呼び出ししてから記録されるプリセットプロパティ：

プロパティ名	名称	タイプ	説明
#duration	経過時間	数値	時間経過機能timeEventを呼び出して、イベントの経過時間を記録される。単位は秒
#background_duration	バックグラウンドの経過時間	数値	時間経過機能timeEventを呼び出して、イベントの経過時間を記録される。単位は秒

プリセットプロパティを取得

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

以下の方法でサーバのトラッキングはApp側の一部プリセットプロパティを取得し、サーバ側に転送できます。

   //get property objects
   TDPresetProperties presetProperties = instance.getPresetProperties();

   //Preset properties of Event
   JSONObject properties = presetProperties.toEventPresetProperties();
   /*
   {
        "#carrier": "T-Mobile",
        "#os": "Android",
        "#device_id": "dd4a508df0dbff08",
        "#screen_height": 2560,
        "#bundle_id": "cn.thinkingdata.android.demo",
        "#device_model": "sdk_gphone64_arm64",
        "#screen_width": 1440,
        "#system_language": "en",
        "#install_time": "2022-08-19 17:31:52.398",
        "#simulator": true,
        "#manufacturer": "Google",
        "#os_version": "12",
        "#app_version": "1.0",
        "#network_type": "3G",
        "#zone_offset": 8,
        "#ram": "0.8\/1.9",
        "#disk": "0.1\/0.8",
        "#fps": 60
    }
   */

    //get a certain preset properties
    String bundle_id = presetProperties.bundle_id;//package name
    String os =  presetProperties.os;//os type, e.g., Android
    String system_language = presetProperties.system_language;//type of mobile phone system language
    int screen_width = presetProperties.screen_width;//screen width
    int screen_height = presetProperties.screen_height;//screen height
    String device_model = presetProperties.device_model;//device model
    String device_id = presetProperties.device_id;//unique identifier of device
    String carrier = presetProperties.carrier;//information about operator of the SIM card. Operation information of the primary card should be get under dual-card dual-standby mode 
    String manufacture = presetProperties.manufacture;//mobile phone manufacturer, e.g., HuaWei
    String network_type = presetProperties.network_type;//network type
    String os_version = presetProperties.os_version;//system version number
    String app_version = presetProperties.app_version;//app version number
    double zone_offset = presetProperties.zone_offset;//timezone offset value
    String ram = presetProperties.ram;//storage usage
    String disk = presetProperties.disk;//disk usage
    int fps = presetProperties.fps;//fps
    String installTime = presetProperties.installTime;//app installation time
    boolean isSimulator = presetProperties.isSimulator;//the device is a simulator or not
    

IP、国都市の情報はサーバ側で解析して生成され、クライアントからの呼び出しが提供されていません。

プリセットプロパティ収集を禁止

特定の場合で、プリセットプロパティ収集を禁止したい場合、プロジェクトカテゴリのres/valuesの目次で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>#zone_offset</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>-->
<!--        <item>#background_duration</item>-->
<!--        <item>#duration</item>-->
    </string-array>
    <!-- ThinkingAnalytics DisablePresetProperties end -->
</resources>

Android IDプロパティについて、TE側はコードレベルでの完全隔離が対応できます。隔離された後で、APP内ではプロパティを取得するコードは一切なくなります。詳しくは自動収集にて参照ください。