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

เลือกแพลตฟอร์ม: iOS+ Android Web Flutter Unity C++


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

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

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

คุณเข้าถึงข้อมูลนี้ได้ในหน้า Analytics ของคอนโซล Firebase

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

SDK ของ Analytics กำหนดเหตุการณ์ที่แนะนำจำนวนหนึ่งซึ่งพบได้ทั่วไปในแอปประเภทต่างๆ รวมถึงแอปค้าปลีกและอีคอมเมิร์ซ แอปท่องเที่ยว และแอปเกม เพื่อช่วยให้คุณเริ่มต้นใช้งานได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์เหล่านี้ และเวลาที่ควรใช้ได้ที่เหตุการณ์ที่แนะนำ หากต้องการดูรายละเอียดสูงสุดในรายงาน ให้บันทึก เหตุการณ์ 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);

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