คู่มือการออกแบบและส่งอีเวนต์¶

อีเวนต์เท็กโซโนมีคืออะไร?¶

Event Taxonomy คือ ระบบการจำแนกที่จัดโครงสร้างอีเวนต์และแอตทริบิวต์ที่เก็บมาอย่างเป็นระบบด้วยโครงสร้างที่สอดคล้องกันและกฎการตั้งชื่อที่เป็นมาตรฐาน

หากเก็บข้อมูลพฤติกรรมมากมายที่เกิดขึ้นในเกม เช่น การเข้าสู่ระบบ การซื้อ การอัปเลเวล โดยไม่มีหลักเกณฑ์ ทีมต่าง ๆ อาจส่งข้อมูลชุดเดียวกันภายใต้ชื่อที่ต่างกัน หรือไม่สามารถเข้าใจได้ว่าเมื่อวิเคราะห์แล้ว ข้อมูลใดหมายถึงอะไร Event Taxonomy ช่วยป้องกันความสับสนเช่นนี้ และทำให้ใช้ข้อมูลที่เก็บมาแล้วในการวิเคราะห์ได้ทันที

ทำไมจึงจำเป็น?¶

โครงสร้าง¶

Event Taxonomy ของ Analytics ประกอบด้วย 2 ชั้น คือ อีเวนต์ และ แอตทริบิวต์

อีเวนต์ (Event)
├── แอตทริบิวต์แพลตฟอร์ม (Platform Attribute)   ← เก็บอัตโนมัติจากการเชื่อมต่อ SDK เท่านั้น
└── แอตทริบิวต์อีเวนต์ (Event Attribute)      ← ส่งพร้อมอีเวนต์โดยตรง

อีเวนต์คืออะไร?¶

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

• ตัวอย่าง: ผู้ใช้ซื้อไอเท็ม → เกิดอีเวนต์ item_purchase
• ตัวอย่าง: ผู้ใช้เคลียร์สเตจหนึ่งได้ → เกิดอีเวนต์ stage_clear
• ตัวอย่าง: ผู้ใช้เข้าสู่ระบบแอป → เกิดอีเวนต์ login

แอตทริบิวต์คืออะไร?¶

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

• ตัวอย่าง: แอตทริบิวต์ของอีเวนต์ item_purchase → รหัสไอเท็ม ยอดชำระ สกุลเงิน
• ตัวอย่าง: แอตทริบิวต์ของอีเวนต์ stage_clear → หมายเลขสเตจ เวลาเคลียร์ ตัวละครที่ใช้

แอตทริบิวต์แบ่งเป็น 2 ประเภทตามผู้ส่งข้อมูล

• แอตทริบิวต์แพลตฟอร์ม: แอตทริบิวต์ที่ Hive เก็บเป็นค่าพื้นฐานโดยไม่ต้องตั้งค่าเพิ่มเติม เพียงเชื่อมต่อ SDK ก็เพียงพอ เช่น ประเทศ OS เวอร์ชันแอป หรือรหัสเซิร์ฟเวอร์
• แอตทริบิวต์อีเวนต์: แอตทริบิวต์ที่ส่งพร้อมกับอีเวนต์โดยตรง คุณกำหนดและส่งรายการที่จำเป็นต่อการวิเคราะห์ได้เอง

การส่งอีเวนต์ที่ผู้ใช้กำหนดเอง¶

สามารถส่งอีเวนต์ที่กำหนดเองในเกมเองตามสคีมาการเก็บข้อมูลด้านล่าง เพื่อให้นำไปใช้ในการวิเคราะห์ใน Analytics ได้

การส่งข้อมูลจริงใช้วิธี Hive SDK client log transmission สามารถสร้างซอร์สโค้ดที่จำเป็นสำหรับการส่งได้อัตโนมัติตามภาษาในแท็บ [สร้างซอร์ส] ของ อีเวนต์

หากกำหนดชื่ออีเวนต์และแอตทริบิวต์ไว้ล่วงหน้าใน อีเวนต์ ก่อนส่ง จะสะดวกต่อการแชร์และจัดการภายในทีม อย่างไรก็ตาม แม้จะส่งข้อมูลโดยไม่กำหนดไว้ล่วงหน้า Analytics ก็จะรับรู้ข้อมูลที่ได้รับโดยอัตโนมัติ และจะสะท้อนในรายการอีเวนต์ภายในไม่เกิน 1 ชั่วโมง

