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

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

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

ก่อนที่คุณจะเริ่มต้น

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