Collecting Game Logs

스크립트에서 로그를 기록하여, 월드에 접속한 플레이어들의 행동 데이터를 수집할 수 있는 기능이에요.

💻 스크립트에서 로그 기록

ServerScript 에서는 SaveLog 함수를, ClientScript 에서는 SaveMyLog 함수를 사용해서 로그를 기록할 수 있어요.

해당 함수가 호출된 시점의 시간, 해당 플레이어 정보, 인덱스 및 값이 기록돼요.

-- ServerScript
local function SaveLogData(player, value) 
    local playerID = player:GetPlayerID() 
		
    local dataKey = "Gold"  -- 기록할 로그의 데이터 키에요.
    local index_1 = 1       -- 기록할 로그의 1번 인덱스에요. 데이터 키의 하위 정보를 기록하고 싶다면 사용하고, 생략할 수도 있어요.
    local index_2 = 1000    -- 기록할 로그의 2번 인덱스에요. 데이터 키의 하위 정보를 기록하고 싶다면 사용하고, 생략할 수도 있어요.       
    
    Game:SaveLog(dataKey, playerID, value)
    Game:SaveLog(dataKey, index_1, playerID, value)
    Game:SaveLog(dataKey, index_1, index_2, playerID, value)
end     
Game:ConnectEventFunction("SaveLogData", SaveLogData)

-- ClientScript
local function SaveLogData(value) 	  
    local dataKey = "Gold"  -- 기록할 로그의 데이터 키에요.
    local index_1 = 1       -- 기록할 로그의 1번 인덱스에요. 데이터 키의 하위 정보를 기록하고 싶다면 사용하고, 생략할 수도 있어요.
    local index_2 = 1000    -- 기록할 로그의 2번 인덱스에요. 데이터 키의 하위 정보를 기록하고 싶다면 사용하고, 생략할 수도 있어요.        
    
    Game:SaveMyLog(dataKey, value)
    Game:SaveMyLog(dataKey, index_1, value)
    Game:SaveMyLog(dataKey, index_1, index_2, value)
end

📌 로그의 1번 인덱스, 2번 인덱스, 값 은 number 형태만 기록할 수 있어요.

Game:SaveLog(dataKey, **index_1**, **index_2**, playerID, **value**)

아래 로그 기록 예시들을 참고해주세요.

특정 플레이어가 어떤 기기로 월드를 플레이 했는지(value) 기록하는 예시에요.

-- ClientScript
local function SaveLogData(value) 	 
    -- 기록할 로그의 데이터 키에요. 
    local dataKey = "ExperienceDevice"
		
    -- 모바일 / PC 여부를 number 형태로 변환해서 기록해요.
    local isMobileDevice = Input:IsMobileTouchScreen() --Bool
    local value = -1     
    if     isMobileDevice then value = 0
    else                       value = 1
    end
		
    Game:SaveMyLog(dataKey, value)
end

특정 플레이어가 어떤 종류의 재화 (index_1) 를, 어떤 소비처 (index_2) 에, 얼마만큼 소비했는지 (value) 를 기록하는 예시에요.

-- ServerScript
local function SaveLogData(player, assetType, usedPlace, value) 
    local playerID = player:GetPlayerID() 
		
    -- 기록할 로그의 데이터 키에요.
    local dataKey = "PlayerAccount"                   
		
    -- 소비한 재화 종류를 number 형태로 변환해서, 1번 인덱스에 기록해요.
    local index_1 = -1     
    if     assetType == "FreeAsset" then index_1 = 1
    elseif assetType == "PaidAsset" then index_1 = 2
    elseif assetType == "SubAsset"  then index_1 = 3
    end
		
    -- 소비처 종류를 number 형태로 변환해서, 2번 인덱스에 기록해요.
    local index_2 = -1     
    if     usedPlace == "SkinShop"   then index_2 = 1
    elseif usedPlace == "WeaponShop" then index_2 = 2
    elseif usedPlace == "Gacha"      then index_2 = 3
    end               
		
    Game:SaveLog(dataKey, index_1, index_2, playerID, value)
end     
Game:ConnectEventFunction("SaveLogData", SaveLogData)

📥 기록된 로그 데이터 다운로드

기록된 로그 데이터는, 월드 설정 페이지 > 로그 데이터 관리 페이지에서 CSV 파일로 다운로드 🔽 할 수 있어요.

조회할 데이터를 입력 후, [CSV로 추출하기] 버튼을 눌러주세요.

데이터 키 값
👉 SaveLog, SaveMyLog 함수에 첫번째 인자로 사용되는 키를 입력해주세요.
플레이어 ID
👉 특정 플레이어의 로그 값을 확인하고 싶다면,
마이디토 > 닉네임 옆에서 확인할 수 있는 #000000 로 이루어진 숫자 를 입력해주세요.
👉 전체 플레이어의 로그 값을 확인하고 싶은 경우엔, ‘전체’ 를 체크✅ 하면 돼요.
기간
👉 로그가 기록된 기간 중, 조회하고 싶은 기간을 선택해주세요.