Flutter

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

최신 버전: v1.0.0

업데이트 시간: 2025-12-08

1. 개요

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

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

2. 통합

Flutter 프로젝트의 pubspec.yaml 파일에 다음 의존성을 추가합니다:

dependencies:
  thinking_analytics: ^3.3.1
  td_remote_config: ^1.0.0
  td_strategy: ^1.0.0

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

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

3. 초기화

import 'package:thinking_analytics/td_analytics.dart';
import 'package:td_remote_config/remote_config.dart';
import 'package:td_strategy/strategy.dart';

TDAnalytics.init("appId", "serverUrl");

TDRemoteConfig.init("appId", "serverUrl");

//첫 번째 방법
TDStrategy.init("appId", "serverUrl");
//두 번째 방법
TDStrategySettings strategySettings = TDStrategySettings();
strategySettings.appId = "appId";
strategySettings.serverUrl = "serverUrl";
TDStrategy.initWithConfig(strategySettings);

4. 콜백 리스너 설정

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

TDStrategy.setTriggerListener((tdStrategyResult) {

});

4.1 콜백 데이터 모델

tdStrategyResult의 타입은 Map<String, dynamic>이며, 속성 설명은 다음과 같습니다.

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