mailbox_direct_send¶
유저가 다른 유저에게 우편을 발송한 시점에 발생하는 이벤트로, 유저 간 우편 발송 수, 발송 유저 수, 유저별 발송 빈도 등의 메트릭을 생성하는 데 활용할 수 있습니다.
| 속성명 | 자료형 | 설명 |
|---|---|---|
| dateTime | TIMESTAMP | 이벤트가 발생한 일시를 나타냅니다. 이벤트 발생 시각을 기준으로 기록되며, 기간 단위(일/주/월/시간/분) 집계와 날짜 범위 조회의 기준으로 활용할 수 있습니다. (예: 2023-05-09 19:30:35) |
| eventName | STRING | 이벤트를 구분하는 이름을 나타냅니다. 모든 이벤트가 하나의 원천 로그에 함께 적재되므로 이 값으로 어떤 이벤트인지 식별하며, 이벤트 단위로 데이터를 조회하는 기준으로 활용할 수 있습니다. (예: app_login) |
| userId | STRING | 이벤트를 발생시킨 계정 기준 유저 식별자를 나타냅니다. 게임 내 유저 고유 아이디를 기준으로 기록되며, 중복 제거 개수 집계로 AU 등 고유 유저 수를 세는 데 활용할 수 있습니다. |
| identifierProvider | STRING | 유저 식별자 발급 시스템을 나타내며, "hive"고정되어 들어옵니다. |
| deviceId | STRING | 이벤트를 발생시킨 단말 기준 유저 식별자를 나타냅니다. 앱을 설치할 때마다 단말별로 발급되는 인스턴스 값을 기준으로 기록되며, 중복 제거 개수 집계로 고유 단말 수(약관 동의 수 등)를 세는 데 활용할 수 있습니다. (예: 33333333) |
| appIdGroup | STRING | 이벤트가 발생한 프로젝트를 나타냅니다. Hive 콘솔 앱센터에 등록된 GAMEID 값을 기준으로 기록되며, 여러 프로젝트를 함께 조회할 때 프로젝트별로 지표를 나누어 비교하는 데 활용할 수 있습니다. (예: com.sample.analytics) |
| appId | STRING | 이벤트가 발생한 앱의 고유 ID를 나타냅니다. Hive 콘솔 앱센터에 등록된 APPID를 기준으로 기록되며, 앱별 지표를 구분하는 데 활용할 수 있습니다. (예: com.sample.analytics.google.global.android.common) |
| os | STRING | 이벤트가 발생한 시점에 유저 단말의 운영체제를 나타냅니다. 클라이언트가 전송한 플랫폼 값을 기준으로 기록되며, OS별 지표를 비교하는 데 활용할 수 있습니다. (예: A(안드로이드), I(iOS)) |
| osVer | STRING | 이벤트가 발생한 시점에 유저 단말의 OS 버전을 나타냅니다. 단말의 운영체제 버전 값을 기준으로 기록되며, OS 버전별 지표를 비교하는 데 활용할 수 있습니다. (예: 9.2, 16.3.1) |
| sdkVer | STRING | 이벤트가 발생한 시점의 Hive SDK 버전을 나타냅니다. 클라이언트에 적용된 Hive SDK 버전 값을 기준으로 기록되며, SDK 버전별 데이터 수집 현황을 비교하는 데 활용할 수 있습니다. (예: 4.16.2.2) |
| country | STRING | 이벤트가 발생한 시점에 확인된 유저의 국가를 나타냅니다. ISO 3166-1 alpha-2 대문자 형식으로 기록되며, 국가별 유저 수, 매출, 리텐션 등을 비교하는 데 활용할 수 있습니다. (예: KR, US) |
| lang | STRING | 이벤트가 발생한 시점의 언어 값을 나타냅니다. 게임 또는 단말 언어 값을 기준으로 기록되며(ISO 639 alpha-2 소문자), 언어별 지표를 비교하는 데 활용할 수 있습니다. (예: ko, en) |
| mailId | STRING | 우편의 고유 ID를 나타냅니다. 발송 건마다 발급되는 식별자 값을 기준으로 기록되며, 우편 전송, 오픈, 수령 이벤트를 연결해 퍼널을 구성하는 데 활용할 수 있습니다. |
| mailExpireDateTime | TIMESTAMP | 우편의 만료 일시를 나타냅니다. 우편이 만료되어 더 이상 열람하거나 수령할 수 없게 되는 시각을 기준으로 기록되며, 만료 전 오픈, 수령 전환율과 잔여 기간별 수령 추이를 분석하는 데 활용할 수 있습니다. (예: 2026-09-08 00:00:00) |
| receiverUserId | STRING | 우편을 수신하는 유저의 식별자를 나타냅니다. 지정된 수신자의 유저 고유 아이디를 기준으로 기록되며, 유저 간 우편의 수신 대상을 확인하는 데 활용할 수 있습니다. |
| mailCategory | STRING | 우편함 유형을 나타냅니다. 우편이 분류된 우편함 유형 값을 기준으로 기록되며, 유형별 우편 지표를 비교하는 데 활용할 수 있습니다. (예: DEFAULT) |
| mailContentType | STRING | 우편 본문의 유형을 나타냅니다. 본문만 있는 우편인지 첨부가 포함된 우편인지 구분하는 값을 기준으로 기록되며, 첨부 우편의 수령 전환을 분석하는 데 활용할 수 있습니다. (예: TEXT, ATTACHMENT) |
| attachmentType | STRING | 우편에 첨부된 항목의 유형을 나타냅니다. 게임에서 정의한 첨부 타입 값을 기준으로 기록되며, 재화 종류별 지표를 비교하는 데 활용할 수 있습니다. (예: ITEM, COUPON, CURRENCY) |
| attachmentId | STRING | 우편에 첨부된 항목의 고유 ID를 나타냅니다. 아이템, 쿠폰 등 실제 재화 데이터를 식별하는 ID 값을 기준으로 기록되며, 개별 재화별 현황을 분석하는 데 활용할 수 있습니다. |
| attachmentQuantity | INT(INTEGER) | 우편에 첨부된 항목의 수량을 나타냅니다. 첨부 항목별 수량 값을 기준으로 기록되며, 합계 집계로 재화별 총 수량을 산출하는 데 활용할 수 있습니다. |