Flurry Analytics 게임플레이 이벤트 분석 툴

개요

Flurry (플러리)는 iOS 용 써드 파티 분석 제공 툴로, 그 API 와 서비스 모두 무료입니다. 새로운 게임플레이 이벤트 추가와 그 내용을 Flurry 에 쉽게 업로드할 수 있도록 UE3 통합은 제공하고는 있으나, 실제 SDK 를 제공하고 있지는 않습니다. 필요한 툴을 다운받기 위해 필요한 계정 셋업 관련 자세한 정보는 http://www.flurry.com/ 페이지를 방문해 주시기 바랍니다.

Flurry 사용을 위한 셋업

Flurry 계정

Flurry 를 사용하기 위해서는 먼저 http://www.flurry.com/ 해당 웹사이트를 통해 계정을 생성해야 합니다. 생성하고 나면 SDK 를 다운받아 자신의 게임에 대한 고유 앱 항목을 추가시킬 수 있습니다. 다른 사람에게 이메일 초대를 보내 비관리자 계정을 새로 생성하여 그 통계를 접할 수 있도록 하는 것도 가능합니다.

주: 개발 도중에는 개발자 전용 앱을 만들어 테스트용 임시 게임플레이 이벤트를 생성하는 것도 일반적으로 좋은 방법입니다. 발매 준미가 되면 프로덕션 환경의 게임에서만 사용되는 릴리즈 전용 앱을 만들면 됩니다.

UE3 환경설정

UE3 에서의 환경설정은 비교적 간단하며 약간의 ini 값만으로 가능합니다. 자기 게임의 IPhoneEngine.ini 에 다음과 같이 추가해 주면 됩니다:

다음은 엔진 내 분석 제공자로써 FlurryAnalyticsIPhone 을 인스턴싱하기 위한 클래스 이름입니다.

[PlatformInterface]
AnalyticEventsInterfaceClassName=IPhoneDrv.FlurryAnalyticsIPhone

Flurry 환경설정을 위한 설정 부분입니다. 먼저 어플리케이션의 API 키를 추가해 줘야 합니다. "ApiKeyDev" 와 "ApiKeyRelease" 둘 다 있다는 점 유념하시구요. 릴리즈 버전은 iOS 게임이 프로덕션 빌드될 때 자동 사용됩니다. 앱의 API 키는 Flurry 웹사이트에서 SDK 다운로드시 받았을 것입니다.

[IPhoneDrv.FlurryAnalyticsIPhone]
ApiKeyDev="개발자 전용 키"
ApiKeyRelease="프로덕션 키"

다른 환경설정 값은:

* bUseSecureTransport - 데이터를 SSL 전송하도록 설정합니다. (기본값 FALSE) * bEnableDebugLogs - Flurry 기술지원용 디버그 로그를 생성합니다. (기본값 FALSE) * bShowErrorLogs - 모든 에러 정보 로그를 출력합니다. (기본값 FALSE) * bEnableEventLogs - 모든 이벤트 정보 로그를 출력합니다. (기본값 FALSE) * bReportOnClose - 앱 종료시 세션 리포트를 업로드합니다. (기본값 TRUE) * bReportOnPause - 앱 대기시 세션 리포트를 업로드합니다. (기본값 FALSE)

게임플레이 이벤트 추가하기

Flurry 이벤트는 문자열로만 표현됩니다. 한 번에 허용되는 고유 이벤트와 이벤트 파라미터 수에도 제한이 약간 있습니다. 이러한 제약에 대한 자세한 정보는 Flurry 웹사이트를 참고해 주시기 바랍니다.

기존 게임 통계 시스템 사용하기

게임플레이 이벤트 캡처와 재생에 UE3 게임 통계 시스템을 사용하는 법에 대한 정보는 게임 통계 수집하기 문서를 참고해 주시기 바랍니다. GameplayEventsUploadAnalytics.uc 서브클래스를 자체적으로 만들어 같은 이벤트를 Flurry 에 업로드시킬 수도 있습니다. 이를 통해 추가시키는 게임플레이 이벤트를 GameplayEventsWriter.uc 에서처럼 디스크 캐시에 담기보다는 바로 업로드시킬 수 있습니다.

날 Flurry 이벤트 사용

다른 옵션으로는 내장된 게임 통계 시스템을 사용하지 않고 날 이벤트를 직접 작성하는 Analytics 인터페이스를 사용하는 것입니다.

(Flurry 인스턴스에 의해 구현된) Analytics 인터페이스 싱글톤을 먼저 잡아와야 합니다:

local AnalyticEventsBase Analytics;
Analytics = class'PlatformInterfaceBase'.static.GetAnalyticEventsInterface();

그런 다음 커스텀 이벤트 녹화 시작을 위한 Analytics 세션을 시작합니다:

Analytics.StartSession();

파라미터 없는 단순한 문자열 이벤트를 추가한 예입니다:

Analytics.LogStringEvent("Event without parameters",false);

문자열 파라미터 세트가 있는 문자열 이벤트 추가 예입니다:

local array<EventStringParam> Params;

Params.Add(1);
Params[Params.Length-1].ParamName = "Param Name 1";
Params[Params.Length-1].ParamValue = "Param Name 1";

Params.Add(1);
Params[Params.Length-1].ParamName = "Param Name 2";
Params[Params.Length-1].ParamValue = "Param Value 2";

Analytics.LogStringEventParamArray("Event with parameters",Params,false);