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


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

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

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

ก่อนเริ่มต้น

ตรวจสอบว่าคุณตั้งค่าโปรเจ็กต์แล้วและเข้าถึง 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 ค้นหาตัวอย่างคำค้นหาและอื่นๆ อีกมากมาย ที่ BigQuery Export ของ Google Analytics 4

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