กำหนดโครงสร้างการเก็บล็อกด้วยเทมเพลตอีเวนต์: การส่งล็อกอีเวนต์ ตอนที่ 1

Hive Analytics · 22 ตุลาคม 2569 · อ่าน 5 นาที

Hive Analytics มีเทมเพลตอีเวนต์สำหรับพฤติกรรมผู้ใช้ที่มักต้องใช้ในการวิเคราะห์เกม ในเทมเพลตมีชื่ออีเวนต์และพร็อพเพอร์ตี้กำหนดไว้ล่วงหน้าแล้ว จึงกำหนดโครงสร้างการเก็บล็อกได้โดยไม่ต้องออกแบบโครงสร้างอีเวนต์ใหม่ทั้งหมด ผู้รับผิดชอบงานวิเคราะห์เลือกอีเวนต์ใน Data > Event เพื่อดูตัวชี้วัดที่ใช้ได้ แก้ไขหรือเพิ่มพร็อพเพอร์ตี้ที่กำหนดไว้ใน Property Setting แล้วตรวจสอบซอร์สโค้ดที่เหมาะกับสภาพแวดล้อมการพัฒนาใน Source Generation ก่อนขอให้เริ่มพัฒนาจริง ให้ส่งล็อกทดสอบเพื่อตรวจสอบว่าข้อมูลถูกเก็บตามโครงสร้างที่ตั้งใจไว้

ทำไมล็อกอีเวนต์ของเกมจึงต้องมีคำจำกัดความที่สอดคล้องกัน

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

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

เทมเพลตอีเวนต์ของ Hive Analytics คืออะไร

เทมเพลตอีเวนต์ของ Hive Analytics เป็นฟีเจอร์ที่ให้พฤติกรรมที่มักต้องใช้ในการวิเคราะห์เกมในรูปแบบที่กำหนดชื่ออีเวนต์และพร็อพเพอร์ตี้ไว้ล่วงหน้า ก่อนดูเทมเพลตอีเวนต์ มาทำความเข้าใจคำศัพท์หลักที่ใช้ในการเก็บล็อกกันก่อน

คำศัพท์	คำอธิบาย
อีเวนต์	หน่วยข้อมูลที่บันทึกพฤติกรรมเฉพาะที่ผู้ใช้ทำในเกม ประกอบด้วยข้อมูลว่าใครทำอะไรเมื่อไร
พร็อพเพอร์ตี้	ข้อมูลรายละเอียดที่บันทึกพร้อมกับอีเวนต์ แสดงว่าพฤติกรรมเกิดขึ้นภายใต้เงื่อนไขใดและด้วยค่าใด
ซอร์สโค้ด	โค้ดที่สร้างขึ้นอัตโนมัติตามสภาพแวดล้อมการพัฒนาในแท็บ Source Generation เพื่อส่งอีเวนต์ไปยัง Hive Analytics

หน้าจอแท็บ Basic Info ของอีเวนต์ app_login ที่แสดงชื่ออีเวนต์ หมวดหมู่ และคำอธิบาย — ดูเวลาที่ส่งอีเวนต์ `app_login` ได้ในแท็บ Basic Info ดูพร็อพเพอร์ตี้ใน Property Setting และดูซอร์สโค้ดใน Source Generation

เทมเพลตอีเวนต์รวมอีเวนต์อย่างการล็อกอินและการซื้อที่ถูกเก็บโดยอัตโนมัติเมื่อเชื่อมต่อ Hive SDK ไว้ด้วย อีเวนต์ในเทมเพลตมีชื่ออีเวนต์และพร็อพเพอร์ตี้กำหนดไว้ล่วงหน้าใน Data > Event จึงนำไปใช้ได้โดยไม่ต้องออกแบบโครงสร้างใหม่ทั้งหมด และเมื่อส่งล็อกเสร็จก็เริ่มวิเคราะห์ตามอีเวนต์ใน Hive Analytics ได้ทันที แม้จะส่งล็อกโดยไม่ได้ลงทะเบียนอีเวนต์หรือพร็อพเพอร์ตี้ไว้ก่อน ก็ยังนำไปใช้ใน Hive Analytics ได้

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

หน้าจอรายการอีเวนต์การเล่นเกมในเมนู Data ของ Hive Analytics — ดูชื่ออีเวนต์ คำอธิบาย วันที่เก็บข้อมูลล่าสุด และสถานะการใช้งานได้ในรายการอีเวนต์

เมื่อเลือกอีเวนต์ จะเห็นตัวชี้วัดที่สร้างได้จากอีเวนต์นั้น ใน Property Setting ให้ตรวจสอบรายการที่กำหนดไว้ แล้วแก้ไขหรือเพิ่มพร็อพเพอร์ตี้ใหม่ให้ตรงกับวัตถุประสงค์การวิเคราะห์ เมื่อตั้งค่าพร็อพเพอร์ตี้เสร็จแล้ว เลือกสภาพแวดล้อมการพัฒนาของเกมใน Source Generation ก็จะเห็นซอร์สโค้ดที่รวมอีเวนต์และพร็อพเพอร์ตี้ที่ตั้งไว้

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

ผู้รับผิดชอบงานวิเคราะห์เลือกอีเวนต์ที่ตรงกับพฤติกรรมที่จะวิเคราะห์ และเตรียมพร็อพเพอร์ตี้กับซอร์สโค้ดสำหรับส่งล็อกตามลำดับต่อไปนี้

