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

プリセットプロパティ

最終更新 2026/10/03

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

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

ミニゲームプラットフォームのすべてのイベントに付与されるプリセットプロパティ:

プロパティ名画面表示名プロパティタイプ説明
#ipIPアドレステキストユーザーの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のタイプ。MG（ミニゲーム）など
#lib_versionSDKバージョンテキスト接続したSDKのバージョン
#sceneシーン値数値WeChatミニゲームの起動時に渡されるシーン値
#mp_platformミニゲームプラットフォームテキストアプリが動作しているプラットフォームを示します
#zone_offsetタイムゾーンオフセット数値データ時刻のUTCからのオフセット時間数

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

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

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

#start_reason

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

#duration

イベントの所要時間

数値今回の起動ta_mg_showから非表示ta_mg_hideまでの継続時間を表します。単位は秒です

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

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