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

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


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

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

สิ่งที่ควรทราบเกี่ยวกับแดชบอร์ดนี้มีดังนี้

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

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

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