purchase¶
商品收據驗證完成時發生的事件（product_purchase + subscription_purchase），可用於產生應用程式內營收、PU、營收筆數、購買數量、ARPU 和 ARPPU 等指標。
| 屬性名稱 | 資料類型 | 描述 |
|---|---|---|
| appId | STRING | 表示發生事件的應用程式的唯一 ID。根據在 Hive 控制台應用程式中心註冊的 APPID 記錄，可用於區分各應用程式的指標。（例：com.sample.analytics.google.global.android.common） |
| appIdGroup | STRING | 表示發生事件的專案。根據在 Hive 控制台應用程式中心註冊的 GAMEID 值記錄，可在同時查看多個專案時依專案區分並比較指標。（例：com.sample.analytics） |
| dateTime | TIMESTAMP | 表示事件發生的日期和時間。根據事件發生的時間記錄，可作為依期間單位（日/週/月/時/分）彙總與日期範圍查詢的基準。（例：2023-05-09 19:30:35） |
| deviceId | STRING | 表示以觸發事件之裝置為基準的使用者識別碼。根據每次安裝應用程式時為每台裝置發行的執行個體值記錄，可透過去除重複的彙總計算不重複裝置數（條款同意數等）。（例：33333333） |
| eventName | STRING | 表示識別事件的名稱。由於所有事件都一起載入到同一個來源日誌中，此值可識別是哪個事件，並可作為依事件查詢資料的基準。（例：app_login） |
| identifierProvider | STRING | 表示發行使用者識別碼的系統，固定為「hive」。 |
| userId | STRING | 表示以觸發事件之帳號為基準的使用者識別碼。根據遊戲中的唯一使用者 ID 記錄，可透過去除重複的彙總計算 AU 等不重複使用者數。 |
| analyticsId | STRING | 表示觸發事件之應用程式安裝的唯一識別金鑰。根據應用程式初始化時發行的 base64 格式 24 位元組值記錄，可透過去除重複的彙總計算不重複裝置數。（例：EJFH9wsjEIn4Rf4321QrYA==） |
| appVer | STRING | 表示事件發生時的遊戲應用程式版本。根據應用程式版本資訊記錄，可與 os 屬性搭配使用，依應用程式版本比較使用者。（例：4.3.3、1.6.5） |
| characterId | STRING | 表示購買時的角色 ID。根據購買事件的遊戲資訊（game_info）中傳送的角色 ID 值記錄，可用於比較各角色的付款指標。 |
| characterLevel | STRING | 表示購買時的角色等級。根據購買事件的遊戲資訊中傳送的角色等級值記錄，可透過平均彙總計算付費使用者的平均角色等級。 |
| clientIp | STRING | 表示發生事件之使用者裝置的 IP。以遮罩 IP 最後一段的值記錄，可用於查詢特定 IP 區段的裝置數等資料。（例：127.0.0.x） |
| country | STRING | 表示事件發生時判定的使用者所在國家。以 ISO 3166-1 alpha-2 大寫格式記錄，可用於依國家比較使用者數、營收、留存率等。（例：KR、US） |
| currency | STRING | 表示購買時的付款貨幣單位。根據付款貨幣值記錄，可用於依貨幣區分營收。（例：KRW、USD、JPY） |
| isUserTotalPrice | STRING | 表示是否透過自訂金額付款功能進行 PG 付款。根據是否以付款請求時指定的金額（而非固定商品價格）付款記錄，可用於分析自訂金額付款的次數與比例。（例：Y、N） |
| lang | STRING | 表示事件發生時的語言值。根據遊戲或裝置語言值（ISO 639 alpha-2 小寫）記錄，可用於依語言比較指標。（例：ko、en） |
| level | INT(INTEGER) | 表示事件發生時的等級值。依事件不同，記錄當時的帳號、角色等的等級，可透過平均值或最大值彙總計算平均等級與最終達成等級。（例：43） |
| market | STRING | 表示事件發生時使用者安裝遊戲的市場。根據應用程式安裝或提供服務的市場值記錄，可用於依市場比較指標。（例：GO（Google Play）、AP（Apple App Store）、HS（直接發佈）） |
| model | STRING | 表示事件發生時使用者裝置的型號名稱。根據用戶端傳送的裝置型號值記錄，可用於依裝置型號比較指標。（例：iPhone 12 Pro、SHW-M250S） |
| os | STRING | 表示事件發生時使用者裝置的作業系統。根據用戶端傳送的平台值記錄，可用於依 OS 比較指標。（例：A（Android）、I（iOS）） |
| osVer | STRING | 表示事件發生時使用者裝置的 OS 版本。根據裝置作業系統版本值記錄，可用於依 OS 版本比較指標。（例：9.2、16.3.1） |
| osVersionFixed | STRING | 以 x.x.x 格式表示事件發生時使用者裝置的 OS 版本。即使 OS 版本的標示方式不同，也可用於比較相同版本。（例：9.2.0、16.3.1） |
| paymentServiceType | STRING | 表示購買的付款服務類型。根據遊戲內、網路商店等服務類型值記錄，可用於依服務類型比較營收。（例：ingame、webstore） |
| price | INT(FLOAT) | 表示購買時付款的總金額。根據使用者付款的總金額記錄，可透過加總彙總計算付款總額。 |
| productId | STRING | 表示所購買商品的 ID。根據在 Hive 計費中註冊的唯一商品 ID 值記錄，可用於依商品比較營收與購買次數。（例：com.sample.analytics.dia1000） |
| productName | STRING | 表示所購買商品的名稱。根據在 Hive 計費中註冊的唯一商品名稱值記錄，可用於依商品名稱比較營收。（例：鑽石 100） |
| productPrice | INT(FLOAT) | 表示以單一商品為基準的付款金額。根據付款時用戶端傳送的商品價格值（輔助 productId）記錄，可透過加總/平均彙總分析商品價格與付款規模。（例：1.99） |
| quantity | INT(INTEGER) | 表示使用者購買的商品數量。根據付款請求或購買處理時傳送的數量記錄，可用於計算商品銷售數量與每位使用者的平均購買數量。（例：1、20） |
| refundTransactionId | STRING | 表示退款後重新付款時，退款當時的收據 ID。根據退款後重新付款時先前的收據 ID 值記錄（否則為 null），可用於識別退款使用者的重新付款。 |
| sdkVer | STRING | 表示事件發生時的 Hive SDK 版本。根據用戶端套用的 Hive SDK 版本值記錄，可用於依 SDK 版本比較資料收集狀況。（例：4.16.2.2） |
| serverId | STRING | 表示事件發生時使用者連線的遊戲伺服器。根據遊戲傳送的伺服器識別碼記錄，可用於依伺服器比較使用者數、營收與留存率。（例：KR、GLOBAL） |
| serverIdInt | INT(INTEGER) | 表示事件發生時連線之遊戲伺服器 ID 的整數值。根據轉換為數字形式的伺服器識別碼記錄，可用於依伺服器比較指標。（例：1008） |
| serviceMarket | STRING | 表示進行購買的服務市場。根據在應用程式中心註冊的市場值自動填入，可用於依市場比較營收。（例：Google、Apple） |
| subStartDateTime | STRING | 表示訂閱續約開始日期和時間。根據該期間的訂閱續約開始時間（Google 和 Amazon 為收據驗證請求日期和時間）記錄，可用於分析訂閱期間與續約週期。（例：2026-07-21 15:16:17） |
| transactionId | STRING | 表示識別付款的唯一編號。一般付款與退款根據市場發行的收據 ID 記錄，訂閱則根據每次訂閱發行的識別碼值記錄，可透過去除重複的彙總計算付款次數，或用於連結購買與退款/取消事件。（例：GPA.1234-5678-9101-12345） |
| userTotalPrice | INT(FLOAT) | 表示以自訂金額付款所支付的金額。針對 isUserTotalPrice 為 Y 的付款，根據付款請求時指定的金額記錄，可用於分析自訂金額付款的規模與分布。 |