로그

이해하기

스토브 SDK가 제공하는 로그 기능을 사용하면 게임 내 플레이어의 행동과 주요 이벤트를 수집하고 분석할 수 있어요.
수집된 데이터는 스토브 플랫폼의 분석 시스템으로 전송되며, 게임 운영자는 이를 기반으로 콘텐츠 현황 파악, 이벤트 효과 측정, 이상 지표 감지 등을 수행할 수 있어요.
로그는 모바일(Android/iOS) 과 PC 를 모두 지원하며, 플랫폼에 따라 제공 방식이 다르게 동작해요.

로그 종류

플랫폼별 제공 방식

개발하기

모바일 — 외부 식별자 설정 (setExternalId)

STOVE Mobile SDK는 핵심 로그를 플랫폼 내부에서 자동으로 수집해요. 교차 분석 목적으로 외부에서 관리하는 식별자(예: MMP 이용자 ID)를 로그 이벤트에 포함시킬 수 있도록 Log.setExternalId() 인터페이스를 제공해요. (Log v2.8.2 이상) 호출 이후 발생하는 모든 로그에 외부 식별자가 자동으로 첨부돼요.

사전 준비

• Auth.initialize() 호출 이전에 Log.setExternalId()를 호출해 외부 식별자 설정을 마쳐야 해요. 초기화 이후에 호출하면 일부 초기 로그에 식별자가 포함되지 않아요.
• 외부 식별자 값은 게임/서비스에서 발급·관리해요. SDK는 별도 검증을 하지 않아요.
• 외부 식별자는 SDK 전역에 세팅되며 프로세스 단위로 유지돼요.

개발 흐름

1. 외부 식별자 확보: 게임/서비스에서 발급한 외부 식별자 값을 준비해요. (예: MMP 이용자 ID)
2. Log.setExternalId(externalId) 호출: Auth.initialize()를 호출하기 전에 식별자를 설정해요.
3. 인증 초기화 진행: 이후 Auth.initialize()부터 일반 인증·로그 흐름을 그대로 진행하면, 발생하는 로그에 외부 식별자가 자동으로 포함돼요.

트러블슈팅

샘플 코드

string externalId = "external-id-12345";
Log.SetExternalId(externalId);

PC (PCSDK)

사전 준비

• BaseSDK 초기화(Base_Initialize)가 완료된 후 LogSDK를 초기화(Log_Initialize)해야 로그 전송이 가능해요. BaseSDK 초기화가 끝나기 전에 Log_Initialize()를 호출하면 초기화에 실패해요.
• 게임 루프에서 Base_RunCallback()이 주기적으로 호출돼야 로그 전송의 결과 콜백이 정상 동작해요.
• 정리는 Log_UnInitialize()로 LogSDK를 정리한 뒤 Base_UnInitialize()로 BaseSDK를 정리해요.
• LogSDK가 제공하는 로그 관련 함수는 전송·버전 조회 2개예요. 각각 Log_Send / Log_GetVersion이에요. 이용자 속성·flush·디버그 모드 등은 모바일 SDK 전용이며, PC에서는 게임 측에서 로그 항목에 직접 포함시켜 전송해요.

개발 흐름

1. 초기화: BaseSDK 초기화(Base_Initialize()) 완료 후 LogSDK를 초기화(Log_Initialize())해야 로그를 전송할 수 있어요.
2. 로그 전송: 로그 항목 파라미터(StovePCLogSendParam)에 게임 버전·서버 코드 같은 메타데이터와 추가 데이터(contents JSON 문자열)를 설정해 로그를 전송해요(Log_Send()).
3. 결과 처리: 콜백에서 결과 객체로 성공 여부를 검증해요. 실패 시 에러 코드별로 분기 처리해요.
4. 정리: 게임 종료 직전에 Log_UnInitialize()로 LogSDK를 정리한 뒤 Base_UnInitialize()로 BaseSDK를 정리해요.

트러블슈팅

샘플 코드

// 기존 C/C++ API (~3.4.x)
#include "LogSDK.h"

using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;
using namespace Stove::PCSDK::Log;

// 1) 초기화 (Base_Initialize 완료 이후)
auto initResult = Log_Initialize();
if (!initResult.IsSuccessful())
{
    // 초기화 실패 시 로직을 구현해 주세요.
    return;
}

// 2) 이벤트 로그 전송
StovePCLogSendParam param;
// 모든 필드는 선택 항목이라 게임 특성에 맞춰 필요한 값만 채워요.
param.SetGameVersion(L"1.0.0");
param.SetServerCd(L"Server01");
param.SetContents(L"{\"level\":42,\"class\":\"warrior\"}");

Log_Send(&param, [](CallbackResult callbackResult)
{
    if (callbackResult.GetResult().IsSuccessful())
    {
        // 전송 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직(재시도/로깅 등)을 구현해 주세요.
    }
});

// 3) 종료 시 정리
Log_UnInitialize();
// 이후 Base_UnInitialize 호출

자주 묻는 질문