บันทึกการวิเคราะห์การเล่นเกมระดับสูง
นี่คือบันทึกที่จำเป็นสำหรับตัวบ่งชี้การเลื่อนระดับในแดชบอร์ดการวิเคราะห์การเล่นเกมของแต่ละตัวบ่งชี้เกม เมื่อเกิดเหตุการณ์เลื่อนระดับสำหรับบัญชีผู้ใช้หรือตัวละครในเกม บันทึกจะถูกส่งเพื่อยืนยันจำนวนการเปลี่ยนแปลงเลื่อนระดับตามประเภทของช่วงเวลาการค้นหา จำนวนผู้ใช้ และจำนวนผู้ใช้ตามระดับสุดท้าย
ส่งบันทึก¶
ส่งบันทึกสำหรับตัวบ่งชี้การเลื่อนระดับโดยใช้วิธีการส่ง บันทึกของไคลเอนต์ SDK
สามารถตรวจสอบบันทึกตัวอย่างเพื่อส่งบันทึกได้จาก การกำหนดบันทึก – สร้างแหล่งที่มาของไคลเอนต์.
ข้อกำหนดของบันทึก¶
ฟิลด์ถูกกำหนดในรูปแบบ CamelCase (เช่น serverId) และมีความไวต่อการใช้ตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก ค่าไม่ถูกบันทึกในกรณีต่อไปนี้:
- หากชื่อฟิลด์ไม่ได้ถูกกำหนดไว้ด้านล่าง (เช่น uid).
 - หากชื่อฟิลด์ไม่ตรงกับชื่อฟิลด์อย่างแม่นยำ (เช่น serverid).
 - หากประเภทไม่ได้ถูกกำหนดในแต่ละฟิลด์ (เช่น “474392047” สำหรับ vid).
 
ข้อควรระวัง
- STRING: ข้อมูลสตริงสูงสุด 1MB
 - INTEGER: ข้อมูล 64 บิตที่มีเครื่องหมาย (-9,223,372,036,854,775,808 ถึง 9,223,372,036,854,775,807)
 - หากส่งข้อมูลที่ไม่ตรงกับประเภทของแต่ละฟิลด์ ฟิลด์อาจไม่ถูกเก็บอย่างถูกต้อง ดังนั้นต้องส่งด้วยค่าที่ตรงกับประเภท
 
| ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น | 
|---|---|---|---|
| playerId | คีย์เฉพาะที่ระบุผู้ใช้ในระบบการตรวจสอบของ Hive  ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client.  |  INTEGER | Y | 
| appId | รหัสแอปที่ออกโดย App Center  ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client.  |  STRING | Y | 
| guid | คีย์เฉพาะสำหรับแถวของบันทึก  แนะนำให้ใช้รูปแบบสตริงแบบสุ่มเช่น uuid ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client.  |  STRING | Y | 
| dateTime | เวลาในบันทึกในรูปแบบ “YYYY-MM-DD hh:mm:ss”  (เช่น “2022-11-15 10:20:10”) ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client.  |  STRING | Y | 
| timezone | เขตเวลาของ dateTime  สามารถตรวจสอบได้ผ่าน วิธีการตรวจสอบเขตเวลา โดยใช้ IP ของลูกค้า กำหนดตาม KST หากว่างหรือไม่มีค่า (เช่น “GMT+09:00”) ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client.  |  STRING | |
| category | ค่าการจำแนกประเภทสำหรับบันทึกการเลื่อนระดับ ค่าจะถูกกำหนดเป็น “pub_levelup_log” | STRING | Y | 
| levelUpType | ประเภทการเลื่อนระดับ (เช่น “บัญชี”)  ค่าที่สามารถตั้งได้คือหนึ่งใน 4 ค่านี้ * “บัญชี” * “ตัวละคร” * “กิลด์” * “ทักษะ” ใช้เมื่อคำนวณการจำแนกประเภทการเลื่อนระดับของตัวชี้วัดทั้งหมด ในหน้าการสร้างเซ็กเมนต์ สามารถเลือกองค์ประกอบเมื่อส่งค่าระดับไปยังบัญชี  |  STRING | Y | 
| serverId | รหัสเซิร์ฟเวอร์  ใช้เป็นเงื่อนไขการค้นหา ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK.  |  STRING | |
| userId | รหัสประจำตัวผู้ใช้ในเกม  หากฟิลด์ playerId มีค่า 0 หรือ null จะถูกใช้เป็นกุญแจการระบุตัวผู้ใช้ในการคำนวณรายการ  |  STRING | |
| levelPrev | ระดับก่อนการเลื่อนระดับ | INTEGER | |
| level | ระดับหลังการเลื่อนระดับ  ใช้เมื่อคำนวณ “จำนวนผู้ใช้ที่เลื่อนระดับล่าสุด”  |  INTEGER | Y | 
ตรวจสอบบันทึกที่ส่ง¶
- หลังจากส่งบันทึกเกมแล้ว คุณสามารถตรวจสอบบันทึกได้ใน ฟังก์ชันการกำหนดบันทึก
 - หากค่าที่จำเป็นทั้งหมดถูกป้อนอย่างถูกต้องในฟิลด์การกำหนดบันทึกเลเวลอัพ ตัวชี้วัดจะแสดงผลและแสดงการส่งข้อมูล