게임 플레이 분석 재화 로그
게임별 지표의 게임 플레이 분석 대시보드 중 재화변동 지표에 필요한 로그입니다. 게임 내 재화를 획득 또는 소모하여 변동이 발생한 경우 로그를 전송하여 각 재화별 변화량과 유저별 재화 평균 변화량을 확인 할 수 있고, 일별 재화 변동량 변화와 각 재화의 변동량 높은 순으로 행동 TOP 10을 확인 할 수 있습니다.
로그 전송하기¶
재화 지표를 위한 로그를 전송하기 위해 SDK 클라이언트 로그 전송 방법을 사용합니다.
로그 전송을 위한 샘플 코드는 로그 정의 기능에서 클라이언트 소스 생성 기능을 통해 확인할 수 있습니다.
로그 스펙¶
필드는 카멜케이스(예: serverId) 형태로 구성되어 있으며, 대/소문자를 구분합니다. 그리고, 다음과 같은 경우에는 값이 저장되지 않습니다.
- 아래에 정의된 필드명이 아닌 경우(예: uid)
- 필드명과 정확히 일치하지 않는 필드명일 경우(예: serverid)
- 각 필드에 정의된 타입이 아닌 경우(예: vid에 “474392047”)
주의사항
- STRING: 1MB까지 문자열 데이터
- INTEGER: 부호가 있는 64비트(-9,223,372,036,854,775,808 ~ 9,223,372,036,854,775,807) 데이터
- 각 필드의 타입에 맞지 않는 데이터가 전송되는 경우 해당 필드가 정상적으로 저장되지 않을 수 있기 때문에 반드시 타입에 맞는 값으로 전송해야 합니다.
| 필드명 | 설명 | 타입 | 필수 여부 |
|---|---|---|---|
| playerId | Hive 인증에서 유저를 식별하는 유니크 키 SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | INTEGER | Y |
| appId | 앱센터에서 발급받은 appId SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | STRING | Y |
| guid | 로그 한 행의 고유 키 값 uuid와 같은 랜덤 문자열 형태를 권장 SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | STRING | Y |
| dateTime | “YYYY-MM-DD hh:mm:ss” 포맷의 로그 발생 시간 (예: “2022-11-15 10:20:10”) SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | STRING | Y |
| timezone | dateTime의 타임존 클라이언트 IP를 이용해 타임존 확인 방법을 통해 획득 가능 공백이거나 값이 없는 경우는 KST 기준으로 판단 (예: “GMT+09:00”) SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | STRING | |
| category | 재화 로그의 카테고리 구분 값으로 값은 “pub_asset_log”로 고정 | STRING | Y |
| assetName | 재화 이름(예: “다이아”) 검색 조건으로 사용, 모든 지표 표/그래프의 기준 재화명으로 사용 | STRING | Y |
| actionName | 재화 변동 사유(예: ”인앱 구매”) “행동별 재화 소모”, “행동별 재화 획득” 지표 행동 항목에 사용 | STRING | Y |
| serverId | 서버 아이디 검색 조건으로 사용 SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송 | STRING | |
| userId | 게임 내 유저 고유 아이디 playerId 필드에 값이 0 또는 null 인 경우 유저 식별키로 사용하여 항목 계산 | STRING | |
| amountPrev | 변동 전 재화량 | INTEGER | |
| amountVar | 재화 변동량 * 소모 : 음수로 전송 (예 : -100) * 획득 : 양수로 전송 (예 : 100) 모든 재화변동 지표의 변화량 계산시 사용 | INTEGER | Y |
| amountCurr | 변동 후 재화량 재화 지표 보유량 계산시 사용 | INTEGER | Y |
| contentsModeTypeName | 콘텐츠 이용으로 재화 변동이 발생한 경우 콘텐츠 모드 타입 이름(예: "raid") 각 콘텐츠별 재화 변동량 계산시 사용 | STRING | |
| isPaid | 유료 재화 여부를 나타내는 값 * "Y": 유료 재화 * "N": 무료 재화 | STRING | Y |
전송된 로그 확인하기¶
- 게임 로그를 전송한 후에 로그 정의 기능에서 로그를 확인합니다.
- 재화 로그 정의에서 요구하는 필드에 값이 모두 정상적으로 유입되었다면 지표에 전송 내용이 반영되어 노출됩니다.