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