다중 인스턴스

최근 업데이트 2026. 08. 27.

initInstance 메서드를 호출하여 하위 인스턴스 객체를 생성할 수 있습니다. 파라미터는 하위 인스턴스 이름입니다. 이후에는 이 이름으로 하위 인스턴스의 인터페이스를 호출할 수 있습니다.

// 이름이 newInstance인 인스턴스 생성
ta.initInstance("newInstance");
// 하위 인스턴스에 distinct_id를 설정하고 test_event 이벤트 전송
ta.newInstance.setDistinctId("new_distinct_id");
ta.newInstance.track("test_event");

기본적으로 하위 인스턴스는 메인 인스턴스와 같은 설정(appId, serverUrl 등)을 사용합니다. 또한 기본적으로 하위 인스턴스는 로컬 캐시를 활성화하지 않습니다.

하위 인스턴스의 파라미터를 별도로 설정해야 하는 경우 초기화 시 설정 정보를 전달할 수 있습니다. 설정 정보에 다른 appId 값을 전달하면 다른 프로젝트로 데이터를 전송할 수 있습니다:

// 하위 인스턴스의 설정 파라미터 정의
var param = {
  appId: "debug-appid",
  serverUrl: "ANOTHER_SERVER_URL",
  persistenceEnabled: true, // 하위 인스턴스의 로컬 캐시 활성화. 하위 인스턴스의 로컬 캐시는 하위 인스턴스 이름 name으로 구분됨
  send_method: "image",
  showLog: true
};

// 하위 인스턴스 초기화
ta.initInstance("anotherInstance", param);

//메인 인스턴스 프로젝트로 데이터 전송
ta.track("Event");

//하위 인스턴스 프로젝트로 데이터 전송
ta.anotherInstance.track("Event");

메인 인스턴스와 하위 인스턴스는 ID 체계와 공통 속성이 서로 공유되지 않으므로 인스턴스마다 유저 ID를 따로 설정할 수 있습니다. 다음 예시는 이 특성을 이용하여 친구 초대 이벤트의 초대한 사람과 초대받은 사람에 대해 각각 초대 성공 이벤트와 초대받음 이벤트를 전송합니다

//메인 인스턴스는 초대받은 신규 유저, 하위 인스턴스는 초대한 사람
ta.login("invitee");
ta.anotherInstance.login("inviter");
//신규 유저가 초대받음 이벤트 트리거
ta.track("be_invited");
//초대한 사람이 신규 유저 초대 이벤트 트리거
ta.anotherInstance.track("invite_new_user");