ใช้ Google Analytics เพื่อรับตัวชี้วัดสำหรับรายงานข้อขัดข้อง

Google Analytics เป็นเครื่องมือวิเคราะห์ของ Firebase เมื่อคุณใช้ Analytics และ Crashlytics ร่วมกันในแอป คุณจะได้รับฟีเจอร์ที่ช่วยสร้างปัญหาและติดตามข้อมูลข้อขัดข้องที่มีรายละเอียดมากขึ้น เช่น ผู้ใช้ที่ไม่มีข้อขัดข้อง การแสดงเส้นทางที่ติดตามเหตุการณ์เฉพาะก่อนเกิดข้อขัดข้อง และ BigQuery ที่ คุณสามารถเห็นภาพเมตริกหลักของแอปได้

คู่มือนี้อธิบายวิธีเพิ่ม Analytics ลงในแอปที่มีการตั้งค่า Crashlytics (หากยังไม่ได้ ตั้งค่า ให้เพิ่ม Crashlytics ลงในแอปของคุณ )

ขั้นตอนที่ 1: เพิ่มไฟล์การกำหนดค่า Firebase

  1. เพิ่มไฟล์การกำหนดค่า Firebase Android ลงในแอปของคุณ:

    1. เปิด การตั้งค่าโครงการ ของคุณ ในการ์ด แอปของคุณ ให้เลือกชื่อแพ็คเกจของแอปที่คุณต้องการไฟล์การกำหนดค่า

    2. คลิก ดาวน์โหลด google-services.json เพื่อรับไฟล์กำหนดค่า Firebase Android ของคุณ ( google-services.json )

      • คุณสามารถดาวน์โหลด ไฟล์กำหนดค่า Firebase Android อีกครั้งได้ทุกเมื่อ
      • ตรวจสอบให้แน่ใจว่าไฟล์กำหนดค่าไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

    3. ย้ายไฟล์กำหนดค่าของคุณไปยังไดเร็กทอรีโมดูล (ระดับแอป) ของแอปของคุณ

  2. หากต้องการเปิดใช้งานผลิตภัณฑ์ Firebase ในแอปของคุณ ให้เพิ่ม ปลั๊กอิน Google-Services ลงในไฟล์ Gradle ของคุณ

    1. ในไฟล์ Gradle ระดับราก (ระดับโครงการ) ( <project>/build.gradle.kts หรือ <project>/build.gradle ) ให้เพิ่มกฎเพื่อรวมปลั๊กอิน Gradle ของบริการ Google ตรวจสอบว่าคุณมีพื้นที่เก็บข้อมูล Maven ของ Google เช่นกัน

      Kotlin

      plugins {
   id("com.android.application") version "7.3.0" apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id("com.google.gms.google-services") version "4.4.0" apply false
}

      Groovy

      plugins {
   id 'com.android.application' version '7.3.0' apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id 'com.google.gms.google-services' version '4.4.0' apply false
}

    2. ในไฟล์ Gradle ของ โมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้ใช้ปลั๊กอิน Gradle ของบริการ Google

      Kotlin

      plugins {
   id("com.android.application")

   // Add the Google services Gradle plugin
   id("com.google.gms.google-services")
   // ...
}

      Groovy

      plugins {
   id 'com.android.application'

   // Add the Google services Gradle plugin
   id 'com.google.gms.google-services'
   // ...
}

ขั้นตอนที่ 2: เพิ่ม Analytics SDK ลงในแอปของคุณ

  1. ใน ไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้เพิ่มการพึ่งพาสำหรับไลบรารี Analytics สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมเวอร์ชันไลบรารี

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.7.0"))

    // 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 เวอร์ชันที่เข้ากันได้เสมอ

    (ทางเลือก) เพิ่มการพึ่งพาไลบรารี Firebase โดยไม่ ใช้ BoM

    หากคุณเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดการขึ้นต่อกัน

    โปรดทราบว่าหากคุณใช้ไลบรารี 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:21.5.0'
}
    กำลังมองหาโมดูลไลบรารีเฉพาะของ 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

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