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