หน้านี้ได้รับการแปลโดย Cloud Translation API

เริ่มต้นใช้งาน 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 ลงในแอปของคุณ

ใน ไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle ) ให้เพิ่มการพึ่งพาสำหรับ Analytics Android ห้องสมุด. เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมเวอร์ชันไลบรารี
Kotlin+KTX
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.3.1"))

    // 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-ktx")
}
```
เมื่อใช้ 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-ktx:21.3.0")
}
```
Java
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.3.1"))

    // 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.3.0")
}
```
ประกาศ com.google.firebase.analytics.FirebaseAnalytics ออบเจ็กต์ที่ด้านบนของกิจกรรมของคุณ:
Kotlin+KTX
```
private lateinit var firebaseAnalytics: FirebaseAnalyticsMainActivity.kt
```
Java
```
private FirebaseAnalytics mFirebaseAnalytics;MainActivity.java
```

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

Kotlin+KTX

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analyticsMainActivity.kt

Java

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

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

หลังจากที่คุณสร้างอินสแตนซ์ 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")
}MainActivity.kt

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);MainActivity.java

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

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

ใช้ DebugView เพื่อยืนยันกิจกรรมของคุณ
สำรวจข้อมูลของคุณใน คอนโซล Firebase
สำรวจคำแนะนำเกี่ยวกับ กิจกรรม และ พร็อพเพอร์ตี้ผู้ใช้
เรียนรู้วิธีส่งออกข้อมูลของคุณไปยัง BigQuery