본문으로 건너뛰기

설정 옵션 참조

BotManager Browser Agent는 기본 설정 외에도 사용자 맞춤 설정을 지원합니다. 다음은 사용 가능한 설정 옵션입니다.

설정 옵션 목록​

항목설명타입기본값
cfg.networkTimeout탐지 서버로의 요청 시 네트워크 타임아웃 시간(밀리초)입니다.number3000
cfg.detectOnLoad페이지 로드 후 자동으로 탐지 요청을 전송할지 여부를 설정합니다.booleantrue
cfg.detectDevTools개발자 도구 탐지 기능을 활성화할지 여부를 설정합니다.booleantrue
cfg.detectClickBehavior사용자 클릭 탐지 기능을 활성화할지 여부를 설정합니다.booleantrue
cfg.detectClickSampleSize클릭 탐지에 사용될 표본 클릭 수를 설정합니다. 표본이 많을수록 더 정확한 분석이 가능합니다.number10
cfg.detectClickThreshold클릭 패턴 분석에서 민감도를 조정하는 값입니다. 값이 낮을수록 민감도가 높아져 작은 변화도 탐지됩니다.number15
cfg.detectClickMaxTimeDiff두 클릭 사이의 간격이 이 시간(밀리초)를 넘으면 표본을 초기화합니다.number60000

설정 예제​

기본 설정​

<script>
  (function(cfg) {
    cfg.tenantId = '{{ TENANT_ID }}';
    cfg.domainName = '{{ DOMAIN }}';
    cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
  })(window['BotManager-config'] || (window['BotManager-config'] = {}));
</script>

커스텀 설정​

<script>
  (function(cfg) {
    cfg.tenantId = '{{ TENANT_ID }}';
    cfg.domainName = '{{ DOMAIN }}';
    cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
    
    // 커스텀 설정
    cfg.networkTimeout = 5000; // 5초 타임아웃
    cfg.detectOnLoad = false; // 자동 탐지 비활성화
    cfg.detectDevTools = true; // 개발자 도구 탐지 활성화
    cfg.detectClickBehavior = true; // 클릭 행위 탐지 활성화
    cfg.detectClickSampleSize = 15; // 클릭 표본 수 증가
    cfg.detectClickThreshold = 10; // 민감도 증가
    cfg.detectClickMaxTimeDiff = 30000; // 30초로 단축
  })(window['BotManager-config'] || (window['BotManager-config'] = {}));
</script>

옵션 상세 설명​

networkTimeout​

탐지 서버로의 요청 시 네트워크 타임아웃 시간을 설정합니다. 네트워크가 불안정한 환경에서는 값을 늘리는 것을 권장합니다.

cfg.networkTimeout = 5000; // 5초

detectOnLoad​

페이지 로드 시 자동으로 탐지 요청을 전송할지 여부를 설정합니다. false로 설정하면 BotManager.detectPage()를 수동으로 호출해야 합니다.

cfg.detectOnLoad = false; // 자동 탐지 비활성화

detectDevTools​

개발자 도구가 열려있는 상태를 감지하는 기능을 활성화할지 여부를 설정합니다.

cfg.detectDevTools = true; // 개발자 도구 탐지 활성화

detectClickBehavior​

사용자의 클릭 패턴을 분석하여 비정상적인 행동을 탐지하는 기능을 활성화할지 여부를 설정합니다.

cfg.detectClickBehavior = true; // 클릭 행위 탐지 활성화

detectClickSampleSize​

클릭 탐지에 사용될 표본 클릭 수를 설정합니다. 값이 클수록 더 정확한 분석이 가능하지만, 더 많은 클릭이 필요합니다.

cfg.detectClickSampleSize = 15; // 15개의 클릭을 표본으로 사용

detectClickThreshold​

클릭 패턴 분석에서 민감도를 조정하는 값입니다. 값이 낮을수록 민감도가 높아져 작은 변화도 탐지됩니다.

cfg.detectClickThreshold = 10; // 민감도 증가

detectClickMaxTimeDiff​

두 클릭 사이의 간격이 이 시간(밀리초)를 넘으면 표본을 초기화합니다. 사용자가 일정 시간 동안 클릭하지 않으면 새로운 표본 수집을 시작합니다.

cfg.detectClickMaxTimeDiff = 30000; // 30초