promotion_reward¶
프로모션 보상이 지급된 시점에 발생하는 이벤트로, 프로모션 보상 지급 건수, 프로모션별 지급 수 등의 메트릭을 생성하는 데 활용할 수 있습니다.
| 속성명 | 자료형 | 설명 |
|---|---|---|
| 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) |
| country | STRING | 이벤트가 발생한 시점에 확인된 유저의 국가를 나타냅니다. ISO 3166-1 alpha-2 대문자 형식으로 기록되며, 국가별 유저 수, 매출, 리텐션 등을 비교하는 데 활용할 수 있습니다. (예: KR, US) |
| serverId | STRING | 이벤트가 발생한 시점에 유저가 접속한 게임 서버를 나타냅니다. 게임에서 전송한 서버 식별자를 기준으로 기록되며, 서버별 유저 수, 매출, 리텐션을 비교하는 데 활용할 수 있습니다. (예: KR, GLOBAL) |
| market | STRING | 이벤트가 발생한 시점에 유저가 게임을 설치한 마켓을 나타냅니다. 앱이 설치되거나 서비스되는 마켓 값을 기준으로 기록되며, 마켓별 지표를 비교하는 데 활용할 수 있습니다. (예: GO(구글 플레이), AP(애플 앱스토어), HS(직접 배포)) |
| sdkVer | STRING | 이벤트가 발생한 시점의 Hive SDK 버전을 나타냅니다. 클라이언트에 적용된 Hive SDK 버전 값을 기준으로 기록되며, SDK 버전별 데이터 수집 현황을 비교하는 데 활용할 수 있습니다. (예: 4.16.2.2) |
| no | INT(INTEGER) | 고유번호 |
| cpiLogNo | INT(INTEGER) | 프로모션 보상의 CPI 로그 고유 번호를 나타냅니다. cpi_log_v2의 고유 번호(트랜잭션 ID) 값을 기준으로 기록되며, 보상 건 식별에 활용할 수 있습니다. (예: 456060) |
| promotionNo | INT(INTEGER) | 이벤트가 연관된 프로모션 캠페인의 고유 번호를 나타냅니다. 프로모션, 쿠폰 캠페인 고유 번호 값을 기준으로 기록되며, 캠페인별 지표를 비교하는 데 활용할 수 있습니다. (예: 202694) |
| path | STRING | 이벤트의 유입 경로를 나타냅니다. 결제는 과금 모듈(M), Hive IAP(I), 구독(S) 등, 프로모션은 배너, 오퍼월 등 경로 값을 기준으로 기록되며, 경로별 지표를 비교하는 데 활용할 수 있습니다. (예: M, I, banner, offerwall) |
| pubAppIndex | INT(INTEGER) | 프로모션의 광고 매체 앱의 번호를 나타냅니다. 앱센터 appId와 1:1로 매핑되는 숫자형 값(App Index)을 기준으로 기록되며, 매체별 프로모션 지표를 비교하는 데 활용할 수 있습니다. (예: 2624) |
| advAppIndex | INT(INTEGER) | 프로모션의 광고주 앱의 번호를 나타냅니다. 앱센터 appId와 1:1로 매핑되는 숫자형 값(App Index)을 기준으로 기록되며, 앱광고주별 프로모션 지표를 비교하는 데 활용할 수 있습니다. (예: 5020) |
| rewardProperty | STRING | 프로모션 보상의 보상 주체를 나타냅니다. 게시자(pub), 광고자(adv) 구분 값을 기준으로 기록되며, 보상 주체별 지표를 비교하는 데 활용할 수 있습니다. (예: pub, adv) |
| type | STRING | 프로모션의 캠페인 타입 또는 친구 초대 타입을 나타냅니다. 캠페인, 초대 타입 값을 기준으로 기록되며, 타입별 프로모션 지표를 비교하는 데 활용할 수 있습니다. (예: offerwall) |
| uaCode | INT(INTEGER) | 프로모션의 친구 초대 코드를 나타냅니다. 친구 초대 코드 값을 기준으로 기록되며, 초대 코드별 유입 지표를 비교하는 데 활용할 수 있습니다. (예: 0) |
| rewardItem | STRING | 프로모션 보상으로 지급된 아이템을 나타냅니다. 지급된 보상 아이템 정보(JSON) 값을 기준으로 기록되며, 상세 분석의 보조 정보로 활용할 수 있습니다. (예: {"[6,1]":24}) |
| rewardResult | STRING | 프로모션 보상의 지급 결과를 나타냅니다. 보상 지급 결과 값을 기준으로 기록되며, 상세 분석의 보조 정보로 활용할 수 있습니다. |
| language | STRING | 프로모션 발생 시점의 언어를 나타냅니다. 유저 언어 값을 기준으로 기록되며(소문자), 언어별 프로모션 지표를 비교하는 데 활용할 수 있습니다. (예: ko, zh-hant) |
| typeCamp | STRING | 프로모션의 캠페인 타입을 나타냅니다. Hive 프로모션 정보에 등록된 프로모션 타입 값을 기준으로 기록되며(소문자, UA 캠페인은 ua), 캠페인 타입별 성과를 비교하는 데 활용할 수 있습니다. (예: notice, ua) |
| typeBanner | STRING | 프로모션의 배너 타입을 나타냅니다. Hive 프로모션 정보에 등록된 배너 타입 값을 기준으로 기록되며(소문자, UA 캠페인은 null), 배너 타입별 성과를 비교하는 데 활용할 수 있습니다. (예: great) |
| additionalInfo | STRING | 프로모션 로그의 추가 정보를 나타냅니다. 프로모션 로그에 함께 전송되는 JSON 형식의 부가 정보 값을 기준으로 기록되며, 상세 분석의 보조 정보로 활용할 수 있습니다. (예: {"server":1}) |