Android

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

팁

Android SDK의 최소 시스템 버전 요구 사항은 Android 4.0(API 14)입니다

최신 버전: v1.4.1

업데이트 시간: 2026-05-12

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

1. 개요

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

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

2. 통합

2.1 SDK 자동 통합

• Project 수준의 build.gradle 파일에 다음 의존성 설정을 추가합니다

buildscript {
    repositories {
        jcenter()
        mavenCentral()
    }
}

• module 프로젝트 디렉터리의 build.gradle 파일에 의존성을 추가합니다.

dependencies {
    implementation 'cn.thinkingdata.android:TDStrategy:1.4.1'
}

2.2 ThinkingData SDK 수동 통합

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

SDK 이름	기능 소개	버전 요구 사항
TDAnalytics	데이터 수집 및 처리	>= 3.1.0
TDRemoteConfig	AE 백엔드의 설정 정보 가져오기	>= 1.0.0
TDCore	기본 컴포넌트 기능 제공	>= 1.1.0
TDStrategy	클라이언트 트리거 기능 제공	>=1.0.0

1. 페이지 상단의 리소스 다운로드 링크를 클릭하여 SDK를 다운로드하고 압축을 해제합니다
2. libs 폴더에 TDAnalytics.aar, TDCore.aar, TDRemoteConfig.aar, TDStrategy.aar를 추가합니다
3. build.gradle에 다음 설정을 추가합니다

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
}

3. 초기화

SDK 초기화

import cn.thinkingdata.core.TDApp;
import cn.thinkingdata.core.TDSettings;
// TDSettings 설정의 자세한 사용 방법은 [고급 가이드]를 참고하십시오
TDSettings settings = new TDSettings();
settings.appId = "AppId";
settings.serverUrl = "ServerUrl";
TDApp.init(this,settings);

4. 콜백 리스너 설정

SDK 초기화에 성공하면 TDStrategy SDK에 콜백 리스너를 설정합니다.

import cn.thinkingdata.strategy.TDStrategy;
import cn.thinkingdata.strategy.core.result.TDStrategyResult;
import cn.thinkingdata.strategy.core.result.TDStrategyResultListener;

TDStrategy.setTriggerListener(new TDStrategyResultListener() {
    @Override
    public void onTriggerResult(TDStrategyResult tdStrategyResult) {
        
    }
});

4.1 콜백 데이터 모델

public class TDStrategyResult {
    public String appId;
    public String taskId;
    public String channelMsgType;
    public String pushId;
    public JSONObject content;
    public JSONObject userParams;
    public JSONObject opsProperties;
}

속성 설명

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