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

การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม Google Analytics ลงในแอปของคุณและเริ่มบันทึกเหตุการณ์

Google Analytics รวบรวมข้อมูลการใช้งานและพฤติกรรมสำหรับแอปของคุณ SDK บันทึกข้อมูลหลักสองประเภท:

  • เหตุการณ์: สิ่งที่เกิดขึ้นในแอปของคุณ เช่น การกระทำของผู้ใช้ เหตุการณ์ของระบบ หรือข้อผิดพลาด
  • คุณสมบัติผู้ใช้: คุณสมบัติที่คุณกำหนดเพื่ออธิบายกลุ่มฐานผู้ใช้ของคุณ เช่น การตั้งค่าภาษาหรือที่ตั้งทางภูมิศาสตร์

Analytics จะบันทึก เหตุการณ์ และ คุณสมบัติผู้ใช้ บางอย่างโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มรหัสใดๆ เพื่อเปิดใช้งาน

ก่อนที่คุณจะเริ่ม

หากคุณยังไม่ได้ เพิ่ม Firebase ให้กับโปรเจ็กต์ Android ของคุณ และตรวจสอบให้แน่ใจว่าได้เปิดใช้งาน Google Analytics ในโปรเจ็กต์ Firebase ของคุณแล้ว:

  • หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้งาน Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์

  • หากคุณใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่ได้เปิดใช้งาน Google Analytics ให้ไปที่แท็บ การรวมระบบ ของคุณ > การตั้งค่าโครงการ เพื่อเปิดใช้งาน

เมื่อคุณเปิดใช้งาน Google Analytics ในโปรเจ็กต์ของคุณ แอป Firebase ของคุณจะเชื่อมโยงกับสตรีมข้อมูล Google Analytics

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

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. เริ่มต้นในเมธอด 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 ซึ่งช่วยให้คุณตรวจสอบได้ทันทีว่ามีการส่งกิจกรรมหรือไม่

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