본문으로 건너뛰기

고급 가이드

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

1. 초기화 파라미터​

Cocos Creator는 TDRemoteConfig.init으로 설정을 전달합니다. Web / 미니 게임은 JS 채널을 사용하며, Android / iOS / HarmonyOS 네이티브 패키지는 파라미터를 네이티브 TDRemoteConfig로 브리징합니다.

1.1 설정 항목​

속성 이름타입설명
appIdStringAE 백엔드에서 생성한 프로젝트의 app id, 필수
serverUrlStringAE 백엔드에서 생성한 프로젝트의 server url, 필수
debugModeStringSDK 실행 모드, 1.2 참고. 네이티브 채널은 'debug'만 인식
enableLogBoolean로그 출력 활성화 여부. 로그만 제어하며 테스트 모드로 전환하지 않음
templateCodeString템플릿 코드, 선택
customFetchParamsObject초기화 시 전달하는 커스텀 Fetch 파라미터, 선택
TDRemoteConfig.init({
  appId: 'YOUR-APP-ID',
  serverUrl: 'https://your-server-url',
  enableLog: true,
  debugMode: 'debug',
  customFetchParams: { channel: 'cocos' }
});

1.2 SDK 실행 모드​

값설명
미전달 / 기타 값일반 모드. 라이브 전략에 따라 구성을 가져오며 데이터가 저장됩니다.
debug테스트 모드. 디바이스를 AE 콘솔의 테스트 디바이스 목록에 추가해야 합니다. 클라이언트가 짧은 간격으로 테스트 전략을 가져오므로 AE 운영 모듈에서 템플릿 테스트 또는 전략 테스트를 검증하기 쉽습니다.
debugOnlyWeb / 미니 게임 JS 채널에서만 지원합니다. 네이티브 Android / iOS / HarmonyOS는 이 값을 인식하지 않으며 일반 모드와 동일하게 동작합니다.

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

2.1 자동 가져오기​

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

Web / 미니 게임(JS 채널)

  • SDK 초기화 성공 후
  • 앱이 포그라운드/백그라운드로 전환되고 마지막 가져오기로부터 6시간이 지난 경우
  • TDAnalytics SDK 계정 체계가 변경된 경우(예: login, logout)

Android / iOS / HarmonyOS(네이티브 채널)

초기화 후 네이티브 TDRemoteConfig가 자동으로 가져오며, App 라이프사이클과 계정 변경을 따릅니다. 계정 변경이 구성 가져오기에 반영되도록 분석 SDK를 먼저 초기화한 후 구성 센터를 초기화하십시오.

2.2 수동 가져오기​

SDK 메서드를 수동으로 호출하여 언제든지 원격 구성을 가져옵니다. 네이티브 채널에서는 TDRemoteConfigProxyApi로 전달됩니다.

TDRemoteConfig.fetch();
// 다중 인스턴스인 경우 appId / templateCode를 지정할 수 있습니다
TDRemoteConfig.fetch(appId, templateCode);

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

3. 커스텀 Fetch 파라미터​

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

3.1 추가​

TDRemoteConfig.setCustomFetchParams({
  demo_param: 'from_demo'
}, appId);

3.2 삭제​

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

TDRemoteConfig.removeCustomFetchParam('demo_param', appId);

4. Client Params​

v1.3.1부터 Cocos Creator는 Client Params를 지원합니다. Fetch 파라미터와 마찬가지로 클라이언트 파라미터도 원격 전략 매칭에 사용할 수 있습니다. 차이점은 파라미터가 클라이언트 로컬에 저장되고 SDK가 요청 시 함께 전달한다는 것입니다. Android / iOS / HarmonyOS 네이티브 브리지에도 동일하게 반영되었습니다.

TDRemoteConfig.addClientParams({
  client_tag: 'demo',
  client_count: 1
});
TDRemoteConfig.removeClientParam('client_tag');
TDRemoteConfig.accumulateNum('client_count', 1);
const tag = TDRemoteConfig.getClientParamValueForKey('client_tag');
const all = TDRemoteConfig.getClientParams();
이 문서가 도움이 되었나요?
이 페이지의 내용