시스템 속성

최근 업데이트 2026. 10. 07.

1. 모든 이벤트의 시스템 속성

다음 시스템 속성은 JavaScript SDK의 모든 이벤트(자동 수집 이벤트 포함)에 포함되는 시스템 속성입니다

속성 이름	한국어 이름	속성 타입	설명
#ip	IP 주소	텍스트	유저의 IP 주소로, AE는 이를 기반으로 유저의 지리적 위치 정보를 가져옵니다
#country	국가	텍스트	유저가 있는 국가로, IP 주소를 기반으로 생성됩니다
#country_code	국가 코드	텍스트	유저가 있는 국가의 국가 코드(ISO 3166-1 alpha-2, 즉 영문 대문자 2자리)로, IP 주소를 기반으로 생성됩니다
#province	성(Province)	텍스트	유저가 있는 성/주로, IP 주소를 기반으로 생성됩니다
#city	도시	텍스트	유저가 있는 도시로, IP 주소를 기반으로 생성됩니다
#device_id	디바이스 ID	텍스트	유저의 디바이스 ID
#screen_height	화면 높이	숫자	유저 디바이스의 화면 높이(예: 1920 등)
#screen_width	화면 너비	숫자	유저 디바이스의 화면 높이(예: 1080 등)
#lib	SDK 타입	텍스트	연동한 SDK의 타입(예: JavaScript 등)
#lib_version	SDK 버전	텍스트	연동한 SDK의 버전
#os	운영 체제	텍스트	예: Android, iOS 등
#browser	브라우저 유형	텍스트	유저가 사용하는 브라우저 유형(예: Chrome, Firefox 등)
#browser_version	브라우저 버전	텍스트	유저가 사용하는 브라우저의 버전(예: Chrome 61.0, Firefox 57.0 등)
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이(시간 단위)
#system_language	시스템 언어	텍스트	유저 시스템에 설정된 언어
#ua	유저의 현재 에이전트 정보	텍스트	고객이 사용하는 운영 체제 및 버전, 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 속성을 입력하십시오