push_send¶
Hive 푸시 서버가 푸시 플랫폼(APNs, FCM 등)에 푸시 발송을 요청하고 응답을 받은 시점에 발생하는 이벤트로, 푸시 종류 및 캠페인별 발송 요청 수, 발송 요청 성공률, 실패 사유별 분포 등의 메트릭을 생성하는 데 활용할 수 있습니다.
| 속성명 | 자료형 | 설명 |
|---|---|---|
| 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) |
| serverId | STRING | 이벤트가 발생한 시점에 유저가 접속한 게임 서버를 나타냅니다. 게임에서 전송한 서버 식별자를 기준으로 기록되며, 서버별 유저 수, 매출, 리텐션을 비교하는 데 활용할 수 있습니다. (예: KR, GLOBAL) |
| market | STRING | 이벤트가 발생한 시점에 유저가 게임을 설치한 마켓을 나타냅니다. 앱이 설치되거나 서비스되는 마켓 값을 기준으로 기록되며, 마켓별 지표를 비교하는 데 활용할 수 있습니다. (예: GO(구글 플레이), AP(애플 앱스토어), HS(직접 배포)) |
| os | STRING | 이벤트가 발생한 시점에 유저 단말의 운영체제를 나타냅니다. 클라이언트가 전송한 플랫폼 값을 기준으로 기록되며, OS별 지표를 비교하는 데 활용할 수 있습니다. (예: A(안드로이드), I(iOS)) |
| appVer | STRING | 이벤트가 발생한 시점의 게임 앱 버전을 나타냅니다. 앱 버전 정보를 기준으로 기록되며, os 속성과 함께 사용하여 앱 버전별 이용자를 비교하는 데 활용할 수 있습니다. (예: 4.3.3, 1.6.5) |
| sdkVer | STRING | 이벤트가 발생한 시점의 Hive SDK 버전을 나타냅니다. 클라이언트에 적용된 Hive SDK 버전 값을 기준으로 기록되며, SDK 버전별 데이터 수집 현황을 비교하는 데 활용할 수 있습니다. (예: 4.16.2.2) |
| model | STRING | 이벤트가 발생한 시점에 유저 단말의 모델명을 나타냅니다. 클라이언트가 전송한 단말 모델 값을 기준으로 기록되며, 기기 모델별 지표를 비교하는 데 활용할 수 있습니다. (예: iPhone 12 Pro, SHW-M250S) |
| country | STRING | 이벤트가 발생한 시점에 확인된 유저의 국가를 나타냅니다. ISO 3166-1 alpha-2 대문자 형식으로 기록되며, 국가별 유저 수, 매출, 리텐션 등을 비교하는 데 활용할 수 있습니다. (예: KR, US) |
| lang | STRING | 이벤트가 발생한 시점의 언어 값을 나타냅니다. 게임 또는 단말 언어 값을 기준으로 기록되며(ISO 639 alpha-2 소문자), 언어별 지표를 비교하는 데 활용할 수 있습니다. (예: ko, en) |
| pushSendPlatform | STRING | 푸시 발송에 사용된 리모트 푸시 플랫폼을 나타냅니다. Hive 노티피케이션 서버가 호출한 플랫폼 값을 기준으로 기록되며, 플랫폼별 발송 성공률과 실패 사유를 비교하는 데 활용할 수 있습니다.(예: APNs, FCM, ADM) |
| messageId | STRING | 푸시 발송 시도의 고유 식별자를 나타냅니다. 푸시 서버가 발송 시도마다 발급하는 값을 기준으로 기록되며, 발송과 오픈 이벤트를 연결해 발송 건수, 발송 성공률, 오픈 전환을 분석하는 데 활용할 수 있습니다. |
| pushType | STRING | 푸시의 유형을 나타냅니다. 싱글, 대용량, 타겟팅 구분 값을 기준으로 기록되며, 푸시 종류별 발송, 오픈 지표를 비교하는 데 활용할 수 있습니다. (예: A(싱글), B(대용량), T(타겟팅)) |
| campaignId | STRING | 푸시 캠페인의 고유 ID를 나타냅니다. 캠페인 단위로 발급된 식별자 값을 기준으로 기록되며, 캠페인별 발송, 오픈 지표를 비교하는 데 활용할 수 있습니다. (예: 36851) |
| campaignTimezone | STRING | 푸시 캠페인의 타겟 타임존을 나타냅니다. 푸시 캠페인이 타겟한 타임존 값을 기준으로 기록되며, 타임존별 푸시 지표를 비교하는 데 활용할 수 있습니다. (예: Asia/Seoul) |
| isSendSuccess | STRING | 푸시 플랫폼의 발송 요청 성공 여부를 나타냅니다. 응답 코드 200 여부를 기준으로 기록되며, 발송 요청 성공률을 산출하는 데 활용할 수 있습니다. (예: Y(발송 요청 성공), N(실패), U(응답 미수신)) |
| sendResultCode | INT(INTEGER) | 푸시 플랫폼의 응답 코드를 나타냅니다. 푸시 플랫폼(APNs, FCM, ADM 등)이 반환한 상태 코드 값을 기준으로 기록되며, 푸시 발송 요청 성공, 실패 비율을 산출하는 데 활용할 수 있습니다. (예: 200(발송 요청 성공)) |
| sendFailMessage | STRING | 푸시 발송의 실패 사유를 나타냅니다. 푸시 플랫폼이 반환한 실패 메시지 값을 기준으로 기록되며, 실패 사유별 발송 건수를 분석하는 데 활용할 수 있습니다. |
| sendLatencyMs | INT(INTEGER) | 푸시 플랫폼 호출부터 응답 수신까지 걸린 시간(밀리초)을 나타냅니다. 응답 수신 시각에서 호출 시각을 뺀 값을 기준으로 기록되며, 평균, 최댓값 집계로 발송 지연을 분석하는 데 활용할 수 있습니다. |