product_refund¶
상품 구매가 환불 처리된 시점에 발생하는 이벤트로, 환불 건수, 환불 유저 수, 환불 매출액 등의 메트릭을 생성하는 데 활용할 수 있습니다.
샌드박스를 제공하지 않는 이벤트
환불 데이터는 Hive가 직접 처리하지 않고 마켓(Google Play 등)이 Hive로 전송합니다.
마켓은 샌드박스 환경을 제공하지 않고 상용 환경에서만 Hive로 환불 데이터를 전송하므로, Hive에서는 마켓을 통해 수집된 환불 데이터가 상용 건인지 샌드박스 건인지 구분할 수 없습니다. 이로 인해 샌드박스에서 처리된 환불 데이터가 상용 데이터에 포함되어 표시될 수 있습니다.
| 속성명 | 자료형 | 설명 |
|---|---|---|
| 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) |
| market | STRING | 이벤트가 발생한 시점에 유저가 게임을 설치한 마켓을 나타냅니다. 앱이 설치되거나 서비스되는 마켓 값을 기준으로 기록되며, 마켓별 지표를 비교하는 데 활용할 수 있습니다. (예: GO(구글 플레이), AP(애플 앱스토어), HS(직접 배포)) |
| os | STRING | 이벤트가 발생한 시점에 유저 단말의 운영체제를 나타냅니다. 클라이언트가 전송한 플랫폼 값을 기준으로 기록되며, OS별 지표를 비교하는 데 활용할 수 있습니다. (예: A(안드로이드), I(iOS)) |
| sdkVer | STRING | 이벤트가 발생한 시점의 Hive SDK 버전을 나타냅니다. 클라이언트에 적용된 Hive SDK 버전 값을 기준으로 기록되며, SDK 버전별 데이터 수집 현황을 비교하는 데 활용할 수 있습니다. (예: 4.16.2.2) |
| transactionId | STRING | 결제 건을 식별하는 고유 번호를 나타냅니다. 일반 결제와 환불은 마켓이 발급한 영수증 ID, 구독은 구독 단위로 발급된 식별자 값을 기준으로 기록되며, 중복 제거 개수 집계로 결제 건수를 세거나 구매와 환불·해지 이벤트를 연결하는 데 활용할 수 있습니다. (예: GPA.1234-5678-9101-12345) |
| productId | STRING | 구매된 상품의 ID를 나타냅니다. Hive 빌링에 등록된 고유 상품 ID 값을 기준으로 기록되며, 상품별 매출, 구매 건수를 비교하는 데 활용할 수 있습니다. (예: com.sample.analytics.dia1000) |
| voidedSource | INT(INTEGER) | 구매 취소를 실행한 주체를 나타냅니다. 취소 주체 값을 기준으로 기록되며, 취소 주체별 환불 지표를 비교하는 데 활용할 수 있습니다. (예: 0(유저), 1(개발자), 2(구글)) |
| voidedReason | INT(INTEGER) | 구글 구매 취소의 사유를 나타냅니다. 구글 환불 사유 코드 값을 기준으로 기록되며, 환불 사유별 지표를 비교하는 데 활용할 수 있습니다. (예: 1(구매 후 변심), 4(실수 구매), 5(사기)) |