Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

ก่อนจะเริ่ม

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

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

  • หากคุณกำลังใช้โครงการ Firebase ที่มีอยู่ที่ไม่ได้เปิดใช้ Google Analytics ไปที่ Integrations แท็บที่คุณ > การตั้งค่าโครงการเพื่อเปิดใช้งาน

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

เพิ่ม Analytics SDK ในแอปของคุณ

  1. ใช้ Firebase Android BoM ประกาศพึ่งพาสำหรับห้องสมุด Analytics Android ในโมดูลของคุณ (app ระดับ) ไฟล์ Gradle (ปกติ app/build.gradle )

    Java

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

    คอตลิน+KTX

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

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    คอตลิน+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. เริ่มต้นใน 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

คำสั่งนี้แสดงกิจกรรมของคุณใน Logcat ของ Android Studio ช่วยให้คุณตรวจสอบได้ทันทีว่ามีการส่งกิจกรรม

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