게임별 지표의 게임 플레이 분석 대시보드 중 콘텐츠 지표에 필요한 로그입니다. 콘텐츠 별 이용 횟수, 성공/취소/완료 비율과 상세 현황 등을 알 수 있습니다.

로그 전송하기

콘텐츠 지표를 위한 로그를 전송하기 위해 Hive 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 인증에서 유저를 식별하는 유니크 키

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 INTEGER Y
appid 앱센터에서 발급받은 appId

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 STRING Y
guid 로그 한 행의 고유 키 값

uuid와 같은 랜덤 문자열 형태를 권장

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 STRING Y
dateTime “YYYY-MM-DD hh:mm:ss” 포맷의 로그 발생 시간

(예: “2022-11-15 10:20:10”)

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 STRING Y
timezone dateTime의 타임존

클라이언트 IP를 이용해 타임존 확인 방법을 통해 획득 가능

공백이거나 값이 없는 경우는 KST 기준으로 판단

(예: “GMT+09:00”)

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 STRING Y
category 콘텐츠 로그의 카테고리 구분 값으로 값은  “pub_contents_log”로 고정 STRING Y
modeTypeName 콘텐츠 모드 타입 이름(예: “raid”)

“콘텐츠 이용수” 또는  “콘텐츠 이용 상세” 지표의 콘텐츠 명으로 사용

 STRING Y
modeTypeId 콘텐츠 모드 타입 ID, 콘텐츠 modeTypeName 필드와 1:1 대응되는 숫자형 ID

  • 20000000 이하 인경우 오름차순으로 “튜토리얼 퍼널” 지표 집계에 사용
  • 20000000 초과 인경우 오름차순으로 “메인 퀘스트 퍼널” 지표 집계에 사용
  INTEGER
contentStatus 콘텐츠 모드 타입 상태로 아래 흐름으로 진행

  • 수락 (-> 대기) -> 실패/완료/취소

설정할 수 있는 값은 아래 5가지 중 택 1

  • “accept” : 수락
  • “wait” : 대기
  • “fail” : 실패
  • “success” : 완료
  • “cancel” : 취소

“콘텐츠 수락 대비 상태 비율” 또는 “ 콘텐츠 이용 상세” 지표에 사용

 STRING Y
serverId 서버 아이디

검색 조건으로 사용

Hive SDK 클라이언트 로그 전송 기능을 사용하는 경우 자동으로 전송

 STRING
userId 게임 내 유저 고유 아이디 STRING
userLevel 게임 내 유저 레벨 또는 그에 준하는 값

검색 조건 또는 “콘텐츠 이용 상세” 지표의 “유저 레벨(평균)” 항목에 사용

 INTEGER
characterLv 캐릭터 레벨

“콘텐츠 이용 상세” 지표의 “캐릭터 레벨(평균)” 항목에 사용

 INTEGER
playTimeSec 각 콘텐츠 모드 타입의 상태 기준 플레이 또는 대기 시간(초)

“콘텐츠 이용 상세”지표의 “플레이 타임(분/평균)” 항목에 사용

 INTEGER
score 플레이 시 획득한 점수 또는 그에 준하는 값

“콘텐츠 이용 상세” 지표의 “점수(평균)” 항목에 사용

 INTEGER

전송된 로그 확인하기

  • 게임 로그를 전송한 후에 로그 정의 기능에서 로그를 확인합니다. 
  • 콘텐츠 로그 정의에서 요구하는 필드에 값이 모두 정상적으로 유입되었다면 지표에 전송 내용이 반영되어 노출됩니다.