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

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

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);

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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

ดูเหตุการณ์การวิเคราะห์ในหน้าแดชบอร์ด

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

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

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

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