บันทึกเนื้อหาการวิเคราะห์การเล่นเกม
บันทึกที่จำเป็นสำหรับดัชนีเนื้อหาในแดชบอร์ดการวิเคราะห์การเล่นเกมของดัชนีตามเกม คุณสามารถตรวจสอบจำนวนการใช้งานสำหรับแต่ละเนื้อหา อัตราความสำเร็จ/การยกเลิก/การเสร็จสิ้น สถานะรายละเอียด และอื่น ๆ
ส่งบันทึก¶
ใช้ เทคนิคการส่งบันทึกของไคลเอนต์ Hive 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:mm:ss” (เช่น “2022-11-15 10:20:10”) ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK | STRING | Y |
timezone | เขตเวลาของ dateTime สามารถตรวจสอบได้ผ่าน วิธีการตรวจสอบเขตเวลา โดยใช้ IP ของไคลเอนต์ กำหนดตาม KST หากว่างหรือไม่มีค่า (เช่น "GMT+09:00") ส่งโดยอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของไคลเอนต์ Hive SDK. | STRING | Y |
category | ค่าที่ใช้ในการแยกประเภทของบันทึกเนื้อหาซึ่งกำหนดเป็น “pub_contents_log” | STRING | Y |
modeTypeName | ชื่อประเภทโหมดเนื้อหา (เช่น "raid") ใช้เป็นชื่อเนื้อหาของ “จำนวนการใช้เนื้อหา” หรือ “รายละเอียดการใช้เนื้อหา” | STRING | Y |
modeTypeId | รหัสประเภทโหมดเนื้อหา เป็นรหัสตัวเลขที่ตรงกับฟิลด์ modeTypeName 1:1 * ใช้ในการรวมตัวชี้วัด "Tutorial Funnel" ในลำดับที่เพิ่มขึ้นหากน้อยกว่าหรือเท่ากับ 20000000 * ใช้ในการรวมตัวชี้วัด "Main Quest Funnel" ในลำดับที่เพิ่มขึ้นหากมากกว่า 20000000 | INTEGER | |
contentStatus | ดำเนินการตามกระบวนการด้านล่างในสถานะประเภทโหมดเนื้อหา * accept (-> wait) -> fail/success/cancel คุณสามารถตั้งค่าเป็นหนึ่งในห้าค่าด้านล่าง * “accept”: ยอมรับ * “wait”: รอ * “fail”: ล้มเหลว * “success”: สำเร็จ * “cancel”: ยกเลิก ใช้ในดัชนี “อัตราส่วนการยอมรับเนื้อหา” หรือดัชนี “รายละเอียดการใช้เนื้อหา” | STRING | Y |
serverId | รหัสเซิร์ฟเวอร์ ใช้เป็นเงื่อนไขการค้นหา ส่งอัตโนมัติเมื่อใช้ ฟังก์ชันการส่งบันทึกของ Hive SDK client. | STRING | |
userId | รหัสประจำตัวผู้ใช้ที่ไม่ซ้ำกันในเกม | STRING | |
userLevel | ระดับผู้ใช้ในเกมหรือค่าที่เทียบเท่า ใช้เป็นเงื่อนไขการค้นหาหรือในรายการ "ระดับผู้ใช้ (เฉลี่ย)" ของดัชนี "รายละเอียดการใช้เนื้อหา" | INTEGER | |
characterLv | ระดับตัวละคร ใช้ในรายการ "ระดับตัวละคร (เฉลี่ย)" ของดัชนี "รายละเอียดการใช้เนื้อหา" | INTEGER | |
playTimeSec | เวลาเล่นตามสถานะหรือเวลารอ (วินาที) สำหรับแต่ละประเภทโหมดเนื้อหา ใช้ในรายการ "เวลาเล่น (นาที/เฉลี่ย)" ของดัชนี "รายละเอียดการใช้เนื้อหา" | INTEGER | |
score | คะแนนที่ได้รับระหว่างการเล่นหรือค่าที่เทียบเท่า ใช้ในรายการ "คะแนน (เฉลี่ย)" ของดัชนี "รายละเอียดการใช้เนื้อหา" | INTEGER |
ตรวจสอบบันทึกที่ส่ง¶
- หลังจากส่งบันทึกเกมแล้ว คุณสามารถตรวจสอบบันทึกใน ฟังก์ชันการกำหนดบันทึก
- หากค่าทั้งหมดในฟิลด์ที่ต้องการโดยการกำหนดบันทึกเนื้อหาได้รับการป้อนอย่างถูกต้อง การส่งจะถูกสะท้อนและแสดงในดัชนี