> For the complete documentation index, see [llms.txt](https://ditoland-utplus.gitbook.io/ditoland/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ditoland-utplus.gitbook.io/ditoland/manual/collecting-game-logs.md).

# Collecting Game Logs

### 💻 스크립트에서 로그 기록

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

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

```lua
-- 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)
```

```lua
-- 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 형태만 기록할 수 있어요.

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

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

1. 특정 플레이어가 <mark style="color:purple;">**어떤 기기로 월드를 플레이 했는지(value)**</mark> 기록하는 예시에요.

   ```lua
   -- 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     
   ```

2. 특정 플레이어가 <mark style="color:orange;">**어떤 종류의 재화 (index\_1)**</mark> 를, <mark style="color:blue;">**어떤 소비처 (index\_2)**</mark> 에, <mark style="color:purple;">**얼마만큼 소비했는지 (value)**</mark> 를 기록하는 예시에요.

   ```lua
   -- 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 파일로 다운로드** 🔽 할 수 있어요.

<figure><img src="/files/uOikK1NAfQuQ37BHdm2x" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lffYM73FynJLtGbXtKsR" alt=""><figcaption></figcaption></figure>

* **데이터 키 값**

  👉 SaveLog, SaveMyLog 함수에 첫번째 인자로 사용되는 키를 입력해주세요.

  <figure><img src="/files/6uPulsHUNyvStt9EkB1l" alt=""><figcaption></figcaption></figure>

* **플레이어 ID**

  👉 특정 플레이어의 로그 값을 확인하고 싶다면,

  마이디토 > 닉네임 옆에서 확인할 수 있는 **#000000 로 이루어진 숫자** 를 입력해주세요.

  <div align="left"><figure><img src="/files/smdTdE3EHRLbSaGqdjH0" alt="" width="375"><figcaption></figcaption></figure></div>

  👉 전체 플레이어의 로그 값을 확인하고 싶은 경우엔, ‘전체’ 를 체크✅ 하면 돼요.

  <div align="left"><figure><img src="/files/oD33HJaidPlgZBgSlWu9" alt="" width="375"><figcaption></figcaption></figure></div>

* **기간**

  👉 로그가 기록된 기간 중, 조회하고 싶은 기간을 선택해주세요.

📄 CSV 파일에서 다음 데이터를 얻을 수 있어요.

<figure><img src="/files/k662a5nIRRyExgkM38sT" alt=""><figcaption></figcaption></figure>

* 해당 로그가 **기록된 시간** (타임스탬프 & UTC 시간)
* **플레이어** 닉네임 / 플레이어 ID
* 데이터 키 / 1번 인덱스 / 2번 인덱스 / 기록 값

***

### ✍ 기록 데이터 활용

기록된 데이터를 **지표 및 밸런싱에 활용**해보세요.

✅ 특정 플레이어가 **어떤 종류의 재화**를, **어떤 소비처**에, **얼마만큼 소비했는지**를 기록하는 경우,

* 인기가 없는 소비처를 파악해서, 개선이 필요한 부분을 찾거나
* 특정 플레이어에게서 부적절한 소비가 있지는 않았는지 확인해볼 수 있어요.

✅ 접속 시간대, 접속 유지 시간 등 **시간과 관련된 로그**를 기록하고 싶은 경우 **ostime 으로 기록**해보세요.\
기록한 ostime 값은 엑셀에서 다음과 같이 변환하여 확인할 수 있으니 참고해주세요.

1. ostime 기록 값에 아래 함수를 적용해주세요.

   <pre class="language-excel-formula"><code class="lang-excel-formula"><strong>=(((기록값 셀+32400)/60)/60)/24 + DATE(1970,1,1)
   </strong></code></pre>

   <figure><img src="/files/5OaZlq2ofrwdltEqHxha" alt=""><figcaption></figcaption></figure>

2. 함수를 적용한 셀에 다음과 같이 서식을 적용하면, 날짜와 시간을 표시할 수 있어요.

   <figure><img src="/files/juy93PyfezifgOcdJyOB" alt=""><figcaption></figcaption></figure>