고급 가이드
1. 초기화 파라미터
초기화 시 전달하는 파라미터 설정에 대한 자세한 설명은 다음과 같습니다
| 속성 이름 | 타입 | 설명 |
|---|---|---|
| appId | String | AE 백엔드에서 생성한 프로젝트의 app id |
| serverUrl | String | AE 백엔드에서 생성한 프로젝트의 server url |
| mode | String | SDK 실행 모드(none, debug, debugOnly) |
| enableLog | Boolean | 로그 출력 활성화 여부 |
| zoneOffset | Number | SDK 기본 시간대 |
| autoTrack | object | 자동 수집 관련 설정 |
| triggerListener | function | 트리거 결과 알림 |
2. 클라이언트 파라미터 설정
클라이언트 트리거 작업을 생성할 때 클라이언트 조건을 입력할 수 있습니다. 설정 방법은 클라이언트 트리거 작업 생성을 참고하십시오.
클라이언트 조건에서 사용할 수 있는 파라미터는 클라이언트가 자동 수집하는 환경 파라미터와 TDStrategy SDK로 설정한 클라이언트 파라미터입니다. TDStrategy SDK가 제공하는 인터페이스로 커스텀 클라이언트 파라미터를 SET한 후, 해당 커스텀 클라이언트 파라미터를 AE 백엔드에 추가하여 운영 작업에서 사용할 수 있습니다.
주의: 클라이언트에서 SET한 파라미터의 이름과 타입은 AE 운영 백엔드에 설정한 클라이언트 파라미터와 일치해야 합니다.
클라이언트 파라미터를 설정하는 방법은 다음과 같습니다:
// 클라이언트 파라미터 설정(여러 번 설정하면 합집합으로 처리됨)
TDStrategy.addClientParams({
"key":"value"
});
3. 가져오기 시점 커스터마이즈
3.1 자동 가져오기
다음 시나리오에서 SDK는 원격 설정 데이터를 자동으로 가져옵니다
- 콜드 스타트
- ThinkingSDK 계정 체계가 변경된 경우(예: login, logout)
3.2 수동 가져오기
SDK 메서드를 수동으로 호출하여 언제든지 원격 설정을 가져옵니다
TDStrategy.fetch();
이 API에는 내부적으로 빈도 제한이 있으므로 너무 자주 가져오지 마십시오.
4. 도달 퍼널 이벤트
클라이언트 트리거 채널을 생성할 때 도달 퍼널 설정을 활성화할 수 있습니다. 설정 방법은 채널 설정을 참고하십시오.
도달 퍼널을 활성화하면 퍼널 단계와 연결할 메타 이벤트 이름을 설정할 수 있습니다. 이렇게 하면 해당 채널을 사용하는 운영 작업의 데이터 상세 페이지에서 설정한 단계의 전환 데이터를 확인할 수 있습니다.
실제 도달, 푸시 클릭으로 선택한 이벤트는 다음 요구 사항을 충족해야 합니다.
- 이벤트에는 운영 전용 파라미터가 포함되어야 합니다. 이 파라미터는 푸시 콘텐츠 TDStrategyResult 객체의 opsProperties 속성으로 가져올 수 있으며, 구체적인 전송 방법은 다음과 같습니다.
TDApp.init({
appId: "AppId",
serverUrl:"ServerUrl",
enableLog:true,
triggerListener:function(result){
TDAnalytics.track("ops_click", result.opsProperties);
}
});
5. 테스트 발송
채널의 사용 가능 여부와 작업의 유효성을 빠르게 검증할 수 있도록 SDK는 테스트 모드를 지원합니다.
TDApp.init({
appId: "AppId",
serverUrl:"ServerUrl",
enableLog:true,
mode: "debug",//테스트 모드 설정
triggerListener:function(result){
}
});
클라이언트에서 debug 모드를 활성화하면 5s마다 테스트 작업을 가져옵니다. AE 운영 모듈에서 채널 테스트 또는 작업 테스트를 생성할 수 있으며, 작업이 트리거를 기다리는 동안 프런트엔드 페이지의 진행 노드를 확인할 수 있습니다.
클라이언트 트리거 테스트 발송에는 테스트 디바이스가 필요합니다. 테스트 디바이스 목록에서 테스트 디바이스를 선택하거나 추가할 수 있습니다