Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

ก่อนจะเริ่ม

ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าโครงการของคุณและสามารถเข้าถึง Analytics ที่อธิบายไว้ใน การเริ่มต้นด้วย Analytics

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

หลังจากที่คุณได้สร้าง FirebaseAnalytics ตัวอย่างเช่นคุณสามารถใช้มันเพื่อบันทึกเหตุการณ์กับ logEvent() วิธีการ

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

คุณสามารถดูรายละเอียดการใช้งานสำหรับประเภทเหตุการณ์ที่แนะนำในตำแหน่งต่อไปนี้:

ตัวอย่างต่อไปนี้แสดงให้เห็นถึงวิธีการล็อก SELECT_CONTENT เหตุการณ์:

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

คอตลิน+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

นอกเหนือจากพารามิเตอร์ที่กำหนด คุณสามารถเพิ่มพารามิเตอร์ต่อไปนี้ในเหตุการณ์ใดก็ได้:

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

  • VALUE พารามิเตอร์: VALUE เป็นพารามิเตอร์ที่ใช้งานทั่วไปที่เป็นประโยชน์สำหรับการสะสมตัวชี้วัดที่สำคัญที่เกี่ยวข้องกับเหตุการณ์ ตัวอย่าง ได้แก่ รายได้ ระยะทาง เวลา และคะแนน

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

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

คอตลิน+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

ตั้งค่าพารามิเตอร์เหตุการณ์เริ่มต้น

คุณสามารถเข้าสู่ระบบพารามิเตอร์ข้ามเหตุการณ์ใช้ setDefaultEventParameters พารามิเตอร์เริ่มต้นเชื่อมโยงกับเหตุการณ์ในอนาคตทั้งหมดที่บันทึกไว้

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

คอตลิน+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

หากมีการระบุไว้ในพารามิเตอร์ใน logEvent() วิธีค่าที่ถูกนำมาใช้แทนการเริ่มต้น

เพื่อล้างพารามิเตอร์เริ่มต้นเรียก setDefaultEventParameters วิธีกับชุดพารามิเตอร์ null

ดูเหตุการณ์ในบันทึกการดีบักของ 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 ช่วยให้คุณตรวจสอบได้ทันทีว่ามีการส่งกิจกรรม

ดูกิจกรรมในแดชบอร์ด

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

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