บันทึกคุณสมบัติผู้ใช้ที่กำหนดเอง

เซ็กเมนต์คือข้อมูลที่รวบรวมจาก Hive SDK และสามารถส่งและเลือกได้โดยการกำหนดค่า property อย่างอิสระนอกเหนือจากคุณสมบัติตั้งต้น

ส่งคุณสมบัติ¶

คุณสามารถใช้ การส่งบันทึกของไคลเอนต์ Hive SDK เพื่อส่งค่าคุณสมบัติที่ผู้ใช้กำหนดเอง

โค้ดตัวอย่างสำหรับการส่งบันทึกสามารถตรวจสอบได้ผ่าน ฟีเจอร์การสร้างแหล่งที่มาของไคลเอนต์ในฟีเจอร์การกำหนดบันทึก .

ข้อกำหนดการส่งคุณสมบัติ¶

ฟิลด์จะถูกประกอบขึ้นในรูปแบบ camel case (เช่น dateTime) และมีความไวต่อการพิมพ์ตัวพิมพ์ใหญ่และพิมพ์เล็ก ค่าเหล่านี้จะไม่ถูกบันทึกในกรณีต่อไปนี้

ถ้าชื่อฟิลด์ไม่ได้กำหนดตามที่ระบุ (เช่น “time“)
ถ้าชื่อฟิลด์ไม่ตรงกับชื่อฟิลด์อย่างแม่นยำ (เช่น “app_id“)
ถ้าค่าไม่ตรงกับประเภทที่กำหนดสำหรับแต่ละฟิลด์ (เช่น “474392047” สำหรับฟิลด์ “playerid”)

ข้อควรระวัง

STRING: ข้อมูลสตริงสูงสุด 1 MB
INTEGER: ข้อมูลแบบ signed 64-bit (-9,223,372,036,854,775,808 ถึง 9,223,372,036,854,775,807)
หากส่งข้อมูลที่ไม่ตรงกับประเภทของแต่ละฟิลด์ ฟิลด์ที่เกี่ยวข้องอาจไม่ถูกบันทึกอย่างถูกต้อง ดังนั้นคุณต้องส่งค่าที่ตรงกับประเภท

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
playerId	คีย์เฉพาะที่ใช้ระบุผู้ใช้ในระบบการตรวจสอบสิทธิ์ของ Hive เมื่อใช้ [ฟีเจอร์การส่งบันทึกของ Hive SDK client] จะถูกส่งโดยอัตโนมัติ	INTEGER	Y
uid	คีย์ผู้ใช้ในสมาชิก Hive. UID ที่สูงกว่า 90000000000 แทนคีย์ผู้ใช้แขก เมื่อใช้ ฟีเจอร์การส่งบันทึกของ Hive SDK client, จะถูกส่งโดยอัตโนมัติ	INTEGER
appId	appId ที่ออกโดย App Center เมื่อใช้ ฟีเจอร์การส่งบันทึกของ Hive SDK client, จะถูกส่งโดยอัตโนมัติ	STRING	Y
guid	ค่าคีย์ที่ไม่ซ้ำกันของแถวของคุณสมบัติ แนะนำให้ใช้รูปแบบสตริงแบบสุ่มเช่น uuid เมื่อใช้ ฟีเจอร์การส่งบันทึกของ Hive SDK client, จะถูกส่งโดยอัตโนมัติ	STRING	Y
datatime	เวลาการเกิดของคุณสมบัติในรูปแบบ “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	Y
category	กำหนดเป็น “pub_user_property_log”	STRING	Y
propertyDataType	ค่าที่สามารถตั้งเป็นประเภทข้อมูลของค่าทรัพย์สินของผู้ใช้ในเกมคือหนึ่งใน 4 ประเภทต่อไปนี้ (เช่น “string”) * “string“: เมื่อค่าทรัพย์สินต้องแยกแยะเป็นสตริง * “integer“: เมื่อค่าทรัพย์สินต้องแยกแยะเป็นจำนวนเต็ม ในกรณีที่ทรัพย์สินต้องการการรวมผล ผลรวมควรเป็นจำนวนเต็ม * “float“: เมื่อค่าทรัพย์สินต้องแยกแยะเป็นจำนวนทศนิยม ในกรณีที่ทรัพย์สินต้องการการรวมผล ผลรวมควรเป็นจำนวนทศนิยม * “timestamp“: เมื่อค่าทรัพย์สินต้องแยกแยะเป็นค่าของเวลา รูปแบบควรเป็น yyyy-mm-dd hh:mm:ss ใช้เพื่อให้สามารถเลือกค่าทรัพย์สินสำหรับประเภทข้อมูลของทรัพย์สินเมื่อสร้างเซ็กเมนต์	STRING	Y
propertyName	ชื่อของค่าทรัพย์สินที่ผู้ใช้มีในเกม (เช่น “สถานะความสำเร็จ”) ไม่แยกตัวพิมพ์หากค่าทรัพย์สินเป็นภาษาอังกฤษ อาจเกิดการขึ้นบรรทัดใหม่เมื่อทรัพย์สินที่ส่งแสดงบนหน้ากระดานเซ็กเมนต์หากค่าทรัพย์สินเกิน 28 ไบต์รวมถึงช่องว่าง ใช้เพื่อเลือกทรัพย์สินเมื่อสร้างเซ็กเมนต์	STRING	Y
propertyValue	ค่าทรัพย์สินของผู้ใช้ในเกม (เช่น “ล้มเหลว”) ใช้เพื่อเลือกค่าที่ตรงกับชื่อทรัพย์สินเมื่อสร้างเซ็กเมนต์	STRING	Y

ตรวจสอบคุณสมบัติที่ส่ง¶

คุณสามารถตรวจสอบใน ฟีเจอร์การกำหนดล็อก หลังจากส่งคุณสมบัติของผู้ใช้
หากฟิลด์ที่จำเป็นทั้งหมดในคำจำกัดความของคุณสมบัติผู้ใช้ถูกกรอกด้วยค่าอย่างถูกต้อง คุณสามารถเลือกผู้ใช้เมื่อสร้างเซ็กเมนต์