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

iOS+ Android เว็บ Flutter

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

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

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

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

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

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

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

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

หมายเหตุ: หากต้องการดูรายละเอียดสูงสุดในรายงาน ให้บันทึกเหตุการณ์ที่แนะนําซึ่งเหมาะกับแอปของคุณและพารามิเตอร์ที่กําหนดไว้ นอกจากนี้ คุณยังจะได้รับประโยชน์จากฟีเจอร์ล่าสุดของ Google Analytics ทันทีที่พร้อมใช้งาน

ดูรายละเอียดการใช้งานประเภทเหตุการณ์ที่แนะนําได้ที่ตำแหน่งต่อไปนี้

• เหตุการณ์ที่แนะนํา: ดูข้อมูลอ้างอิงคลาส com.google.firebase.analytics.FirebaseAnalytics.Event
• พารามิเตอร์ที่กําหนดไว้: ดูข้อมูลอ้างอิง com.google.firebase.analytics.FirebaseAnalytics.Param

ตัวอย่างต่อไปนี้แสดงวิธีบันทึกเหตุการณ์ 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")
}
MainActivity.kt

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);
MainActivity.java

นอกเหนือจากพารามิเตอร์ที่กําหนดไว้แล้ว คุณยังเพิ่มพารามิเตอร์ต่อไปนี้ลงในเหตุการณ์ใดก็ได้

• พารามิเตอร์ที่กําหนดเอง: พารามิเตอร์ที่กําหนดเองสามารถใช้เป็นมิติข้อมูลหรือเมตริกในรายงาน 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)
}
MainActivity.kt

Java

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

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

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

ดูเหตุการณ์ในหน้าแดชบอร์ด

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

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