Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

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

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

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

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

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

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

ตัวอย่างต่อไปนี้สาธิตวิธีบันทึกเหตุการณ์ SELECT_CONTENT :

Kotlin+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")
}

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);

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

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

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

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

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

Kotlin+KTX

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

Java

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

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

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

เช่นเดียวกับพารามิเตอร์ที่กำหนดเอง ให้ลงทะเบียนพารามิเตอร์เหตุการณ์เริ่มต้นเพื่อให้แน่ใจว่าปรากฏในรายงาน Analytics

Kotlin+KTX

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.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 แดชบอร์ดนี้แสดงรายงานเหตุการณ์ที่สร้างขึ้นโดยอัตโนมัติสำหรับเหตุการณ์แต่ละประเภทที่แอปของคุณบันทึกไว้