การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม Google Analytics ลงในแอปและ เริ่มบันทึกเหตุการณ์
Google Analytics จะรวบรวมข้อมูลการใช้งานและพฤติกรรมของแอป SDK จะบันทึกข้อมูล 2 ประเภทหลัก ได้แก่
- เหตุการณ์: สิ่งที่เกิดขึ้นในแอป เช่น การกระทำของผู้ใช้ ระบบ เหตุการณ์ หรือข้อผิดพลาด
- พร็อพเพอร์ตี้ผู้ใช้: แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มของ ฐานผู้ใช้ เช่น ค่ากำหนดภาษาหรือสถานที่ตั้งทางภูมิศาสตร์
Analytics จะบันทึกบางรายการโดยอัตโนมัติ กิจกรรมและ พร็อพเพอร์ตี้ผู้ใช้ คุณไม่จำเป็นต้องเพิ่มโค้ดใดๆ เพื่อเปิดใช้
ก่อนเริ่มต้น
เพิ่ม Firebase ลงใน Android หากยังไม่ได้เพิ่ม โปรเจ็กต์ และตรวจสอบว่า Google Analytics มีการ ที่เปิดใช้ในโปรเจ็กต์ Firebase:
หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์
หากคุณกำลังใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่มี เปิดใช้งาน Google Analytics แล้ว ให้ไปที่ การผสานรวม ของ
เพื่อเปิดใช้ > การตั้งค่าโปรเจ็กต์
เมื่อคุณเปิดใช้ Google Analytics ในโปรเจ็กต์ แอป Firebase จะ ลิงก์กับสตรีมข้อมูล Google Analytics รายการแล้ว
เพิ่ม SDK Analytics ลงในแอป
ในไฟล์ Gradle ของโมดูล (ระดับแอป) (ปกติ
<project>/<app-module>/build.gradle.kts
หรือ<project>/<app-module>/build.gradle
) เพิ่มทรัพยากร Dependency สำหรับไลบรารี Analytics สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันไลบรารีdependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
เมื่อใช้Firebase Android BoM แอปจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ
(ทางเลือก) เพิ่มทรัพยากร Dependency ของไลบรารี Firebase โดยไม่ใช้ BoM
หากเลือกไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันไลบรารี Firebase แต่ละเวอร์ชัน ในบรรทัดทรัพยากร Dependency
โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลายรายการในแอป เราขอแนะนำอย่างยิ่ง แนะนำให้ใช้ BoM ในการจัดการเวอร์ชันไลบรารี เพื่อให้มั่นใจว่าทุกเวอร์ชัน ที่เข้ากันได้
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:22.0.2") }
ประกาศออบเจ็กต์
com.google.firebase.analytics.FirebaseAnalytics
ที่ส่วน ด้านบนของกิจกรรมของคุณ:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
เริ่มต้นในเมธอด
onCreate()
ดังนี้Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
เริ่มบันทึกเหตุการณ์
หลังจากสร้างอินสแตนซ์ FirebaseAnalytics
แล้ว คุณจะเริ่มบันทึกได้
ด้วยเมธอด logEvent()
บางเหตุการณ์ แนะนำสำหรับแอปทั้งหมด คำแนะนำอื่นๆ สำหรับประเภทธุรกิจหรือประเภทธุรกิจที่เฉพาะเจาะจง คุณควรส่ง เหตุการณ์ที่แนะนำ พร้อมกับพารามิเตอร์ที่กําหนด เพื่อให้ได้ รายละเอียดที่มีอยู่ในรายงาน และเพื่อใช้ประโยชน์จากฟีเจอร์และ การผสานรวมทันทีที่พร้อมให้บริการ ส่วนนี้จะสาธิตการบันทึก เหตุการณ์ที่กำหนดไว้ล่วงหน้า ดูข้อมูลเพิ่มเติมเกี่ยวกับเหตุการณ์การบันทึกได้ที่ บันทึกเหตุการณ์
โค้ดต่อไปนี้จะบันทึกเหตุการณ์ 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);
คุณสามารถเปิดใช้การบันทึกที่มีข้อมูลขนาดใหญ่เพื่อตรวจสอบการบันทึกเหตุการณ์โดย 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 ซึ่งจะช่วยคุณ ตรวจสอบได้ในทันทีว่ามีการส่งเหตุการณ์
ขั้นตอนถัดไป
- ทำความเข้าใจรายงาน Analytics แต่ละรายการ
- ใช้ DebugView เพื่อยืนยันเหตุการณ์
- สำรวจข้อมูลในคอนโซล Firebase
- ดูคำแนะนำเกี่ยวกับกิจกรรม และ พร็อพเพอร์ตี้ผู้ใช้
- ดูวิธีส่งออกข้อมูลไปยัง BigQuery