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

プリセットプロパティとシステムフィールド

最終更新 2026/10/03
ヒント

このセクションでは、AEのすべてのプリセットプロパティとシステムフィールドについて説明します。各プラットフォームのプリセットプロパティについては、以下を参照してください：

Androidプラットフォーム、iOSプラットフォーム、Webプラットフォーム、ミニアプリ&ミニゲームプラットフォーム、サーバー

プリセットプロパティとは、AEが生成または取得するプロパティです。すべてのプリセットプロパティは"#"で始まり、いずれもイベントプロパティです。また、これらのプロパティの表示名と意味はすでに決まっています。システムフィールドとは、データ内の構造フィールド（#account_id、#event_timeなど）や、データベース内で特別な用途を持つフィールドのことです。分析モデルでは使用されないか、間接的に使用されることがほとんどです。

以下に挙げるプリセットプロパティを除き、"#"で始まるプロパティはすべて不正なフィールドとみなされ、格納できません。そのため、カスタムプロパティを"#"で始まる名前にすることはお勧めしません。また、すべてのシステムフィールドは、データ送信時にイベントプロパティやユーザープロパティとして渡すことはできません。

ご注意ください。#ip以外のすべてのプリセットプロパティは、直接使用することをお勧めしません。クライアントSDKとほかの転送方式を併用していて、複数の端末のデータでプロパティを揃える必要がある場合にのみ、ThinkingAIの担当者の案内のもとで設定することをお勧めします。送信するデータのプリセットプロパティのプロパティタイプが表の内容と一致していることを必ず確認してください。タイプが一致しない場合、そのプロパティの値は破棄されます（つまり値はnullになります）。

  • プリセットプロパティ
プロパティ名画面表示名プロパティタイプ説明
#ipクライアントIPテキストユーザーのIPアドレス。AEはこれを基にユーザーの位置情報を取得します
#country国・地域テキストユーザーの所在国・地域。IPアドレスに基づいて生成されます

#country_code

国・地域コード

テキスト

ユーザーの所在国・地域の国・地域コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province省テキストユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city都市テキストユーザーの所在都市。IPアドレスに基づいて生成されます
#os_versionOS バージョンテキストiOS 11.2.2、Android 8.0.0など
#manufacturerメーカーテキストユーザーのデバイスのメーカー。Apple、vivoなど
#osOSテキストAndroid、iOSなど
#device_idデバイスIDテキストユーザーのデバイスID。iOSではユーザーのIDFVまたはUUID、AndroidではandroidIDを取得
#screen_height画面の高さ数値ユーザーのデバイスの画面の高さ。1920など
#screen_width画面の幅数値ユーザーのデバイスの画面の幅。1080など
#device_modelデバイスモデルテキストユーザーのデバイスのモデル。iPhone 8など
#device_typeデバイスタイプテキストユーザーのデバイスのタイプ。iPad、iPhoneなど
#app_versionアプリバージョンテキストAPPのバージョン
#bundle_idアプリパッケージ名テキストAPPのパッケージ名またはプロセス名
#libSDKタイプテキスト接続したSDKのタイプ。Android、iOSなど
#lib_versionSDKバージョンテキスト接続したSDKのバージョン
#network_typeネットワークタイプテキストイベント発生時のネットワーク状態。WIFI、3G、4Gなど
#carrier通信キャリアテキストユーザーのデバイスの通信キャリア。中国移动、中国电信など
#browserブラウザテキストユーザーが使用しているブラウザの種類。Chrome、Firefoxなど
#browser_version

ブラウザバージョン

テキストユーザーが使用しているブラウザのバージョン。Chrome 61.0、Firefox 57.0など
#durationイベント継続時間数値タイマー機能で記録した時間。単位は秒
#urlページアドレステキスト自動収集イベントで使用。現在のページ（業務で定義したページではない）のアドレス。Webページではlocation.href、Android / iOSプラットフォームではカスタムのページパスが値になります
#url_path

ページパス

テキスト

自動収集イベントで使用。現在のページ（業務で定義したページではない）のパス。値はlocation.pathnameです

#referrer

参照元アドレス

テキスト自動収集イベントで使用。遷移前のページ（業務で定義したページではない）のアドレス。Webページではdocument.referrer、Android / iOSプラットフォームではカスタムの遷移元ページパスが値になります
#referrer_host参照元ドメインテキスト自動収集イベントで使用。遷移前のページ（業務で定義したページではない）のドメイン。値はreferrerのhostです
#title

ページタイトル

テキスト自動収集イベントで使用。現在のページ（業務で定義したページではない）のタイトル。Webページではdocument.titleが値になります。AndroidプラットフォームではActivityのタイトル、つまりActivityのtitleプロパティの値です。iOSプラットフォームではView Controllerのタイトル、つまりcontroller.navigationItem.titleプロパティの値です
#screen_name

ページ名

