Google 致力于为黑人社区推动种族平等。查看具体举措
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

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

    Java

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

    โคตรลิน + KTX

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

  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

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

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