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

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


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

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

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

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

หน้าการวิเคราะห์ > เหตุการณ์จะแสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์ 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);

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