menu
Is this helpful?

# 자동 수집 이벤트 가이드

# 자동 수집 이벤트

TE는 자동 수집 이벤트 API를 제공합니다. 필요에 따라 선택할 수 있습니다.

  • ta_app_install: 게임 설치, 이 이벤트는 설치 후 처음 게임을 시작했을 때 수집됩니다.
  • ta_app_start: 게임이 포어그라운드로 들어갈 때 이 이벤트를 수집합니다.
  • ta_app_end: 게임이 백그라운드로 돌아갈 때 이 이벤트를 수집합니다.
  • ta_app_crash: 게임이 크래시됐을 때 이 이벤트를 수집합니다.

자동 수집은 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"));
EventTypeList.Emplace(TEXT("ta_app_crash"));
UTDAnalytics::EnableAutoTrackWithType(EventTypeList, AppID);

# 커스텀 속성 설정

v1.4.1 버전에서는 자동 수집 이벤트의 커스텀 속성 설정이 지원됩니다. 지정된 이벤트가 수집되면, 커스텀 속성이 이벤트 속성과 합쳐져 전송됩니다.

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

# 자동 수집 이벤트의 콜백 설정

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"));
    EventTypeList.Emplace(TEXT("ta_app_crash"));
    UTDAnalytics::SetAutoTrackEventListener(this, &UTAUserWidget::TAAutoTrackProperties, EventTypeList, AppID);
}

#

← 디버깅 →