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

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

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 ในหน้าแดชบอร์ด

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

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

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

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