Unreal

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

팁

현재 Android 및 iOS 플랫폼을 지원합니다.

최신 버전: v1.0.0

업데이트 시간: 2025-01-09

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

Beta 버전: 없음

1. 개요

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

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

2. SDK 통합

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

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

2.1 플러그인 통합

Unreal SDK를 다운로드하고 압축을 푼 후 TDAnalytics TDRemoteConfig TDStrategy를 프로젝트의 Plugins 디렉터리에 넣습니다. Plugins 디렉터리가 없으면 먼저 프로젝트 루트 디렉터리에 Plugins 디렉터리를 만든 다음 이 세 플러그인을 그 안에 넣습니다.

2.2 플러그인 활성화

1. Unreal Editor를 재시작합니다

2. 편집 > 플러그인을 열고 프로젝트 TDAnalytics TDRemoteConfig TDStrategy 카테고리에서 TDAnalytics TDRemoteConfig TDStrategy를 활성화합니다

3. 편집 > 프로젝트 세팅을 열고 플러그인 카테고리에서 TDAnalytics TDRemoteConfig TDStrategy 파라미터를 설정합니다:

   • Server Url: 필수. 수신 측 주소로, https 주소를 사용해야 합니다
   • App ID: 필수. 프로젝트의 APP ID로, AE 백엔드의 프로젝트 관리 페이지에서 확인할 수 있습니다
   • Enable Log: 디버깅 로그 활성화 여부

4. Config 디렉터리의 DefaultEngine.ini 파일에 다음 내용을 추가합니다:

[Analytics]
ProviderModuleName=TDAnalytics

1. C++ 코드에서 직접 사용하려면 프로젝트의 *.Build.cs 파일에 다음 내용을 추가해야 합니다:

PrivateDependencyModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig","TDStrategy" });        
PrivateIncludePathModuleNames.AddRange(new string[] { "TDAnalytics","TDRemoteConfig","TDStrategy" });

3. 초기화

SDK 초기화

#include "TDAnalytics.h"
#include "TDRemoteConfig.h"
#include "TDStrategy.h"
//SDK 초기화
UTDAnalytics::Initialize();    
UTDRemoteConfig::Initialize();    
UTDStrategy::Initialize();

4. 콜백 리스너 설정

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

void OnTriggerResult(FString str){    

}

UTDStrategy::SetTriggerListener(OnTriggerResult);

4.1 콜백 데이터 모델

속성 설명

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