mailbox_admin_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) |
| mailId | STRING | 우편의 고유 ID를 나타냅니다. 발송 건마다 발급되는 식별자 값을 기준으로 기록되며, 우편 전송, 오픈, 수령 이벤트를 연결해 퍼널을 구성하는 데 활용할 수 있습니다. |
| mailScheduleId | STRING | 우편이 생성된 예약 또는 반복 발송 정의의 고유 식별자를 나타냅니다. 동일한 스케줄을 기준으로 생성된 우편에 동일한 식별자 값이 기록되며, 반복 발송 건을 묶어 발송 시점별 지표를 비교하는 데 활용할 수 있습니다. |
| mailExpireDateTime | TIMESTAMP | 우편의 만료 일시를 나타냅니다. 우편이 만료되어 더 이상 열람하거나 수령할 수 없게 되는 시각을 기준으로 기록되며, 만료 전 오픈, 수령 전환율과 잔여 기간별 수령 추이를 분석하는 데 활용할 수 있습니다. (예: 2026-09-08 00:00:00) |
| senderType | STRING | 우편 발신자의 유형을 나타냅니다. 발신 주체 구분 값을 기준으로 기록되며, 운영 발송과 시스템 발송의 지표를 나누어 비교하는 데 활용할 수 있습니다. (예: ADMIN, SYSTEM, USER) |
| receiverType | STRING | 우편의 수신 대상 유형을 나타냅니다. 전체 발송인지 수신자를 지정한 발송인지 구분하는 값을 기준으로 기록되며, 발송 방식별 도달, 오픈 지표를 비교하는 데 활용할 수 있습니다. (예: ALL, Player) |
| receiverUserId | STRING | 우편을 수신하는 유저의 식별자를 나타냅니다. 지정된 수신자의 유저 고유 아이디를 기준으로 기록되며, 유저 간 우편의 수신 대상을 확인하는 데 활용할 수 있습니다. |
| receiverCount | INT(INTEGER) | 우편의 발송 대상으로 지정된 수신자 수를 나타냅니다. 발송 시 지정된 수신자 수를 기준으로 기록되며, 발송 규모별 오픈, 수령 전환율을 비교하는 데 활용할 수 있습니다. |
| mailCategory | STRING | 우편함 유형을 나타냅니다. 우편이 분류된 우편함 유형 값을 기준으로 기록되며, 유형별 우편 지표를 비교하는 데 활용할 수 있습니다. (예: DEFAULT) |
| mailContentType | STRING | 우편 본문의 유형을 나타냅니다. 본문만 있는 우편인지 첨부가 포함된 우편인지 구분하는 값을 기준으로 기록되며, 첨부 우편의 수령 전환을 분석하는 데 활용할 수 있습니다. (예: TEXT, ATTACHMENT) |
| attachmentType | STRING | 우편에 첨부된 항목의 유형을 나타냅니다. 게임에서 정의한 첨부 타입 값을 기준으로 기록되며, 재화 종류별 지표를 비교하는 데 활용할 수 있습니다. (예: ITEM, COUPON, CURRENCY) |
| attachmentId | STRING | 우편에 첨부된 항목의 고유 ID를 나타냅니다. 아이템, 쿠폰 등 실제 재화 데이터를 식별하는 ID 값을 기준으로 기록되며, 개별 재화별 현황을 분석하는 데 활용할 수 있습니다. |
| attachmentQuantity | INT(INTEGER) | 우편에 첨부된 항목의 수량을 나타냅니다. 첨부 항목별 수량 값을 기준으로 기록되며, 합계 집계로 재화별 총 수량을 산출하는 데 활용할 수 있습니다. |