プリセットプロパティ

最終更新 2026/10/07

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

次のプリセットプロパティは、JavaScript SDKのすべてのイベント（自動収集イベントを含む）に付与されます

プロパティ名	画面表示名	プロパティタイプ	説明
#ip	IPアドレス	テキスト	ユーザーのIPアドレス。AEはこれを基にユーザーの位置情報を取得します
#country	国	テキスト	ユーザーの所在国。IPアドレスに基づいて生成されます
#country_code	国コード	テキスト	ユーザーの所在国の国コード(ISO 3166-1 alpha-2、つまり大文字の英字2文字)。IPアドレスに基づいて生成されます
#province	省	テキスト	ユーザーの所在する省・州。IPアドレスに基づいて生成されます
#city	都市	テキスト	ユーザーの所在都市。IPアドレスに基づいて生成されます
#device_id	デバイスID	テキスト	ユーザーのデバイスID
#screen_height	画面の高さ	数値	ユーザーのデバイスの画面の高さ。1920など
#screen_width	画面の幅	数値	ユーザーのデバイスの画面の高さ。1080など
#lib	SDKタイプ	テキスト	接続したSDKのタイプ。JavaScriptなど
#lib_version	SDKバージョン	テキスト	接続したSDKのバージョン
#os	OS	テキスト	Android、iOSなど
#browser	ブラウザの種類	テキスト	ユーザーが使用しているブラウザの種類。Chrome、Firefoxなど
#browser_version	ブラウザバージョン	テキスト	ユーザーが使用しているブラウザのバージョン。Chrome 61.0、Firefox 57.0など
#zone_offset	タイムゾーンオフセット	数値	データ時刻のUTCからのオフセット時間数
#system_language	システム言語	テキスト	ユーザーのシステムで設定されている言語
#ua	現在のユーザーエージェント情報	テキスト	クライアントが使用しているOSとそのバージョン、CPUの種類、ブラウザとそのバージョン、ブラウザのレンダリングエンジン、ブラウザの言語、ブラウザのプラグインなどを識別できる情報です。
#utm	広告キャンペーンのソースプロパティ	テキスト	ユーザーの流入元の広告情報。広告のソース、広告のメディアなどの情報を含みます

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

プロパティ名	画面表示名	プロパティタイプ	説明
#url	ページアドレス	テキスト	現在のページのアドレス
#url_path	ページパス	テキスト	現在のページのパス
#referrer	参照元アドレス	テキスト	遷移前のページのアドレス
#referrer_host	参照元ドメイン	テキスト	遷移前のページのドメイン
#title	ページタイトル	テキスト	現在のページのタイトル

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

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

   //プロパティオブジェクトを取得
   var presetProperties = ta.getPresetProperties();

   //イベントのプリセットプロパティを生成
   var properties = presetProperties.toEventPresetProperties();
   /*
    {
      "#os":"Mac OS X",
      "#screen_width":1920,
      "#screen_height":1080,
      "#browser":"chrome",
      "#browser_version":"91.0.4472.114",
      "#device_id":"17a3858fafd9b4-0693d07132e2d1-34657600-2073600-17a3858fafea9b",
      "#zone_offset":8
    }
   */

    //特定のプリセットプロパティを取得
    var os =  presetProperties.os;//osタイプ。Androidなど
    var screenWidth = presetProperties.screenWidth;//画面の幅
    var screenHeight = presetProperties.screenHeight;//画面の高さ
    var browser = presetProperties.browser;//ブラウザの種類
    var browserVersion =  presetProperties.browserVersion;//ブラウザのバージョン番号
    var deviceId = presetProperties.deviceId;//デバイスID
    var zoneOffset = presetProperties.zoneOffset;//タイムゾーンオフセット値

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

4. プリセットプロパティの収集の無効化

シナリオによっては、コンプライアンスや実際の業務要件などを考慮して、一部のプリセットプロパティの収集を禁止したい場合があります。初期化時にdisablePresetPropertiesフィールド（タイプはArray）を渡すと、追加したフィールドに対応するプリセットプロパティはアップロードされなくなります。たとえば、"#os", "#lib", "#lib_version", "#url", "#url_path"などのプリセットプロパティをブロックする場合は、次のように設定します：

var config = {
    appId: "APP_ID",
    serverUrl: "https://YOUR_SERVER_URL/sync_js",
    batch:true,
    autoTrack: {
     pageShow: true,
     pageHide: true,
    },
    disablePresetProperties:['#os','#lib_version','#lib','#screen_height','#screen_width','#browser','#browser_version',
    '#system_language','#ua','#utm','#referrer','#referrer_host','#url','#url_path','#title','#element_type']
};
window.ta = thinkingdata;
ta.init(config);

デバイスIDをブロックした状態で初回イベントを使用する場合は、必ずfirst_check_idプロパティを指定してください