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

เลือกแพลตฟอร์ม iOS+ Android Web 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

เพิ่ม SDK ของ Analytics ลงในแอป

  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:35.0.2"))

    // 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 เวอร์ชันที่เข้ากันได้อยู่เสมอ

    (ทางเลือก)  เพิ่มทรัพยากร Dependency ของไลบรารี Firebase โดยไม่ใช้ BoM

    หากเลือกที่จะไม่ใช้ Firebase BoM คุณต้องระบุเวอร์ชันของไลบรารี Firebase แต่ละเวอร์ชันในบรรทัดทรัพยากร Dependency

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

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