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

プリセットプロパティ

最終更新 2026/08/27

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

以下のプリセットプロパティは、ミニアプリ/ミニゲームSDKのすべてのイベント（自動収集イベントを含む）に付与されるプリセットプロパティです

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

#ip

IPアドレステキストユーザーのIPアドレス。AEはこれを基にユーザーの位置情報を取得します
#country国テキストユーザーの所在国。IPアドレスに基づいて生成されます
#country_code国コードテキストユーザーの所在国の国コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province省テキストユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city都市テキストユーザーの所在都市。IPアドレスに基づいて生成されます
#device_modelデバイスモデルテキストユーザーのデバイスのモデル。iPhone 8など
#device_idデバイスIDテキストユーザーのデバイスID。初期化時に生成されたUUIDを使用します
#screen_height画面の高さ数値ユーザーのデバイスの画面の高さ。1920など
#screen_width画面の幅数値ユーザーのデバイスの画面の高さ。1080など
#manufacturerデバイスのメーカーテキストユーザーのデバイスのメーカー。Apple、vivoなど
#os_versionOS バージョンテキストiOS 11.2.2、Android 8.0.0など
#osOSテキストAndroid、iOSなど
#network_typeネットワーク状態テキストイベント送信時のネットワーク状態。WIFI、3G、4Gなど
#libSDKタイプテキスト接続したSDKのタイプ。MP（ミニアプリ）、MG（ミニゲーム）など
#lib_versionSDKバージョンテキスト接続したSDKのバージョン
#sceneシーン値数値ミニアプリ/ミニゲームの起動時に渡されるシーン値
#mp_platformミニアプリプラットフォームテキストアプリが動作しているプラットフォームを示します
#zone_offset

タイムゾーンオフセット

数値データ時刻のUTCからのオフセット時間数
#system_languageシステム言語テキストユーザーのデバイスのシステム言語(ISO 639-1、つまり小文字の英字2文字)。zh、enなど

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

以下のプリセットプロパティは、各自動収集イベントに固有のプリセットプロパティです

  • ミニアプリの起動（ta_mp_show）のプリセットプロパティ
プロパティ名画面表示名プロパティタイプ説明
#url_pathページパステキストミニアプリの起動時に表示されたページのパス

#start_reason

アプリの起動元テキスト内容はJSON文字列で、getLaunchOptionsSyncインターフェースから取得したパラメーターです
  • ミニアプリの非表示（ta_mp_hide）のプリセットプロパティ
プロパティ名画面表示名プロパティタイプ説明
#duration

イベントの所要時間

数値今回の起動ta_mp_showから非表示ta_mp_hideまでの継続時間を表します。単位は秒です
  • ミニアプリのページビュー（ta_mp_view）のプリセットプロパティ
プロパティ名画面表示名プロパティタイプ説明
#url_pathページパステキストページパス。表示されたページのパスです
#referrer参照元パステキスト表示されたページの前のページのパス、つまり遷移前のパスです。ミニアプリの起動時に表示されたトップページの場合、値は「直接打开」になります
  • ミニアプリのページ転送・シェア（ta_mp_share）のプリセットプロパティ
プロパティ名画面表示名プロパティタイプ説明
#url_pathページパステキストミニアプリが転送されたときのページパス

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

サーバー側のトラッキングでApp側の一部のプリセットプロパティが必要な場合は、この方法でクライアント側のプリセットプロパティを取得し、サーバーに渡すことができます。

//プロパティオブジェクトを取得
var presetProperties = TDAnalytics.getPresetProperties();
//イベントのプリセットプロパティを生成
var properties = presetProperties.toEventPresetProperties();
/*
      {
         "#device_model":"iPhone 5",
         "#device_id":"3204487163-1624513721217",
         "#screen_width":320,
         "#screen_height":568,
         "#os":"iOS",
         "#os_version":"10.0.1",
         "#network_type":"wifi",
         "#zone_offset":8,
         "#manufacturer":"Apple"
       }
 */
//特定のプリセットプロパティを取得
var os=presetProperties.os;//osタイプ。Androidなど
var osVersion=presetProperties.osVersion;//システムのバージョン番号
var networkType=presetProperties.networkType;//ネットワークタイプ
var manufacture=presetProperties.manufacturer;//デバイスメーカー
var deviceModel=presetProperties.deviceModel;//デバイスモデル
var screenWidth=presetProperties.screenWidth;//画面の幅
var screenHeight=presetProperties.screenHeight;//画面の高さ
var deviceId=presetProperties.deviceId;//デバイスID
var zoneOffset=presetProperties.zoneOffset;//タイムゾーンオフセット値

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

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