了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

ใช้ 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 อีกครั้งได้ทุกเมื่อ
      • ตรวจสอบให้แน่ใจว่าไฟล์ config ไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น (2)

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

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

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

      buildscript {

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
  }

  dependencies {
    // ...

    // Add the following line:
    classpath 'com.google.gms:google-services:4.3.15'  // Google Services plugin
  }
}

allprojects {
  // ...

  repositories {
    // Check that you have the following line (if not, add it):
    google()  // Google's Maven repository
    // ...
  }
}

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

      apply plugin: 'com.android.application'
// Add the following line:
apply plugin: 'com.google.gms.google-services'  // Google Services plugin

android {
  // ...
}

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

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

    Kotlin+KTX

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
}

    เมื่อใช้ 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-ktx:21.3.0'
}

    Java

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:32.1.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.3.0'
}

  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

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