เริ่มต้นใช้งาน Google Analytics สําหรับ Android

เลือกแพลตฟอร์ม: iOS+ Android เว็บ Flutter Unity C++


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

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

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

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) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Analytics สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการควบคุมเวอร์ชันของไลบรารี 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.15.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:23.2.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. เริ่มต้นในเมธอด onCreate()

    Kotlin 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

เริ่มบันทึกเหตุการณ์

หลังจากสร้างFirebaseAnalyticsอินสแตนซ์แล้ว คุณจะเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent() ได้

เหตุการณ์บางอย่างแนะนําสําหรับแอปทั้งหมด ส่วนเหตุการณ์อื่นๆ แนะนําสําหรับธุรกิจหรือประเภทธุรกิจที่เฉพาะเจาะจง คุณควรส่งเหตุการณ์ที่แนะนําพร้อมกับพารามิเตอร์ที่กําหนดไว้เพื่อให้รายงานมีรายละเอียดครบถ้วนสมบูรณ์ที่สุด และรับประโยชน์จากฟีเจอร์และการผสานรวมในอนาคตทันทีที่พร้อมให้บริการ ส่วนนี้แสดงการบันทึกเหตุการณ์ที่กำหนดไว้ล่วงหน้า ดูข้อมูลเพิ่มเติมเกี่ยวกับการบันทึกเหตุการณ์ได้ที่บันทึกเหตุการณ์

โค้ดต่อไปนี้จะบันทึกเหตุการณ์ SELECT_CONTENT เมื่อ ผู้ใช้คลิกองค์ประกอบที่เฉพาะเจาะจงในแอป

Kotlin 

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 ซึ่งจะช่วยให้คุณ ยืนยันได้ทันทีว่าระบบกำลังส่งเหตุการณ์

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