テキスト自動収集イベントで使用。ページ（業務で定義したページではない）の名前。AndroidプラットフォームではActivityのパッケージ名.クラス名、iOSプラットフォームではView Controllerのクラス名が値になります
#element_id要素IDテキスト自動収集イベントで使用。コントロールのID
#element_type要素タイプテキスト自動収集イベントで使用。コントロールのタイプ
#resume_from_backgroundバックグラウンドからの復帰かどうかブール値自動収集イベントで使用。アプリがバックグラウンドから復帰したかどうか。ブール型
#element_selector要素セレクターテキスト自動収集イベントで使用。コントロールのviewPath
#element_position要素の位置テキスト自動収集イベントで使用。コントロールの位置情報
#element_content要素の内容テキスト自動収集イベントで使用。コントロール上の内容
#sceneシーン値数値WeChatミニプログラムの起動時に渡されるシーン値
#mp_platformミニアプリプラットフォームテキストアプリが動作しているプラットフォームを示します
#app_crashed_reason例外情報テキスト自動収集イベントで使用。APPがクラッシュしたときのスタック情報を記録します
#zone_offsetタイムゾーンオフセット数値データ時刻のUTCからのオフセット時間数

#system_language

システムのデフォルト言語

テキストユーザーのデバイスのシステム言語(ISO 639-1、つまり小文字の英字2文字)。zh、enなど
#install_timeAppのインストール時間時間ユーザーがアプリをインストールした時間。値はシステムから取得されます
#simulatorシミュレーターかどうか数値デバイスがシミュレーターかどうか（true/false）
#ramメモリ(GB)テキストユーザーのデバイスの現在の空きメモリと総メモリ。単位はGB。1.4/2.4など
#disk

ディスク(GB)

テキストユーザーのデバイスの現在の空きストレージ容量と総ストレージ容量。単位はGB。30/200など
#fpsFPS数値ユーザーのデバイスの現在のフレームレート（1秒あたりのフレーム数）。60など
#background_duration

バックグラウンド滞在時間

数値2回のstartイベントの間で、アプリがバックグラウンドにあった時間を記録します。単位は秒
#start_reason

起動理由

テキスト

アプリがlauncher以外の方法で起動された場合にのみ存在するプロパティです。deeplinkによる起動や、ほかのアプリからのstartActivityによる起動などが該当します。データの例："#start_reason":"{"url":"thinkingdata:\/\/","data":""}"
#ua現在のユーザーエージェント情報

テキスト

クライアントが使用しているOSとそのバージョン、CPUの種類、ブラウザとそのバージョン、ブラウザのレンダリングエンジン、ブラウザの言語、ブラウザのプラグインなどを識別できる情報です。

#utm

広告キャンペーンのソースプロパティ

テキストユーザーの流入元の広告情報。広告のソース、広告のメディアなどの情報を含みます
  • イベントテーブルのシステムフィールド
フィールド名画面表示名プロパティタイプ説明
$part_eventイベントパーティションフィールドテキストイベントパーティションフィールド。#event_name、つまりイベント名から取得します
$part_date

日付パーティションフィールド

時間日付パーティションフィールド。#event_time、つまりイベントの発生日から取得します
#app_idプロジェクトIDテキストイベントが属するプロジェクトのID
#user_idユーザー一意ID数値システム内でのユーザーの一意の識別子
#account_idアカウント IDテキストアカウント ID。データ内の#account_idに相当します
#distinct_idゲストIDテキストゲストID。データ内の#distinct_idに相当します
#event_nameイベント名テキストイベント名。データ内の#event_nameフィールドに相当します
#event_timeイベント時間時間イベント時間。データ内の#timeフィールドに相当します
#server_timeサーバー時間時間サーバーがデータを受信した時刻
#dw_create_time初回格納時間時間このイベントデータの格納時間。更新可能イベントでは、このプロパティはすべてnullです
#dw_update_time格納更新時間時間このイベントデータの格納更新時間。更新可能イベント以外では、このプロパティはすべてnullです
#kafka_offsetkafkaオフセット数値kafka上でのイベントのオフセット値
#uuidUUIDテキストイベントの識別ID
  • ユーザーテーブルのシステムフィールド
フィールド名画面表示名プロパティタイプ説明
#user_idユーザー一意ID数値システム内でのユーザーの一意の識別子
#account_idアカウント IDテキストアカウント ID。データ内の#account_idに相当します
#distinct_idゲストIDテキストゲストID。データ内の#distinct_idに相当します
#active_timeアクティベーション時刻時間このユーザーの最初のデータ（イベントデータとユーザープロパティデータを含む）が格納されたときの、そのデータの#timeフィールドの時刻
#reg_time

登録時間

時間このユーザーのアカウント IDを含む最初のデータ（イベントデータとユーザープロパティデータを含む）が格納されたときの、そのデータの#timeフィールドの時刻
#update_time更新日時時間最後に受信したユーザープロパティデータの#timeフィールドの時刻
#server_timeサーバー時間時間最後に受信したユーザープロパティデータのサーバー時刻
#dw_update_time格納更新時間時間このユーザーデータの最新の更新時刻
#event_date最新のイベント日付数値このユーザーの最新のイベントが格納された日付
#user_operationユーザー操作タイプテキストユーザープロパティデータの操作タイプ
#kafka_offsetkafkaオフセット数値kafka上でのユーザープロパティデータのオフセット値
#uuidUUIDテキストユーザープロパティデータの識別ID
このページは役に立ちましたか？