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

ส่งงาน

เหตุการณ์คืออะไร?

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

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

สำหรับข้อมูลเกี่ยวกับวิธีการส่งเหตุการณ์ โปรดดูที่ ส่งบันทึกเหตุการณ์

กฎการตั้งชื่อเหตุการณ์

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

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

ชื่อเหตุการณ์ที่ไม่เป็นไปตามกฎข้างต้นอาจถูกจำกัดการใช้งานในการวิเคราะห์

คุณสมบัติคืออะไร?

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

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

สำหรับข้อมูลเกี่ยวกับวิธีการส่งคุณสมบัติพร้อมกับเหตุการณ์ โปรดดูที่ การส่งคุณสมบัติของเหตุการณ์

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

เราขอแนะนำให้ตั้งชื่อคีย์ของแอตทริบิวต์ที่ผู้ใช้กำหนด (eventAttributes) ตามกฎด้านล่าง

  • อักขระที่แนะนำ: ตัวอักษรภาษาอังกฤษ (a–z, A–Z, แยกตัวพิมพ์เล็กและใหญ่), ตัวเลข (0–9), ขีดล่าง (_)
  • อักขระตัวแรก: เริ่มต้นด้วยตัวอักษรภาษาอังกฤษ
  • ตัวคั่น: คั่นคำด้วยขีดล่าง (_) แทนการเว้นวรรค
  • ตัวอย่าง: item_id, contentsType, stage_level
Warning
  • คีย์แอตทริบิวต์ที่ไม่เป็นไปตามกฎข้างต้นอาจถูกจำกัดการใช้งานในการวิเคราะห์
  • attributes, eventAttributes และ hiveAttributes เป็นคำสงวน แอตทริบิวต์ที่ใช้คำเหล่านี้เป็นชื่อจะถูกแยก สำหรับรายละเอียด โปรดดูที่ การส่งคุณสมบัติของเหตุการณ์

ตัวอย่างของเหตุการณ์ที่ออกแบบตามโครงสร้างเหตุการณ์สามารถพบได้ใน เทมเพลตเหตุการณ์

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

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

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