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

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


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

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

ก่อนเริ่มต้น

คุณต้องทำสิ่งต่อไปนี้ก่อนจึงจะใช้ Google Analytics ได้

  • ลงทะเบียนโปรเจ็กต์ Unity และกำหนดค่าให้ใช้ Firebase

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

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

  • เพิ่ม Firebase Unity SDK (โดยเฉพาะ FirebaseAnalytics.unitypackage) ลงในโปรเจ็กต์ Unity

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

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

หลังจากเริ่มต้นโมดูล Firebase.Analytics.FirebaseAnalytics แล้ว คุณจะใช้โมดูลดังกล่าวเพื่อบันทึกเหตุการณ์ด้วยเมธอด LogEvent() ได้

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

คุณดูรายละเอียดการติดตั้งใช้งานสําหรับเหตุการณ์ที่แนะนําได้ในตําแหน่งต่อไปนี้

  • เหตุการณ์ที่แนะนํา: ดูรายการค่าคงที่ Event
  • พารามิเตอร์ที่กําหนด: ดูรายการค่าคงที่ Parameters

ตัวอย่างต่อไปนี้แสดงวิธีบันทึกเหตุการณ์ SELECT_CONTENT ที่แนะนํา

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

นอกเหนือจากพารามิเตอร์ที่กําหนดไว้แล้ว คุณยังเพิ่มพารามิเตอร์ต่อไปนี้ลงในเหตุการณ์ใดก็ได้

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

  • VALUE พารามิเตอร์: VALUE เป็นพารามิเตอร์อเนกประสงค์ที่มีประโยชน์สำหรับการสะสมเมตริกหลักที่เกี่ยวข้องกับAnalyticsเหตุการณ์ ตัวอย่างเช่น รายได้ ระยะทาง เวลา และคะแนน

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

ดูเหตุการณ์ในเอาต์พุตบันทึก

iOS+

ระบบจะบันทึกเหตุการณ์ลงในคอนโซล และสามารถดูได้ขณะเรียกใช้แอปผ่าน XCode

Android

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

คุณเปิดใช้การบันทึกแบบละเอียดได้ด้วยชุดคำสั่ง adb ดังนี้

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

คำสั่งนี้จะแสดงเหตุการณ์ใน Logcat ของ Android Studio ซึ่งช่วยให้คุณยืนยันได้ทันทีว่าระบบกำลังส่งเหตุการณ์

ดูเหตุการณ์ Analytics ในแดชบอร์ด

ในคอนโซล Firebase คุณสามารถดูสถิติรวมเกี่ยวกับเหตุการณ์ได้ในแดชบอร์ด Analytics > เหตุการณ์

โปรดทราบข้อมูลต่อไปนี้เกี่ยวกับแดชบอร์ดนี้

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

  • แดชบอร์ดจะอัปเดตเป็นระยะๆ ตลอดทั้งวัน หากต้องการทดสอบทันที ให้ใช้คอนโซลดีบัก Xcode หรือเอาต์พุต Logcat ตามที่อธิบายไว้ในส่วนก่อนหน้าของคู่มือนี้

อ่านข้อมูลเพิ่มเติมเกี่ยวกับแดชบอร์ด