เริ่มต้นใช้งาน Google Analytics

การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม 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 ลงในแอป

  1. ในไฟล์ 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")
}
    หากกำลังมองหาโมดูลไลบรารีสำหรับ Kotlin โดยเฉพาะ จะเริ่มต้นใน ตุลาคม 2023 (Firebase BoM 32.5.0) ทั้งนักพัฒนา Kotlin และ Java สามารถ ขึ้นอยู่กับโมดูลไลบรารีหลัก (ดูรายละเอียดได้ที่ คําถามที่พบบ่อยเกี่ยวกับโครงการริเริ่มนี้)

  2. ประกาศออบเจ็กต์ com.google.firebase.analytics.FirebaseAnalytics ที่ส่วน ด้านบนของกิจกรรมของคุณ:

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. เริ่มต้นในเมธอด onCreate() ดังนี้

    Kotlin+KTX 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

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

หลังจากสร้างอินสแตนซ์ 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")
}
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

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

ขั้นตอนถัดไป