ข้ามไปที่เนื้อหา

บันทึกเนื้อหาการวิเคราะห์การเล่นเกม

บันทึกที่จำเป็นสำหรับดัชนีเนื้อหาในแดชบอร์ดการวิเคราะห์การเล่นเกมของดัชนีตามเกม คุณสามารถตรวจสอบจำนวนการใช้งานสำหรับแต่ละเนื้อหา อัตราความสำเร็จ/การยกเลิก/การเสร็จสิ้น สถานะรายละเอียด และอื่น ๆ

ส่งบันทึก

ใช้ เทคนิคการส่งบันทึกของไคลเอนต์ 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

ตรวจสอบบันทึกที่ส่ง

  • หลังจากส่งบันทึกเกมแล้ว คุณสามารถตรวจสอบบันทึกใน ฟังก์ชันการกำหนดบันทึก
  • หากค่าทั้งหมดในฟิลด์ที่ต้องการโดยการกำหนดบันทึกเนื้อหาได้รับการป้อนอย่างถูกต้อง การส่งจะถูกสะท้อนและแสดงในดัชนี