고급 가이드

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

1. 초기화 파라미터

초기화 시 전달하는 TDSettings 설정에 대한 자세한 설명은 다음과 같습니다:

1.1 TDSettings

속성 이름	타입	설명
appId	NSString	AE 백엔드에서 생성한 프로젝트의 app id
serverUrl	NSString	AE 백엔드에서 생성한 프로젝트의 server url
mode	TDSDKMode	SDK 실행 모드 열거형
enableLog	BOOL	로그 출력 활성화 여부
rccFetchParams	NSDictionary	(TDRemoteConfig 사용) 구성을 가져올 때의 커스텀 요청 파라미터
encryptVersion	NSInteger	(ThinkingSDK 사용) 데이터 암호화 활성화 시 키 버전 번호
encryptKey	NSString	(ThinkingSDK 사용) 데이터 암호화 활성화 시 공개 키 정보
defaultTimeZone	NSTimeZone	(ThinkingSDK 사용) SDK가 시간 서식 지정에 사용하는 시간대
instanceName	NSString	(ThinkingSDK 사용) 수집 SDK 인스턴스의 별칭 설정
enableAutoPush	BOOL	(ThinkingSDK 사용) 푸시 클릭 자동 수집 활성화 여부
enableAutoCalibrated	BOOL	(ThinkingSDK 사용) 자동 시간 보정 활성화 여부

1.2 TDSDKMode

열거형 값	설명
TDSDKModeNomal	데이터를 정상적으로 전송하고 저장합니다.
TDSDKModeDebug	Debug 모드로 수집 데이터를 전송합니다. 디바이스 id를 AE 콘솔의 테스트 디바이스 목록에 추가해야 합니다. AE 콘솔 -> Debug 모드 메뉴 항목에서 실시간으로 수집된 데이터를 확인할 수 있습니다. 전송된 데이터는 AE 시스템에 저장됩니다.
TDSDKModeDebugOnly	DebugOnly 모드로 수집 데이터를 전송합니다. 디바이스 id를 AE 콘솔의 테스트 디바이스 목록에 추가해야 합니다. AE 콘솔 -> Debug 모드 메뉴 항목에서 실시간으로 수집된 데이터를 확인할 수 있습니다. 전송된 데이터는 AE 시스템에 저장되지 않습니다.

2. 가져오기 시점 커스터마이즈

2.1 자동 가져오기

다음 시나리오에서 SDK는 원격 설정 데이터를 자동으로 가져옵니다

• App 콜드 스타트
• App 포그라운드/백그라운드 전환 간격이 6시간을 초과한 경우
• ThinkingSDK 계정 체계가 변경된 경우(예: login, logout)

2.2 수동 가져오기

SDK 메서드를 수동으로 호출하여 언제든지 원격 설정을 가져옵니다

[TDRemoteConfig fetch];

이 API에는 내부적으로 빈도 제한이 있으므로 너무 자주 가져오지 마십시오.

3. 커스텀 Fetch 파라미터

Fetch 파라미터는 클라이언트 SDK가 AE 서버에 값을 요청할 때 사용할 수 있는 파라미터입니다. Fetch 파라미터를 커스텀하여 구성 채널의 환경 파라미터로 추가하면, 전략을 구성할 때 Fetch 파라미터로 대상 환경을 커스텀할 수 있습니다.

3.1 추가

[TDRemoteConfig setCustomFetchParams:@{}];

3.2 삭제

지정한 key에 따라 삭제합니다

[TDRemoteConfig removeCustomFetchParam:@"key"];