로그 데이터 이관 안내¶
게임 출시 이후 누적된 전체 기간의 로그 데이터가 텍소노미(Taxonomy) 기반 이벤트로 매핑되어 이관됩니다. 아래 기존 로그에서 필터 조건으로 가공된 이벤트명을 참고해 주시길 바랍니다. 이관 작업과 관련하여 별도로 진행하셔야 하는 작업은 없으며, 추가 문의 사항이 있으신 경우 기술지원(tam@com2us.com)으로 연락 주시기 바랍니다.
기본 로그 → 이벤트 데이터¶
| 기존 로그 테이블 | 기존 로그 테이블 설명 | 필터 조건 | 신규 이벤트명 | 신규 이벤트 설명 |
|---|---|---|---|---|
t_hive_purchase_fail_log | 소모성 상품(아이템) 구매 후 아이템 지급에 실패한 정보를 저장하는 테이블 | - | hive_usable_product_fail | 상품 구매가 실패한 시점에 발생하는 이벤트 |
t_hive_promotion_open_log | Hive 프로모션 기능을 사용 시 수집 되는 프로모션 오픈 로그 | - | hive_promotion_open | 프로모션이 유저 화면에 노출된 시점에 발생하는 이벤트 |
t_hive_promotion_click_log | Hive 프로모션 기능을 사용 시 수집되는 프로모션 클릭 로그 | - | hive_promotion_click | 프로모션을 클릭한 시점에 발생하는 이벤트 |
t_hive_purchase_item_send_log | 소모성 상품(아이템) 구매 후 유저에게 아이템을 정상적으로 지급한 정보를 저장하는 테이블 | - | hive_usable_product_grant | 결제 완료 후 아이템이 지급된 시점에 발생하는 이벤트 |
t_hive_concurrent_user_log | Hive SDK가 적용된 클라이언트의 접속 정보를 2분 단위로 전송 받아 저장하는 테이블 ※ Hive 콘솔에서 '네트워크 통신 최소화'옵션 활성화시 수집 되지 않습니다. | - | hive_session_maintain | 로그인 이후 2분 간격으로 접속상태가 전송되는 이벤트 |
t_hive_unionauth_disconnect_log | Hive 인증 기능을 통해 연동된 IdP(외부 계정) 연동을 해제한 정보를 저장하는 테이블 | - | hive_unionauth_disconnect | 통합인증 연동이 해지된 시점에 발생하는 이벤트 |
t_hive_coupon_use_log | Hive 쿠폰 기능을 통해 유저가 쿠폰 코드를 입력하고 사용(보상 수령)한 정보를 저장하는 테이블 | - | hive_coupon_use | 쿠폰을 사용한 시점에 발생하는 이벤트 |
t_hive_pre_event_regist_log | 게임 사전예약 이벤트에 유저가 참여(등록)한 정보를 저장하는 테이블 | - | hive_pre_event_register | 사전 예약 이벤트에 신청한 시점에 발생하는 이벤트 |
t_hive_promotion_reward_v2_log | Hive 프로모션 기능을 통해 유저에게 보상을 지급한 정보를 저장하는 테이블 | - | hive_promotion_reward | 프로모션 보상이 지급된 시점에 발생하는 이벤트 |
t_hive_purchase_refund_log | 소모성 상품 구매 취소 정보를 저장하는 테이블 | - | hive_product_refund | 상품 구매가 환불 처리된 시점에 발생하는 이벤트 |
t_hive_webshop_access_log | Hive 웹 상점(웹샵) 기능을 사용 시 유저가 웹 상점에 접속한 정보를 저장하는 테이블 | - | hive_webstore_access | 웹 스토어 페이지에 접근한 시점에 발생하는 이벤트 |
t_hive_remoteplay_ccu_user | Hive 리모트 플레이 기능을 통해 유저가 리모트 플레이에 접속(connect) 또는 로그인(login)한 동시접속 정보를 저장하는 테이블 | - | hive_remote_play_connect | 리모트 플레이에서 호스트 PC 연결에 성공한 시점에 발생하는 이벤트 |
| - | hive_remote_play_login | 리모트 플레이에서 Hive 로그인에 성공한 시점에 발생하는 이벤트 | ||
t_hive_push_open_log | Hive 노티피케이션 기능을 사용 시 유저가 푸시 알림을 오픈한 정보를 저장하는 테이블 | - | hive_push_open | 푸시 알림을 탭하여 앱에 진입한 시점에 발생하는 이벤트 |
t_hive_promotion_install_log | Hive 프로모션 기능을 사용 시 수집 되는 프로모션 설치 로그 | - | hive_promotion_install | 프로모션을 통해 앱이 설치된 시점에 발생하는 이벤트 |
t_hive_did_log | 유저의 디바이스 식별자(DID)가 변경된 정보를 저장하는 테이블 | - | hive_device_change | 디바이스 관련 정보(앱 버전, 광고 ID, 단말 기기 모델, 루팅/탈옥 여부) 변경이 감지된 시점에 발생하는 이벤트 |
t_hive_logout_log | Hive 인증 기능을 통해 로그인한 사용자가 로그아웃한 정보를 저장하는 테이블 | - | hive_app_logout | 앱에서 로그아웃한 시점에 발생하는 이벤트 |
t_hive_purchase_log | Hive 빌링 기능을 통해 발생한 사용자의 구매 활동과 결제 정보를 저장 하는 테이블 | (env is null or upper(env) <> 'TEST') and isException is null | hive_product_purchase | 상품의 영수증 검증이 완료된 시점에 발생하는 이벤트 |
upper(env) = 'TEST' OR isException IS NOT NULL | hive_product_purchase_test | 상품의 테스트 결제가 발생한 시점에 발생하는 이벤트 | ||
t_hive_ad_watch_log | AD(X)나 ADOP 를 적용할 경우 Hive AdKit을 통해 제공되는 광고 시청 로그 | eventType IN ('click') | hive_ad_click | 광고를 클릭한 시점에 발생하는 이벤트 |
eventType IN ('closed') | hive_ad_close | 광고 시청을 종료한 시점에 발생하는 이벤트 | ||
eventType IN ('load') | hive_ad_load | 광고 소재가 클라이언트에 로드되는 시점에 발생하는 이벤트 | ||
eventType IN ('open') | hive_ad_open | 광고가 유저에게 노출된 시점에 발생하는 이벤트 | ||
eventType IN ('paid') | hive_ad_pay | 광고 eCPM 수익 정보가 기록되는 이벤트 | ||
eventType IN ('reward') | hive_ad_reward | 광고 시청 후 보상이 지급된 시점에 발생하는 이벤트 | ||
t_hive_au_download_log | Hive 프로비저닝 기능을 통해 약관 동의 화면 이후, 게임을 다운로드 할 경우 다운로드 정보를 저장하는 테이블 | first IN (0) | hive_app_redownload | 기존 유저가 앱을 재설치 또는 업데이트 한 시점에 발생하는 이벤트 |
first IN (1) | hive_terms_agree | 신규 유저가 최초 설치 후 약관에 동의한 시점에 발생하는 이벤트 | ||
t_hive_sub_purchase_log | Hive 빌링 기능을 통해 발생한 구독 상품 구매 활동 과 결제 정보를 저장하는 테이블 | priceType='PAID' AND (upper(env) = 'TEST' OR isException IS NOT NULL) | hive_product_purchase_test | 상품의 테스트 결제가 발생한 시점에 발생하는 이벤트 |
priceType='PAID' AND (env is null or upper(env) <> 'TEST') and isException is null | hive_product_purchase | 상품의 영수증 검증이 완료된 시점에 발생하는 이벤트 | ||
t_hive_quit_log | 인게임 내 에서 탈퇴요청 시 로그가 발생하며 유저의 탈퇴요청, 탈퇴완료 정보를 저장 하는 로그 | quitStatus IN ('D') | hive_account_quit_complete | 계정 탈퇴가 최종 완료된 시점에 발생하는 이벤트 |
quitStatus IN ('R') | hive_account_quit_request | 유저가 계정 탈퇴를 요청한 시점에 발생하는 이벤트 | ||
t_hive_user_entry_log | 유저가 게임을 실행하여 게임 로비에 도착하기까지 각 구간에 대한 정보를 저장하는 테이블 | sectionId IN (1000) | hive_banner_expose | Hive 프로모션 전면 배너가 노출된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 |
sectionId IN (400) | hive_app_first_launch | 앱 신규 설치 후 첫 실행된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (401) | hive_app_start | SDK 초기화(앱 시작) 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (410) | hive_permission_notice | 권한 고지 화면에 진입한 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (420) | hive_notice_expose | 공지 팝업이 노출된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (430) | hive_terms_enter | 약관 동의 화면에 진입한 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (500) | hive_server_select | 서버 선택 화면에 진입한 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (600) | hive_maintenance_expose | 서버 점검 팝업이 노출된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (700) | hive_download_start | 추가 다운로드가 시작된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (800) | hive_download_complete | 추가 다운로드가 완료된 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId IN (900) | hive_login_enter | 로그인 구간에 진입한 시점에 발생하는 앱 진입 퍼널용 클라이언트 이벤트 | ||
sectionId >= 10000 | game_user_entry | 게임에서 정의한 구간에 유저가 진입한 시점에 발생하는 이벤트 | ||
t_hive_login_log | Hive 인증 기능을 통해 로그인한 사용자의 로그인 정보를 저장 하는 테이블 | source IN ('membership') | hive_membership_login | Hive 멤버십 계정으로 로그인이 완료된 시점에 발생하는 이벤트 |
source NOT IN ('membership') | hive_app_login | Hive 멤버십 이외 방식으로 앱 로그인이 완료된 시점에 발생하는 이벤트 | ||
t_hive_user_block_log | Hive 이용정지(블록) 기능을 통해 유저가 이용정지 되거나 해제된 정보를 저장하는 테이블 | status IN ('블럭중') | hive_user_block | 유저에게 이용 정지가 적용된 시점에 발생하는 이벤트 |
status NOT IN ('블럭중') | hive_user_unblock | 유저의 이용 정지가 해제된 시점에 발생하는 이벤트 |
게임 로그 → 이벤트 데이터¶
게임 로그는 클라이언트 로그 전송 기능을 이용해 직접 전송하는 로그입니다. 아래 표에 포함되지 않은 게임 로그는 별도 매핑 없이 기존 로그명 그대로 신규 이벤트명으로 이관됩니다.
| 기존 로그 테이블 | 기존 로그 테이블 설명 | 필터 조건 | 신규 이벤트명 | 신규 이벤트 설명 |
|---|---|---|---|---|
t_pub_user_property_log | Hive SDK에서 수집한 정보로 사전에 정의한 속성 외에 자유롭게 속성 값을 정의한 커스텀 사용자 속성 테이블 | - | user_property_{propertyName} | 사전에 정의한 속성 외에 자유롭게 정의한 커스텀 사용자 속성(propertyName)의 값이 전송된 시점에 발생하는 이벤트 |
t_pub_asset_log | 재화 로그 | amountVar < 0 | hive_asset_use | 게임 내 재화를 소모한 시점에 발생하는 이벤트 |
amountVar > 0 | hive_asset_get | 게임 내 재화를 획득한 시점에 발생하는 이벤트 | ||
t_pub_store_click_log | 상점 클릭로그 | clickType IN ('detail') | hive_store_product_click | 인게임 스토어에서 상품 상세를 클릭한 시점에 발생하는 이벤트 |
clickType IN ('purchase') | hive_store_product_purchase | 인게임 스토어에서 상품 구매 버튼을 클릭한 시점에 발생하는 이벤트 | ||
t_pub_contents_log | 콘텐츠 로그 | contentStatus IN ('accept') | hive_contents_accept | 게임 콘텐츠를 수락한 시점에 발생하는 이벤트 |
contentStatus IN ('cancel') | hive_contents_cancel | 게임 콘텐츠를 취소한 시점에 발생하는 이벤트 | ||
contentStatus IN ('fail') | hive_contents_fail | 게임 콘텐츠를 실패한 시점에 발생하는 이벤트 | ||
contentStatus IN ('success') | hive_contents_success | 게임 콘텐츠를 클리어한 시점에 발생하는 이벤트 | ||
contentStatus IN ('wait') | hive_contents_wait | 게임 콘텐츠 시작 전 대기 구간에 진입한 시점에 발생하는 이벤트 | ||
t_pub_levelup_log | 레벨업 로그 | levelUpType IN ('account') | hive_account_level_change | 유저 계정 레벨업이 발생한 시점에 기록되는 이벤트 |
levelUpType IN ('character') | hive_character_level_change | 캐릭터 레벨업이 발생한 시점에 기록되는 이벤트 | ||
levelUpType IN ('guild') | hive_guild_level_change | 길드 레벨업이 발생한 시점에 기록되는 이벤트 | ||
levelUpType IN ('skill') | hive_skill_level_change | 스킬 레벨업이 발생한 시점에 기록되는 이벤트 | ||
t_pub_mate_log | 메이트 로그 | mateChangeAmount < 0 | hive_mate_consume | 메이트(펫, 동료 등)를 소모한 시점에 발생하는 이벤트 |
mateChangeAmount > 0 | hive_mate_get | 메이트(펫, 동료 등)를 획득한 시점에 발생하는 이벤트 | ||
t_pub_society_log | 사회활동 로그 | societyType IN ('friend') | hive_friend_society_invite | 친구 목록 변동이 발생한 시점에 기록되는 이벤트 |
societyType IN ('guild') | hive_guild_society_invite | 길드 구성원 변동이 발생한 시점에 기록되는 이벤트 | ||
societyType IN ('party') | hive_party_society_invite | 파티 구성원 변동이 발생한 시점에 기록되는 이벤트 |
MMP 로그 → 이벤트 데이터¶
MMP(Airbridge, AppsFlyer, Adjust)를 연동하신 경우, MMP의 신규 이벤트명은 MMP 제품명이 앞에 붙은 형태({MMP 제품명}_{eventName})의 신규 이벤트명으로 변경되어 이관됩니다. 아래 표는 자동으로 추적되는 이벤트 목록이며, 표에 없는 이벤트도 동일한 규칙으로 이관됩니다.
| MMP | 기존 로그 테이블 | MMP eventName | 신규 이벤트명 |
|---|---|---|---|
| Airbridge | t_hive_airbridge_log | Sign-in | airbridge_Sign-in |
Sign-out | airbridge_Sign-out | ||
Initiate Checkout | airbridge_Initiate Checkout | ||
Order Complete | airbridge_Order Complete | ||
Order Cancel | airbridge_Order Cancel | ||
Subscribe | airbridge_Subscribe | ||
Ad Impression | airbridge_Ad Impression | ||
Ad Click | airbridge_Ad Click | ||
Rate | airbridge_Rate | ||
Share | airbridge_Share | ||
Install | airbridge_Install | ||
Open | airbridge_Open | ||
Update | airbridge_Update | ||
Purchase | airbridge_Purchase | ||
| Adjust | t_hive_adjust_log | Install | adjust_Install |
Open | adjust_Open | ||
Update | adjust_Update | ||
Purchase | adjust_Purchase | ||
| AppsFlyer | t_hive_appsflyer_log | Install | appsflyer_Install |
Open | appsflyer_Open | ||
Update | appsflyer_Update | ||
Purchase | appsflyer_Purchase |