Catch up on highlights from Firebase at Google I/O 2023. Learn more

เริ่มต้นใช้งาน Google Analytics สำหรับ Unity

Google Analytics รวบรวมข้อมูลการใช้งานและพฤติกรรมสำหรับแอปของคุณ SDK จะบันทึกข้อมูลหลักสองประเภท:

  • เหตุการณ์: สิ่งที่เกิดขึ้นในแอปของคุณ เช่น การกระทำของผู้ใช้ เหตุการณ์ของระบบ หรือข้อผิดพลาด
  • พร็อพเพอร์ตี้ผู้ใช้: แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มฐานผู้ใช้ของคุณ เช่น การตั้งค่าภาษาหรือตำแหน่งที่ตั้งทางภูมิศาสตร์

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

ในการเข้าถึงข้อมูลนี้:

  1. ใน คอนโซล Firebase เปิดโครงการของคุณ
  2. เลือก Analytics จากเมนูเพื่อดูแดชบอร์ดการรายงานของ Analytics

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

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

ก่อนที่คุณจะเริ่มต้น

ก่อนที่คุณจะสามารถใช้ Google Analytics คุณต้อง:

  • ลงทะเบียนโครงการ Unity ของคุณและกำหนดค่าเพื่อใช้ Firebase

    • หากโปรเจ็กต์ Unity ของคุณใช้ Firebase อยู่แล้ว แสดงว่ามีการลงทะเบียนและกำหนดค่าสำหรับ Firebase แล้ว

    • หากคุณไม่มีโครงการ Unity คุณสามารถดาวน์โหลด แอปตัวอย่างได้

  • เพิ่ม Firebase Unity SDK (โดยเฉพาะ FirebaseAnalytics.unitypackage ) ในโครงการ Unity ของคุณ

โปรดทราบว่าการเพิ่ม Firebase ในโครงการ Unity ของคุณเกี่ยวข้องกับงานทั้งใน คอนโซล Firebase และในโครงการ Unity แบบเปิดของคุณ (เช่น คุณดาวน์โหลดไฟล์กำหนดค่า Firebase จากคอนโซล จากนั้นย้ายไฟล์เหล่านี้ไปยังโครงการ Unity ของคุณ)

บันทึกเหตุการณ์

คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยเมธอด LogEvent() ได้ทันที

ตัวอย่างต่อไปนี้บันทึกเหตุการณ์ด้วยอาร์กิวเมนต์ประเภทต่างๆ:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

ขั้นตอนถัดไป