购买日志
類別¶
- 寫作類型
| 常見伺服器 | 購買記錄 |
|---|---|
| 測試伺服器 | 測試購買記錄 |
- FTP 類型
| 命名規則 | purchase_[日期][伺服器][避免重複的ID].json | 例如，purchase_20180705_111500_GLOBAL-4.json |
|---|---|---|
- Fluentd 類型（基於日誌定義）
| 伺服器（將負載平衡到兩個伺服器） | analytics-hivelog-03.withhive.com analytics-hivelog-04.withhive.com | |
| 標籤命名規則 | ha2union.game.[遊戲的簡短名稱].purchase_log | 例如，ha2union.game.samplegame.purchase_log |
| 類別字段的值 | [遊戲的簡短名稱]_purchase_log | 例如，{“category”:”samplegame_purchase_log”,”aaa”:1} |
| 詳細傳輸方法 | ||
- HTTP 類型 (根據日誌定義)
| 伺服器 | https://analytics-log.withhive.com | |
| 類別 欄位的值 | [遊戲的簡短名稱]_purchase_log | 例如，{"category":"samplegame_purchase_log","aaa":1} |
| 詳細傳輸方法 | ||
日誌規範¶
Note
蛇形命名的字段，例如 server_id，在存储到最终存储（BigQuery）时会转换为驼峰命名，例如 serverId，而以未指定形式发送的日志，例如 serverid，则不会保存在其列中。
| 字段名称 | 描述 | 类型 | 必需 | IAP v2 必需 |
|---|---|---|---|---|
| channel | C2S: HIVE KAK: Kakao LIN: LINE WEI: Weibo | string (3) | Y | N |
| uid | 从 HIVE 客户端发送的 HIVE uid（使用 extra_uid） 没有 uid 时，输入 null | bigint | 如果存在 Extra_uid 则不必要 | N |
| extra_uid | 由外部渠道（例如 Kakao）发放的唯一标识符，用户通过该渠道访问游戏，而不是 HIVE 没有 extra_uid 时，输入 null | string (30) | 如果 uid 存在则不必要 | N |
| did | 在 HIVE 中使用的设备标识符 | bigint | Y | N |
| platform | 用户设备的平台: "A": Android "I": iOS "B": Bada "W": Windows | string (1) | Y | N |
| os_version | 用户设备的平台版本 例如，"5.1.1" | string (30) | Y | 不强制，但推荐。 |
| market | 市场信息 "TS": SKT T store "OL": KT Olleh Market "OZ": LGU+ Oz Store "AP": Apple App store "GO": Google Play "SA": Samsung Apps "LE": Com2uS Lebi "MM": ChinaMobile Mobile Market "SN": Sina Weibo Point "36": Qihu 360 Point "MO": Momo Momo Point "DN": DeNA Mobage Point "NA": Naver App Store "AM": Amazon "ON": ONE store "FU": Funtap "HU": Huawei "OP": OPPO "VI": VIVO "XI": Xiaomi "TC": Tencent | string (2) | Y | N |
| game_index | 由业务部门技术部发放 与 AppID 一起发放的应用索引 | smallint | Y | N |
| app_id | Hive SDK 使用的 AppID 例如，'com.com2us.derbyday.kakao.freefull.google. android.common' | string(200) | Y | Y |
| version | 用户当前使用的游戏版本 例如，"2.0.1" | string(30) | Y | N |
| nationality | 从客户端发送的国籍代码。如果无法发送此值，请发送 client_ip（在 DW 服务器上搜索 GeoIP 并添加）格式：ISO 3166-1 alpha-2 例如，"KR" 参考：标识符政策 | string(2) | Y | N |
| client_ip | 用户设备在支付时的 IP 地址 格式: [0–255]. [0–255]. [0–255]. [0–255] | string(15) | Y | N |
| transaction_id | 游戏的唯一充电标识符。它防止在发送到 Hive 服务器时购买日志的重复 此字段用于消除在发送重复购买日志到 Hive 服务器时的重复。 GooglePlay: order_id（在测试支付中：如果 order_id 返回 null，则使用 purchasetoken，其他情况下使用 order_id） AppStore: transaction_id SamsungApps: payment_id 无验证市场：由游戏服务器发放的交易标识符 如果游戏使用 IAP 2.0，则输入 {iap transaction id}. | string(512) | Y | Y |
| product_id | 产品标识符 例如，com.com2us.tinyfarm.normal.freefull.apple. global.ios.universal.Large_Basket_of_Bells | string(512) | Y | N |
| product_name | 产品名称 韩/英/数字/符号可用，最多 20 个字符 | string(128) | Y | N |
| product_price | 用户支付的产品价格 例如，10.99 | float | Y | N |
| currency | 用户支付的价格的货币 格式：ISO 4217 例如，USD, KRW 通过 Lebi 支付显示为“CNY”（20lebi=1CNY） | string(3) | Y | N |
| 數量 | 使用者購買的產品數量 | int | Y | N |
| 購買時間 | 使用者支付購買的時間（基於 KST） 請輸入無空格 格式：yyyy-mm-dd hh  ss 例如：2017-02-08 16:34:38 | datetime | Y | Y |
| 時區 | 日誌中時間參數的 UTC 偏移
例如："GMT+09:00" 例如："GMT+10:30" | string | Y | N |
| 路徑 | gs：遊戲伺服器的縮寫（固定） | string(2) | Y | N |
| 伺服器 IP | 發送購買日誌的遊戲伺服器的 IP 地址 格式：[0–255]. [0–255]. [0–255]. [0–255] | string(15) | Y | N |
| 贈送者 UID | 顯示日誌的目標是否為贈品；如果是贈品，該值表示接收者的唯一標識符（uid） null：不是贈品。對使用者本身的正常購買 0：贈品，但接收者的 uid 不明 ID 的值：接收者的 uid | bigint | Y | N |
| 設備名稱 | 使用者設備的型號名稱 例如：iPhone、iPad、SM-G935、LGM-G600S | string(32) | Y | N |
| 公司 | 遊戲發行公司，日誌的目標： 例如："C2S"：Com2uS，"GVI"：Com2uS Holdings | string(3) | Y | N |
| 伺服器 ID | 伺服器代碼 請參考 伺服器代碼表 輸入伺服器代碼（JSON 輸入代碼） | string | Y | Y |
| 伺服器 UID | 在遊戲伺服器中使用的使用者標識符 | bigint | Y | N |
| 等級 | 使用者在遊戲中的等級（如果角色有多個，則為最高等級） | int | Y | Y |
| 角色 ID | 在伺服器中使用的角色標識符 如果遊戲沒有角色，請將此標識符設置為 0 | bigint | Y | N |
| 角色類型 ID | 在伺服器中使用的角色類型的值 如果遊戲沒有角色，請將此值設置為 0 | int | Y | N |
| 角色等級 | 在伺服器中使用的角色等級 如果遊戲沒有角色，請將此等級設置為 0 | int | Y | N |
| 語言 | 使用者的語言代碼 格式：ISO 639 alpha-2（小寫） 例如："ko" | string(7) | Y | N |
| 遊戲語言 | 從客戶端發送的遊戲的語言代碼。2 個小寫字母 例如：ko/zh-hans（簡體中文）、zh-hant（繁體中文） 參考：標識符政策 | varchar | Y | N |
| 設備語言 | 從客戶端發送的設備的語言代碼 例如：ko/zh-hans（簡體中文）、zh-hant（繁體中文） 參考：標識符政策 | varchar | Y | N |
| vid | 登錄中心發出的使用者標識符 如果不使用登錄中心，則不需要發送鍵值。 | bigint | Y | N |
| MAC 地址 | 使用者設備的 MAC 地址 格式：12 個字符的字符串類型 如果不存在，請將值清空 例如：482C6A1E593D | string(12) | Y | N |
| 項目發送成功 | (Y/N) 購買的項目是否已交付給使用者？ 如果無法確認交付狀態，請發送空字符串 "" | string(1) | Y | Y |
| 是否模擬器 | 如果使用 BlueStacks 等 PC 模擬器連接，返回 1；否則，對於 PC 版本返回 0，返回 2 | tinyint(1) | N | 不要求，但建議。 |
| guid | 每個日誌生成的唯一鍵 建議使用隨機格式，如 uuid | varchar(64) | N | N |
| hiveiap_purchase_test | 測試付款狀態 | varchar(100) | N | N |
日誌範例¶
{
"channel": "C2S",
"uid": 111111111,
"did": 222222222,
"mac_address": "000000000000",
"platform": "A",
"os_version": "6.0.1",
"market": "GO",
"game_index": "2414",
"app_id": "com.com2us.misample",
"version": "2.4.1",
"level": 21,
"nationality": "us",
"language": "en",
"ip": "112.114.245.232",
"transaction_id": "GPA.3333-8449-4747-11111",
"product_id": "com.com2us.misample.normal.freefull.google.global.android.common.cash01",
"product_name": "uc9c0",
"product_price": "1.99",
"quantity": 1,
"currency": "USD",
"purchase_time": "2018-05-01 11:22:33",
"path": "gs",
"server_ip": "114.114.245.239",
"device_name": "samsung SM-G920P",
"company": "C2S",
"game_language": "en",
"device_language": "ko",
"server_id": "KR-2",
"guid": "ca4bd34c867f4617a819ae139d8d6670"
}