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

ภาพรวม¶

บันทึกเหตุการณ์ของเกมประกอบด้วยคุณสมบัติที่จำเป็นและคุณสมบัติที่ผู้ใช้กำหนด หากคุณลิงก์ Hive SDK v4 คุณสมบัติที่รวบรวมโดยอัตโนมัติจะถูกเพิ่มโดยไม่มีการส่งแยกต่างหาก

แอตทริบิวต์ที่จำเป็น¶

คุณสมบัตินี้ ต้องรวมไว้ เมื่อส่งบันทึกเหตุการณ์ของเกม

eventName แบบแผนการตั้งชื่อ¶

ขอแนะนำให้เขียนชื่อเหตุการณ์ที่ใช้สำหรับ eventName ตามกฎด้านล่าง

• อักขระที่แนะนำ: ตัวอักษรภาษาอังกฤษ (a–z, A–Z, คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่), ตัวเลข (0–9), ขีดล่าง (_)
• ตัวคั่น: คำต่างๆ จะถูกคั่นด้วยเครื่องหมายขีดล่าง (_) แทนที่จะเว้นวรรค
• รูปแบบ: แนะนำให้ใช้รูปแบบภาษาอังกฤษ noun_verb ที่อธิบายเหตุการณ์ได้อย่างชัดเจน
• ตัวอย่าง: item_purchase, level_up, tutorial_complete, stage_start

eventTime กฎรูปแบบ (RFC 3339)¶

eventTime เป็นไปตามรูปแบบ RFC 3339 และต้องมีข้อมูลโซนเวลา

รูปร่าง:

YYYY-MM-DDTHH:MM:SS[.sss]+HH:MM หรือ YYYY-MM-DDTHH:MM:SSZ

ตัวอย่างที่ยอมรับได้:

20-07-2026T14:01:01+09:00 (KST, เวลามาตรฐานของเกาหลี)
2026-07-20T05:01:01Z            (UTC)
20-07-2026T14:01:01.123+09:00 (รวมมิลลิวินาที)
20-07-2026T23:01:01-05:00 (เวลาตะวันออกของสหรัฐอเมริกา)

ไม่อนุญาตให้ใช้ตัวอย่าง:

2026-07-20 14:01:01 (ไม่มีโซนเวลา → กักกัน)
20-07-2026 (ไม่มีเวลา → กักกัน)
1719835261 (Unix timestamp → กักกัน)
14:01:01 น. (ไม่มีวันที่ → กักกัน)

eventTime¶

• eventTime จะถูก แปลงเป็น UTC ในไปป์ไลน์และจัดเก็บไว้ในคอลัมน์ dateTime ของตาราง โดยค่าเดิมจะยังคงอยู่ใน attributes.eventAttributes.eventTime

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

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

กฎชื่อแอตทริบิวต์¶

ชื่อทรัพย์สินที่ไม่สามารถใช้งานได้ (คำสงวน)¶

กฎค่าแอตทริบิวต์¶

หากค่าคุณสมบัติอยู่ในรูปแบบของวัตถุ JSON อาร์เรย์ JSON หรือสตริงในรูปแบบของ JSON ค่านั้นจะถูก แยกออกเป็นตาราง rescue

// JSON วัตถุ (ไม่ได้รับอนุญาต)
"info": {"key": "value"}

// JSON อาร์เรย์ (ไม่ได้รับอนุญาต)
"items": [1, 2, 3]

// สตริงของแบบฟอร์ม JSON (ไม่ได้รับอนุญาต)
"data": "{\"key\": \"value\"}"

การส่งซ้ำของชื่อแอตทริบิวต์เดียวกัน¶

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

Hive SDK v4 คุณสมบัติที่รวบรวมอัตโนมัติ¶

รวบรวมโดยอัตโนมัติเมื่อไคลเอนต์ส่งบันทึกเหตุการณ์ไปที่ Hive SDK v4

• หากผู้ใช้ส่งค่าที่มีชื่อคุณสมบัติเดียวกันโดยตรง ค่าที่ส่งโดยผู้ใช้ จะถูกจัดเก็บแทนค่าที่รวบรวมโดยอัตโนมัติโดย SDK
• คุณสมบัติด้านล่างถูกเก็บไว้ใน attributes.eventAttributes ในตาราง

