JS

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

최신 버전: v1.0.0

업데이트 시간: 2026-07-24

리소스 다운로드: 다운로드

1. 개요

6.1 버전부터 AE에 실험 키트 기능이 추가되었습니다. AE 백엔드에서 실험을 생성하고 대조군과 실험 그룹의 변수 값을 설정한 후, 클라이언트 SDK를 통해 App으로 가져와 그룹별로 유저에게 서로 다른 콘텐츠를 표시할 수 있습니다.

이 문서에서는 클라이언트 SDK의 통합 과정을 소개합니다. App 측에서는 ThinkingData SDK와의 상호 작용만 고려하면 되며, AE 백엔드의 작업 세부 사항은 신경 쓸 필요가 없습니다.

실험 SDK는 반드시 구성 센터 SDK와 함께 사용해야 한다는 점에 유의하십시오.

2. 통합

2.1 SDK 수동 통합

구성 센터에는 다음 ThinkingData SDK가 필요합니다.

SDK 이름	소개	버전 요구 사항
TDAnalytics	데이터 수집 및 처리	>= 2.6.0
TDRemoteconfig	AE 백엔드의 설정 정보 가져오기	>= 1.3.0

1. 페이지 상단의 리소스 다운로드 링크를 클릭하여 SDK를 다운로드하고 압축을 해제합니다
2. thinkingdata.umd.min.js, tdremoteconfig.umd.min.js, tdexperiment.umd.min.js를 프로젝트의 같은 디렉터리로 드래그합니다

3. 초기화

현재 통합 방식으로 전환한 후에는 SDK 초기화에 TDApp 인스턴스를 사용하고, 그 외 데이터 수집 및 전송에는 window.thinkingdata 인스턴스를 사용합니다.

<script src="./thinkingdata.umd.min.js"></script>
<script src="./tdremoteconfig.umd.min.js"></script>
<script src="./tdexperiment.umd.min.js"></script>
//수집 SDK 초기화
window.ta = thinkingdata;
ta.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
});
//실험 SDK 초기화
TDExperiment.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
    automaticExposureTracking: true,
    customBucketId:{},
    customFetchParams: {},
    enableLog: true,
    onFetchSuccess: function () {
    },
    onFetchFailure: function (code, msg) {

    }
});

초기화 파라미터 설명:

• appId：APP ID
• serverUrl: 데이터 수집 주소
• automaticExposureTracking: 기본값은 true이며, get으로 실험 파라미터를 가져올 때 노출 이벤트를 자동으로 업로드합니다
• customBucketId: 커스텀 분할 단위
• customFetchParams: 클라이언트 구성 채널의 커스텀 파라미터
• enableLog: 디버깅 로그 활성화 여부
• onFetchSuccess: 실험 구성 정보 가져오기 성공
• onFetchFailure: 실험 구성 정보 가져오기 실패

4. 사용

4.1 실험 정보 가져오기

TDExperiment.getValueAsString(key)

TDExperiment.getValueAsNumber(key)

TDExperiment.getValueAsBoolean(key)

TDExperiment.getValueAsJson(key)

automaticExposureTracking이 true이면 get할 때 노출 이벤트를 자동으로 업로드합니다

4.2 노출 이벤트 업로드

exposure 메서드를 호출하여 노출 이벤트를 수동으로 업로드할 수 있습니다

TDExperiment.exposure(key);

4.3 모든 실험 정보 능동적으로 가져오기

TDExperiment.fetch();

TDExperiment.fetch().addOnSuccessListener(function () {
    //성공
}).addOnFailureListener(function (code, msg) {
    //실패
});

4.4 커스텀 분할 단위

TDExperiment.setCustomBucketId({
    'bucket_id':'account_id'
});

4.5 커스텀 요청 파라미터

TDExperiment.setCustomFetchParams({
    'key':'value'
});