엔진 공통

Hive SDK 애널리틱스 기능을 사용하기 위한 엔진 공통 설정을 안내합니다.

Hive 콘솔 설정¶

Hive SDK 애널리틱스는 로그 전송, 코호트 분석 등 다양한 기능을 제공합니다. Hive SDK 애널리틱스를 사용하려면, 먼저 애널리틱스 콘솔 가이드를 따라 Hive 콘솔 설정을 진행해야 합니다.

hive_config.xml 설정¶

애널리틱스 기능을 사용할 때 필요한 hive_config.xml 설정입니다. 아래는 모든 설정을 사용할 경우를 가정한 예시 코드입니다.

<properties>
    <!-- Hive SDK 공통 설정 생략 -->

    <!-- Hive SDK 애널리틱스 설정: START -->
    <maxGameLogSize>50</maxGameLogSize>
    <saveAnalyticsLogBeforeCrash>false</saveAnalyticsLogBeforeCrash>
    <analyticsSendLimit>5</analyticsSendLimit>
    <analyticsQueueLimit>50</analyticsQueueLimit>
    <analyticsSendCycle>1</analyticsSendCycle>
    <!-- Hive SDK 애널리틱스 설정: END -->

</properties>

maxGameLogSize¶

비정형 데이터 파일로 저장하는 게임 로그의 최대 저장 개수입니다. 기본값은 50이며 hive_config.xml에 이 값을 정의하지 않는다면 기본값으로 동작합니다. 특수한 상황(네크워크 지연 또는 단절이 자주 발생하여 로그 수집이 정상적이지 않다고 확인한 경우 등)이 아닌 이상 이 값을 변경하지 마십시오. Hive 애널리틱스 서버에서 이 값을 수집하며, Configuration 클래스를 사용해 런타임에 변경할 수도 있습니다.

Info

수집한 값을 확인하려면 다음을 참고하세요.

Android, iOS, Windows

<properties>
    <maxGameLogSize>50</maxGameLogSize>
</properties>

saveAnalyticsLogBeforeCrash (iOS)¶

앱이 강제 종료되기 직전 상황을 감지해, 아직 서버에 전송되지 않고 전송 대기 중인 애널리틱스 로그를 파일로 저장할지 여부입니다. 외부 서드 파티 크래시 리포터를 이용할 경우 충돌 방지를 위해 false를 입력해 비활성화해야 합니다. 기본값은 false이며 hive_config.xml에 이 값을 정의하지 않는다면 기본값으로 동작합니다.

iOS

<properties>
    <saveAnalyticsLogBeforeCrash>false</saveAnalyticsLogBeforeCrash>
</properties>

analyticsSendLimit¶

애널리틱스 로그 전송 주기마다 전송할 애널리틱스 로그 최대치입니다. 기본값은 5이며 hive_config.xml에 이 값을 정의하지 않는다면 기본값으로 동작합니다. Configuration 클래스로 런타임에 변경할 수도 있습니다.

Info

Hive SDK 애널리틱스는 애널리틱스 로그 내부에 게임 로그를 첨부해 함께 전송합니다. 개발사는 애널리틱스 로그를 확인해 게임에서 전송한 비정형 데이터를 확인할 수 있습니다.

Android, iOS, Windows

<properties>
    <analyticsSendLimit>5</analyticsSendLimit>
</properties>

analyticsQueueLimit¶

Hive 애널리틱스 서버에 쌓을 수 있는 애널리틱스 로그 최대치입니다. Queue에 로그 데이터(텍스트) 구조체를 모아서 전달합니다. 기본값은 50이며 이는 한 번에 로그 데이터 구조체를 50개씩 전달한다는 의미입니다. hive_config.xml에 이 값을 정의하지 않는다면 기본값으로 동작합니다. Configuration 클래스를 통해 런타임에 변경할 수도 있습니다.

Android, iOS, Windows

<properties>
    <analyticsQueueLimit>50</analyticsQueueLimit>
</properties>

analyticsSendCycle¶

애널리틱스 로그 전송 주기입니다. 초 단위로 설정 가능하며 설정한 주기마다 애널리틱스 로그를 전송합니다. 기본값은 1초이며 hive_config.xml에 이 값을 정의하지 않는다면 기본값으로 동작합니다. Configuration 클래스를 통해 런타임에 변경할 수도 있습니다.

Android, iOS, Windows

<properties>
    <analyticsSendCycle>1</analyticsSendCycle>
</properties>