เลือกอีเวนต์
หาเทมเพลตอีเวนต์ที่ตรงกับพฤติกรรมที่ต้องการวิเคราะห์
ตั้งค่าพร็อพเพอร์ตี้
ตรวจสอบพร็อพเพอร์ตี้ที่กำหนดไว้ แล้วแก้ไขหรือเพิ่มพร็อพเพอร์ตี้ที่จำเป็น
สร้างซอร์สโค้ด
เลือกสภาพแวดล้อมการพัฒนาของเกมเพื่อสร้างซอร์สโค้ดที่รวมอีเวนต์และพร็อพเพอร์ตี้ที่ตั้งไว้

เตรียมอีเวนต์การเล่นคอนเทนต์สำเร็จด้วย contents_success

หากต้องการวิเคราะห์จำนวนผู้ใช้ที่เล่นคอนเทนต์สำเร็จและเวลาเล่นเฉลี่ย ต้องเตรียมอีเวนต์ contents_success และซอร์สโค้ดสำหรับส่งล็อก ขั้นตอนตั้งแต่เลือกอีเวนต์จนถึงสร้างซอร์สโค้ดมีดังนี้

เลือกอีเวนต์

เลือก contents_success ใน Data > Event แล้วดูคำอธิบาย contents_success เป็นอีเวนต์ที่เกิดขึ้นเมื่อผู้ใช้เล่นคอนเทนต์ในเกมสำเร็จ และใช้สร้างตัวชี้วัด เช่น จำนวนครั้งที่เล่นสำเร็จ จำนวนผู้ใช้ที่เล่นสำเร็จ เวลาเล่นเฉลี่ย และคะแนนเฉลี่ย ผู้รับผิดชอบงานวิเคราะห์ใช้ข้อมูลนี้เลือกตัวชี้วัดที่จะใช้ และกำหนดให้ชัดเจนว่าอีเวนต์ควรเกิดขึ้นเมื่อใดในเกม

หน้าจออีเวนต์ contents_success ที่แสดงแท็บ Basic Info, Property Setting, Data Preview และ Source Generation — ดูความหมายของอีเวนต์และตัวชี้วัดที่ใช้ได้ใน Basic Info ของ `contents_success`

ตั้งค่าพร็อพเพอร์ตี้

ใน Property Setting ให้ตรวจสอบพร็อพเพอร์ตี้ที่กำหนดไว้สำหรับ contents_success พร้อมคำอธิบายและชนิดข้อมูลของแต่ละพร็อพเพอร์ตี้ พร็อพเพอร์ตี้จะถูกใช้ในภายหลังเพื่อกำหนดค่าที่วัด ค่ามิติ และเงื่อนไขตัวกรองเมื่อสร้างกราฟใน Create ใน contents_success มี market และ hive_country ที่แสดงสภาพแวดล้อมการใช้งาน userId และ deviceId ที่ใช้ระบุตัวผู้ใช้ และ characterLv กับ modeTypeId ที่แสดงเงื่อนไขโดยละเอียดของการเล่นคอนเทนต์สำเร็จ

appId, appIdGroup, dateTime, userId, deviceId, eventName, eventTime และ identifierProvider เป็นพร็อพเพอร์ตี้ส่วนกลางที่ระบบจัดการ และแก้ไขใน Property Setting ไม่ได้ ในจำนวนนี้ userId, deviceId, identifierProvider, eventTime, eventName และ appId หรือ appIdGroup เป็นพร็อพเพอร์ตี้บังคับที่ต้องใส่ทุกครั้งเมื่อส่งล็อกอีเวนต์ ส่วน dateTime คือเวลาที่บันทึกหลังแปลง eventTime ที่ส่งมาเป็น UTC

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

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

สร้างซอร์สโค้ด

เมื่อตั้งค่าพร็อพเพอร์ตี้เสร็จแล้ว ให้เลือกวิธีการพัฒนาฝั่งไคลเอนต์หรือเซิร์ฟเวอร์ใน Source Generation และระบุสภาพแวดล้อมการพัฒนาที่เกมใช้จริง ซอร์สโค้ดที่สร้างขึ้นจะมีชื่ออีเวนต์และพร็อพเพอร์ตี้ที่ตั้งไว้ ผู้รับผิดชอบงานวิเคราะห์จึงตรวจสอบว่ารายการที่จำเป็นต่อการพัฒนาถูกใส่ไว้ถูกต้องหรือไม่

ซอร์สโค้ดที่สร้างขึ้นส่งต่อให้นักพัฒนาใช้พัฒนาฟังก์ชันส่งล็อกจริงได้ ก่อนขอให้เริ่มพัฒนา สามารถส่งล็อกทดสอบเพื่อตรวจสอบล่วงหน้าว่าอีเวนต์และพร็อพเพอร์ตี้ถูกเก็บตามโครงสร้างที่ตั้งใจไว้ และข้อมูลนั้นสร้างตัวชี้วัดที่ต้องการได้หรือไม่ วิธีตรวจสอบด้วยล็อกทดสอบจะอธิบายโดยละเอียดใน "ตรวจสอบโครงสร้างการเก็บข้อมูลและตัวชี้วัดด้วยล็อกทดสอบ: การส่งล็อกอีเวนต์ ตอนที่ 2"

เริ่มต้นใช้งาน Hive Analytics

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

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