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

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

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() ได้

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

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

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 ซึ่งจะช่วยให้คุณยืนยันได้ทันทีว่าระบบกำลังส่งเหตุการณ์

iOS+

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

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

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

วิธีเข้าถึงข้อมูลนี้ในFirebase Console

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

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