JS

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

최신 버전: v1.3.0

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

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

1. 개요

AE 4.4 버전부터 운영 모듈에 클라이언트 트리거 작업 기능이 출시되어, 앱 내 신규 유저 가입, 캐릭터 생성 등의 시나리오에서 밀리초 단위 트리거 요구를 지원하며 실시간 A/B 분할도 지원합니다. 클라이언트 측에서는 ThinkingData SDK가 AE 백엔드와 통신하여 작업을 가져오고 계산합니다.

클라이언트에 ThinkingData SDK를 통합해야 합니다. 클라이언트는 ThinkingData SDK와의 상호 작용만 고려하면 되며, AE 백엔드의 작업 세부 사항은 신경 쓸 필요가 없습니다.

2. 통합

2.1 SDK 수동 통합

클라이언트 트리거 작업에는 다음 ThinkingData SDK가 필요합니다.

SDK 이름	소개	버전 요구 사항
TDAnalytics	데이터 수집 및 처리	>= 2.1.0
TDRemoteconfig	AE 백엔드의 설정 정보 가져오기	>= 1.1.0
TDCore	통합 초기화 기능 제공	>= 1.1.0
TDStrategy	클라이언트 트리거 기능 제공	>=1.1.0

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

3. 초기화

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

<script src="./thinkingdata.umd.min.js"></script>
<script src="./tdcore.umd.min.js"></script>
<script src="./tdremoteconfig.umd.min.js"></script>
<script src="./tdstrategy.umd.min.js"></script>
<script>
TDApp.init({
   appId: "AppId",
   serverUrl:"ServerUrl",
   enableLog:true,
   autoTrack: {
       pageShow: true, // ta_page_show 자동 수집
       pageHide: true // ta_page_hide 자동 수집
   },
   triggerListener:function(result){
   
   }
 });
</script>

4. 콜백 리스너 설정

SDK를 초기화할 때 TDStrategy SDK에 콜백 리스너를 설정합니다.

//초기화 config에서 설정
triggerListener:function(result){
   
}

TDStrategy SDK 작업 트리거 결과:

속성 이름	타입	설명
channelMsgType	String	채널 메시지 타입
appId	String	AE 프로젝트의 app id
pushId	String	운영 작업의 채널 전송 ID
taskId	String	운영 작업의 ID
content	object	운영 작업의 푸시 콘텐츠
userParams	object	클라이언트 채널의 커스텀 파라미터
opsProperties	object	클라이언트 트리거 작업에 포함된 채널 정보로, 도달 퍼널 이벤트의 회신 파라미터로 사용됩니다.