บันทึกการวิเคราะห์การเล่นเกมระดับสูง
นี่คือบันทึกที่จำเป็นสำหรับตัวบ่งชี้การเลื่อนระดับในแดชบอร์ดการวิเคราะห์การเล่นเกมของแต่ละตัวบ่งชี้เกม เมื่อเกิดเหตุการณ์เลื่อนระดับสำหรับบัญชีผู้ใช้หรือตัวละครในเกม บันทึกจะถูกส่งเพื่อยืนยันจำนวนการเปลี่ยนแปลงเลื่อนระดับตามประเภทของช่วงเวลาการค้นหา จำนวนผู้ใช้ และจำนวนผู้ใช้ตามระดับสุดท้าย
ส่งบันทึก¶
ส่งบันทึกสำหรับตัวบ่งชี้การเลื่อนระดับโดยใช้วิธีการส่ง บันทึกของไคลเอนต์ 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 |
ตรวจสอบบันทึกที่ส่ง¶
- หลังจากส่งบันทึกเกมแล้ว คุณสามารถตรวจสอบบันทึกได้ใน ฟังก์ชันการกำหนดบันทึก
- หากค่าที่จำเป็นทั้งหมดถูกป้อนอย่างถูกต้องในฟิลด์การกำหนดบันทึกเลเวลอัพ ตัวชี้วัดจะแสดงผลและแสดงการส่งข้อมูล