Google Analytics รวบรวมข้อมูลการใช้งานและพฤติกรรมสำหรับแอปของคุณ SDK บันทึกข้อมูลหลักสองประเภท:
- เหตุการณ์: สิ่งที่เกิดขึ้นในแอปของคุณเช่นการกระทำของผู้ใช้เหตุการณ์ของระบบหรือข้อผิดพลาด
- คุณสมบัติของผู้ใช้: แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มของฐานผู้ใช้ของคุณเช่นค่ากำหนดภาษาหรือตำแหน่งทางภูมิศาสตร์
Analytics จะบันทึก เหตุการณ์ และ คุณสมบัติของผู้ใช้ โดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มรหัสใด ๆ เพื่อเปิดใช้งาน
ก่อนที่คุณจะเริ่ม
หากคุณยังไม่ได้ดำเนินการให้ เพิ่ม Firebase ในโครงการ Android ของคุณ และตรวจสอบให้แน่ใจว่าได้เปิดใช้ Google Analytics ในโครงการ Firebase ของคุณแล้ว:
หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ให้เปิดใช้ Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์
หากคุณใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่ได้เปิดใช้งาน Google Analytics ให้ไปที่แท็บ การผสานรวม ของ ของคุณ> การตั้งค่าโปรเจ็กต์ เพื่อเปิดใช้งาน
เมื่อคุณเปิดใช้งาน Google Analytics ในโครงการของคุณแอป Firebase ของคุณจะเชื่อมโยงกับสตรีมข้อมูล Google Analytics
เพิ่ม Analytics SDK ลงในแอปของคุณ
ใช้ Firebase Android BoM ประกาศการอ้างอิงสำหรับไลบรารี Android Analytics ใน ไฟล์ Gradle ของ โมดูล ของคุณ (ระดับแอป) (โดยทั่วไปคือ
app/build.gradle
)Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:26.6.0') // Declare 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 เวอร์ชันที่เข้ากันได้เสมอ
(ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM
หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง
โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้
dependencies { // Declare 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:18.0.2' }
โคตรลิน + KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:26.6.0') // Declare 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-ktx' }
เมื่อใช้ Firebase Android BoM แอปของคุณจะใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้เสมอ
(ทางเลือก) ประกาศการอ้างอิงไลบรารี Firebase โดยไม่ต้อง ใช้ BoM
หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการอ้างอิง
โปรดทราบว่าหากคุณใช้ไลบรารี Firebase หลาย ไลบรารีในแอปของคุณเราขอแนะนำอย่างยิ่งให้ใช้ BoM เพื่อจัดการเวอร์ชันไลบรารีซึ่งจะช่วยให้มั่นใจได้ว่าทุกเวอร์ชันจะเข้ากันได้
dependencies { // Declare 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-ktx:18.0.2' }
ประกาศออบเจ็กต์
com.google.firebase.analytics.FirebaseAnalytics
ที่ด้านบนของกิจกรรมของคุณ:Java
private FirebaseAnalytics mFirebaseAnalytics;
โคตรลิน + KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
เริ่มต้นใน
onCreate()
:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
โคตรลิน + KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
เริ่มบันทึกเหตุการณ์
หลังจากที่คุณสร้างอินสแตนซ์ FirebaseAnalytics
คุณสามารถเริ่มบันทึกเหตุการณ์ด้วย logEvent()
แนะนำให้ใช้ บางเหตุการณ์ สำหรับทุกแอพ แนะนำให้ใช้ประเภทอื่น ๆ สำหรับประเภทธุรกิจหรือประเภทธุรกิจที่เฉพาะเจาะจง คุณควรส่งเหตุการณ์ที่แนะนำพร้อมกับพารามิเตอร์ที่กำหนดไว้เพื่อให้แน่ใจว่ามีรายละเอียดสูงสุดในรายงานของคุณและเพื่อรับประโยชน์จากคุณสมบัติในอนาคตและการผสานรวมเมื่อพร้อมใช้งาน ส่วนนี้สาธิตการบันทึกเหตุการณ์ที่กำหนดไว้ล่วงหน้าสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการบันทึกเหตุการณ์โปรดดู บันทึกเหตุการณ์
รหัสต่อไปนี้บันทึกเหตุการณ์ 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") }
คุณสามารถเปิดใช้งานการบันทึกแบบละเอียดเพื่อตรวจสอบการบันทึกเหตุการณ์โดย 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
คำสั่งนี้แสดงเหตุการณ์ของคุณใน Android Studio logcat ช่วยให้คุณตรวจสอบได้ทันทีว่ามีการส่งเหตุการณ์
ขั้นตอนถัดไป
- ใช้ DebugView เพื่อตรวจสอบเหตุการณ์ของคุณ
- สำรวจข้อมูลของคุณใน คอนโซล Firebase
- สำรวจคำแนะนำเกี่ยวกับ เหตุการณ์ และ คุณสมบัติของผู้ใช้
- เรียนรู้วิธีส่งออกข้อมูลไปยัง BigQuery