สคีมาการเก็บข้อมูลของ Analytics¶

นี่คือสคีมาพื้นฐานที่ใช้เมื่อส่งอีเวนต์ที่ผู้ใช้กำหนดเอง ทุกอีเวนต์ต้องส่งในรูปแบบด้านล่าง

กฎการตั้งชื่ออีเวนต์¶

แนะนำให้ตั้งชื่ออีเวนต์ที่จะใช้ใน eventName ตามกฎต่อไปนี้

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

ตัวอย่างโครงสร้างของ hiveAttribute / eventAttribute¶

hiveAttribute และ eventAttribute จะถูกส่งในรูปแบบอ็อบเจ็กต์ JSON แยกกัน

hiveAttribute — แอตทริบิวต์แพลตฟอร์มจากเซิร์ฟเวอร์ provisioning ของ Hive โดยมีข้อมูลเช่นมาร์เก็ตหรือรหัสเซิร์ฟเวอร์ และปัจจุบันผู้พัฒนาต้องกำหนดค่าและส่งเอง ก่อนที่จะเปลี่ยนเป็นการเก็บอัตโนมัติในอนาคต

{
  "market": "GO",
  "serverId": "Asia"
}

eventAttribute — แอตทริบิวต์ที่ส่งพร้อมกับอีเวนต์โดยตรง เก็บรายละเอียดที่จำเป็นต่อการวิเคราะห์อีเวนต์นั้น

{
  "level": "100",
  "contentsType": "dungeon"
}

กฎการตั้งชื่อแอตทริบิวต์¶

แนะนำให้ตั้งชื่อคีย์ของ eventAttribute และ hiveAttribute ตามกฎต่อไปนี้

• อักขระที่แนะนำ: ตัวอักษรภาษาอังกฤษ(a–z, A–Z, แยกตัวพิมพ์เล็ก/ใหญ่), ตัวเลข(0–9), ขีดล่าง(_), ขีดกลาง(-)
• ตัวคั่น: ใช้ขีดล่าง(_) แทนการเว้นวรรคระหว่างคำ
• ตัวอย่าง: item_id, contents-type, stage_level

กฎการแปลงคีย์ของแอตทริบิวต์¶

เมื่อส่งแอตทริบิวต์ ระบบจะเปลี่ยนชื่อคีย์บางรายการอัตโนมัติตามกฎด้านล่าง โปรดระวังว่าในการวิเคราะห์ ชื่อคีย์ที่ใช้ค้นหาอาจแตกต่างไป

คำต่อท้าย -Hive (hiveAttribute)¶

คีย์ ทุกรายการใน hiveAttribute จะถูกเติม -Hive ต่อท้ายอัตโนมัติ

คำต่อท้าย -Event (eventAttribute)¶

คีย์ใน eventAttribute จะถูกเติม -Event อัตโนมัติเฉพาะกรณีที่ชื่อซ้ำกับ 8 ฟิลด์ส่วนกลาง ด้านล่างเท่านั้น

• timezone, dateTime, identifierProvider, userId, deviceId, appId, category, eventName

อีเวนต์แนะนำ¶

ด้านล่างเป็นตัวอย่างอีเวนต์ที่มีประโยชน์สูงต่อการวิเคราะห์ใน Analytics หากส่งแต่ละอีเวนต์ตาม eventName และ eventAttribute ที่กำหนด จะสามารถวิเคราะห์ได้ทันทีด้วยฟีเจอร์ทั้งหมดของ Analytics เช่น ชาร์ต ฟันเนล และรีเทนชัน

การอัปเลเวล¶

eventAttribute (ร่วมกัน):

สกุลเงินในเกม¶

eventAttribute (ร่วมกัน):

คอนเทนต์¶

eventAttribute (ร่วมกัน):

ร้านค้าในแอป¶

eventAttribute (ร่วมกัน):

เมท¶

eventAttribute (ร่วมกัน):

กิจกรรมทางสังคม¶

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

• อีเวนต์ — ลงทะเบียนและจัดการอีเวนต์และแอตทริบิวต์
• เมตริก — บันทึกการตั้งค่าการรวมอีเวนต์ที่ใช้บ่อยเป็นเมตริก