자동 수집

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

1. 자동 수집 이벤트

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

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

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

// 자동 수집 활성화
UTDAnalytics::EnableAutoTrack();

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

수집을 활성화할 자동 수집 이벤트를 직접 전달할 수도 있습니다:

TArray<FString> EventTypeList;
EventTypeList.Emplace(TEXT("ta_app_install"));
EventTypeList.Emplace(TEXT("ta_app_start"));
EventTypeList.Emplace(TEXT("ta_app_end"));
UTDAnalytics::EnableAutoTrackWithType(EventTypeList, AppID);

2. 커스텀 속성 설정

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

TArray<FString> EventTypeList;
EventTypeList.Emplace(TEXT("ta_app_install"));
EventTypeList.Emplace(TEXT("ta_app_start"));
EventTypeList.Emplace(TEXT("ta_app_end"));
UTDAnalytics::EnableAutoTrackWithTypeAndProperties(EventTypeList, TEXT("{\"autoTrackKey1\":\"autoTrackvalue1\",\"autoTrackKey2\":\"autoTrackvalue2\"}"), AppID);

3. 자동 수집 이벤트 콜백 설정

V1.5.0 버전부터 자동 수집 이벤트에 콜백 메서드를 설정할 수 있습니다. 지정한 이벤트를 수집할 때 이 콜백으로 알리고 현재 이벤트에 포함된 이벤트 속성을 전달합니다. 필요에 따라 데이터를 전달하거나, 새 이벤트 속성을 추가하여 반환할 수 있습니다.

//콜백 정의
FString UTAUserWidget::TAAutoTrackProperties(FString AutoTrackEventType, FString Properties)
{
    //AutoTrackEventType 자동 수집 이벤트 타입
    //Properties 현재 이벤트에 포함된 이벤트 속성
    //처리 로직
    FDateTime TDateTime = FDateTime::Now();
    int64 SecondTimestamp = TDateTime.ToUnixTimestamp();
    int32 MillisecondPart = TDateTime.GetMillisecond();
    FString TimeStr = *FString::Printf(TEXT("%llu"), SecondTimestamp);
    TimeStr += *FString::Printf(TEXT("%lld"), MillisecondPart);
    return "{\"auto_property1_name\":\"" + AutoTrackEventType + "\",\"auto_property2_time\":\"" + TimeStr + "\"}";
}

//콜백 설정
void UTAUserWidget::Call_TA_SetAutoTrackEventListener()
{   
    TArray<FString> EventTypeList;
    EventTypeList.Emplace(TEXT("ta_app_install"));
    EventTypeList.Emplace(TEXT("ta_app_start"));
    EventTypeList.Emplace(TEXT("ta_app_end"));
    UTDAnalytics::SetAutoTrackEventListener(this, &UTAUserWidget::TAAutoTrackProperties, EventTypeList, AppID);
}