자동 수집

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

TDAnalytics SDK는 다음 세 가지 이벤트의 자동 수집을 제공합니다:

• ta_app_install: 게임 설치. 설치 후 게임을 처음 열 때 이 이벤트를 수집합니다
• ta_app_start: 게임이 포그라운드로 전환될 때 이 이벤트를 수집합니다
• ta_app_end: 게임이 백그라운드로 전환될 때 이 이벤트를 수집합니다

enableAutoTrack 인터페이스를 호출하여 자동 수집을 활성화할 수 있습니다:

// 자동 수집 활성화
TDAnalytics::enableAutoTrack();

참고: 게스트 ID를 직접 정의해야 하는 경우 반드시 자동 수집 기능을 활성화하기 전에 setDistinctId 인터페이스를 호출하여 게스트 ID를 설정하십시오.

v1.3.2 버전부터 자동 수집 이벤트에 커스텀 속성을 설정할 수 있습니다. 지정한 이벤트를 수집할 때 커스텀 속성을 해당 이벤트 속성에 병합하여 전송합니다.

// 자동 수집을 활성화하고 커스텀 속성 설정
TDJSONObject autoProperties;
autoProperties.setString("auto_track_key", "auto_track_value");
TDAnalytics::enableAutoTrack(autoProperties);