Hive SDK v4 หากคุณใช้คุณลักษณะการส่งบันทึกเหตุการณ์ SDK จะเป็นแอตทริบิวต์ที่รวบรวมและส่งโดยตรงจากอุปกรณ์ไคลเอ็นต์

คุณสมบัติที่จำเป็น¶

ในบรรดา แอตทริบิวต์ที่จำเป็น, SDK และ v4 จะถูกรวบรวมโดยอัตโนมัติ (ไม่รวม eventName)

ข้อมูลประจำตัวผู้ใช้/บัญชี¶

เวลา/ข้อมูลประจำตัว¶

ชื่อแอตทริบิวต์	คำอธิบาย	โดเมน	ตัวอย่าง
dateTime	นี่คือวันที่และเวลาของเหตุการณ์ที่สร้างขึ้นเมื่อส่งบันทึกเหตุการณ์ (yyyy-MM-dd HHss รูปแบบ)	Hive SDK (หลัก)	2026-01-01 00:00:00
guid	UUID (ลบยัติภังค์ออก) สร้างขึ้นทุกครั้งที่มีการส่งบันทึกเหตุการณ์ ใช้สำหรับการระบุเฉพาะและการขจัดข้อมูลซ้ำซ้อนของบันทึกเหตุการณ์	Hive SDK (หลัก)	ecbfbd7fcdc340e1b8a433999c5290c1
is_hive_time	ตั้งค่าสถานะว่าการประทับเวลาในบันทึกเหตุการณ์ Hive ซิงโครไนซ์กับเวลาเซิร์ฟเวอร์หรือไม่ (Y/N)	Hive SDK (หลัก)	Y
timezone	dateTime ข้อมูลออฟเซ็ตโซนเวลาซึ่งเป็นค่าที่อ้างอิง	Hive SDK (หลัก)	GMT+09:00
is_url_encode	แฟล็กที่ระบุว่าจะใช้การเข้ารหัส URL เมื่อส่งบันทึกเหตุการณ์หรือไม่ (Y แก้ไขแล้ว)	Hive SDK (หลัก)	Y

ข้อมูลอุปกรณ์¶

SDK/ข้อมูลการสร้างแอป¶

SDK ข้อมูลการตั้งค่า¶

กำลังรับข้อมูลเซิร์ฟเวอร์¶

ข้อควรระวัง & Tips¶

• ชื่อแอตทริบิวต์ที่จำเป็นต้องส่งเป็นตัวพิมพ์เล็กหรือตัวพิมพ์เล็ก และหากส่งเป็นตัวพิมพ์งู (user_id) ชื่อแอตทริบิวต์เหล่านั้นจะถูก แยกลงในตาราง rescue
• ต้องมี appId หรือ appIdGroup ไม่เช่นนั้นจะถูกแยกออกจากกัน
• eventTime อนุญาตเฉพาะในรูปแบบ RFC 3339 เท่านั้น (รวมถึงเขตเวลา) และจะถูกกักกันหากเกิน 31 วันที่ผ่านมาหรือในอนาคตตามเวลาปัจจุบัน
• attributes, eventAttributes และ hiveAttributes ไม่สามารถใช้เป็นชื่อคุณสมบัติที่ผู้ใช้กำหนดได้ (ตัวพิมพ์ไม่เกี่ยวข้อง)
• อนุญาตให้ใช้เฉพาะประเภทตัวเลขและอักขระเป็นค่าแอตทริบิวต์ และสตริงในรูปแบบของวัตถุ JSON อาร์เรย์ และ JSON จะถูกแยกออก
• สำหรับข้อมูลเกี่ยวกับวิธีการตรวจสอบและส่งบันทึกที่ถูกกักกันอีกครั้ง โปรดดูที่ การแยกข้อมูล

เมนูที่เกี่ยวข้อง¶

• การส่งผ่านกิจกรรม — คำแนะนำเกี่ยวกับแนวคิดเกี่ยวกับกิจกรรม/ทรัพย์สิน
• เทมเพลตกิจกรรม — รายการกิจกรรมเริ่มต้นที่รวบรวมโดยอัตโนมัติตามหมวดหมู่
• การส่งบันทึกเหตุการณ์ — วิธีการส่งข้อมูลผ่าน Hive SDK v4, Hive Axyl, Fluentd, HTTP
• โครงสร้างการจัดเก็บข้อมูลเหตุการณ์ — โครงสร้างตาราง คุณสมบัติโดยละเอียด attributes การแยกข้อมูล