Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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 แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์แต่ละประเภทที่แอปของคุณบันทึกไว้