บันทึกการวิเคราะห์การเล่นเกมสกุลเงิน
ตัวชี้วัดการเปลี่ยนแปลงสกุลเงินในแดชบอร์ดตัวชี้วัดการเล่นเกมของแต่ละตัวชี้วัดเกมต้องการบันทึกนี้สำหรับการวิเคราะห์ หากมีการเปลี่ยนแปลงเกิดขึ้นจากการได้มาหรือการบริโภคสินค้าภายในเกม จะมีการส่งบันทึกเพื่อตรวจสอบการเปลี่ยนแปลงในแต่ละสินค้าและการเปลี่ยนแปลงเฉลี่ยในสินค้าสำหรับแต่ละผู้ใช้ และสามารถตรวจสอบพฤติกรรม TOP 10 ตามลำดับการเปลี่ยนแปลงรายวันในจำนวนการเปลี่ยนแปลงในสินค้าและจำนวนการเปลี่ยนแปลงสูงสุดในแต่ละสินค้า
ส่งบันทึก¶
ส่งบันทึกสำหรับเมตริกทางการเงินโดยใช้ วิธีการส่งบันทึกของไคลเอนต์ 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. | INTEGER | Y |
| appId | รหัสแอปที่ออกโดย App Center ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | Y |
| guid | คีย์เฉพาะสำหรับแถวของบันทึก แนะนำให้ใช้รูปแบบสตริงสุ่ม เช่น uuid ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | Y |
| dateTime | เวลาประทับบันทึกในรูปแบบ “YYYY-MM-DD hh ss” (เช่น “2022-11-15 10:20:10”) ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | Y |
| timezone | โซนเวลาของ dateTime สามารถได้รับผ่าน วิธีการตรวจสอบโซนเวลา โดยใช้ IP ของไคลเอนต์ ตัดสินใจตาม KST หากว่างหรือไม่มีค่า (เช่น "GMT+09:00") ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | |
| category | ค่าการจำแนกประเภทสำหรับบันทึกสินค้า ค่าจะถูกกำหนดเป็น “pub_asset_log” | STRING | Y |
| assetName | ชื่อสกุลเงิน (เช่น เพชร) ใช้เป็นเงื่อนไขการค้นหา ใช้เป็นชื่อผลิตภัณฑ์มาตรฐานสำหรับตาราง/กราฟทั้งหมด | STRING | Y |
| actionName | สาเหตุของการเปลี่ยนแปลงในสกุลเงิน (เช่น การซื้อในแอป) ใช้สำหรับ “การบริโภคสกุลเงินโดยการกระทำ” และ “การได้รับสกุลเงินโดยการกระทำ” รายการการกระทำของตัวชี้วัด | STRING | Y |
| serverId | รหัสเซิร์ฟเวอร์ ใช้เป็นเงื่อนไขการค้นหา ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | |
| userId | รหัสประจำตัวผู้ใช้ที่ไม่ซ้ำกันในเกม หากฟิลด์ playerId มีค่า 0 หรือ null จะถูกใช้เป็นกุญแจระบุผู้ใช้ในการคำนวณรายการ | STRING | |
| amountPrev | จำนวนเงินก่อนการเปลี่ยนแปลง | INTEGER | |
| amountVar | จำนวนการเปลี่ยนแปลงในสกุลเงิน * การบริโภค: ส่งเป็นจำนวนลบ (เช่น -100) * การได้มา: ส่งเป็นจำนวนบวก (เช่น 100) ใช้เมื่อคำนวณการเปลี่ยนแปลงในตัวชี้วัดการเปลี่ยนแปลงสกุลเงินทั้งหมด | INTEGER | Y |
| amountCurr | จำนวนเงินหลังการเปลี่ยนแปลง ใช้เมื่อคำนวณตัวชี้วัดสกุลเงินในเกมที่เป็นเจ้าของ | INTEGER | Y |
| contentsModeTypeName | หากมีการเปลี่ยนแปลงสกุลเงินเนื่องจากการใช้งานเนื้อหา ชื่อประเภทโหมดเนื้อหา (เช่น "raid") จะถูกใช้เมื่อคำนวณการเปลี่ยนแปลงสกุลเงินต่อเนื้อหา | STRING | |
| isPaid | ค่าที่บ่งบอกว่าสกุลเงินนั้นจ่ายแล้วหรือไม่ * "Y": สกุลเงินที่จ่ายแล้ว * "N": สกุลเงินฟรี | STRING | Y |
ตรวจสอบบันทึกที่ส่ง¶
- หลังจากส่งบันทึกเกมแล้ว คุณสามารถตรวจสอบบันทึกได้ใน ฟังก์ชันการกำหนดบันทึก
- การส่งข้อมูลจะแสดงในตัวชี้วัดและสามารถมองเห็นได้หากกรอกข้อมูลในฟิลด์ที่จำเป็นทั้งหมดในคำจำกัดความของบันทึกสินค้าอย่างถูกต้อง