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

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

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 จากคอนโซล แล้วย้ายไฟล์เหล่านั้นไปยังโปรเจ็กต์ Unity)

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

หลังจากเริ่มต้นโมดูล Firebase.Analytics.FirebaseAnalytics แล้ว คุณจะใช้โมดูลดังกล่าวเพื่อบันทึกเหตุการณ์ด้วยเมธอด LogEvent() ได้

เพื่อช่วยให้คุณเริ่มต้นใช้งาน Analytics SDK ได้ เราได้กําหนดเหตุการณ์ที่แนะนําจํานวนหนึ่งซึ่งพบได้ทั่วไปในแอปประเภทต่างๆ ซึ่งรวมถึงแอปค้าปลีกและอีคอมเมิร์ซ การเดินทาง และเกม ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์เหล่านี้และกรณีที่ควรใช้ได้ที่บทความเหตุการณ์ที่แนะนําในศูนย์ช่วยเหลือของ Google Analytics

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

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

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

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