เพิ่ม Google Analytics สำหรับ Firebase ลงใน Instant App

การติดตามความสำเร็จของแอป ไม่ว่าจะเป็นรุ่น Instant หรือแบบติดตั้ง สำคัญสำหรับ ไลบรารี Analytics หลายไลบรารีสามารถทำงานร่วมกับ Google Play Instant รวมถึง คำตอบเกี่ยวกับผ้า Localytics และ Mixpanel

หากโซลูชันการวิเคราะห์ในปัจจุบันของคุณไม่แสดงอยู่ในรายการ หรือหากคุณพบว่าไม่มีโซลูชันดังกล่าว ใช้งานกับ Google Play Instant ได้ ให้พิจารณาใช้ Google Analytics สำหรับ Firebase เป็น โซลูชันการตรวจวัดระยะไกลของคุณ หน้านี้จะอธิบายวิธีตั้งค่า Google Analytics สำหรับ Firebase ในโปรเจ็กต์ Instant App

การเพิ่ม Google Analytics สำหรับ Firebase ลงในโปรเจ็กต์ Instant App

1. เพิ่ม Firebase SDK ลงในแอปโดยทำตามวิธีการ ตามที่อธิบายไว้ใน คู่มือเริ่มต้นใช้งาน Google Analytics สำหรับ Firebase
2. ใช้ปลั๊กอิน google-services เวอร์ชันล่าสุด
3. วางไฟล์ google-services.json ไว้ในแต่ละโมดูล

4. เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ build.gradle ของแต่ละโมดูล

   ดึงดูด

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }
   

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }
   

เมื่อเพิ่ม Google Analytics สำหรับ Firebase ลงในโปรเจ็กต์ Instant App แล้ว คุณจะทำสิ่งต่อไปนี้ได้ ใช้ API ของ Google Analytics สำหรับ Firebase เช่นที่คุณอาจใช้ในโปรเจ็กต์แอปที่ติดตั้งได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ API ของ Google Analytics สำหรับ Firebase ได้ที่ เวลา เอกสารเริ่มต้นใช้งาน Google Analytics สําหรับ Firebase

การแยกความแตกต่างระหว่างข้อมูลที่ติดตั้งไว้กับ Instant App

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

ข้อมูลโค้ดต่อไปนี้แสดงกิจกรรมที่ได้รับ อินสแตนซ์ Analytics แล้วตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ โปรดสังเกตว่า โค้ดใช้ PackageManagerCompat.isInstantApp() ในonCreate(android.os.Bundle) ในการระบุบริบทของแอป

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

เมื่อตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ app_type แล้ว คุณจะเลือกเหตุการณ์ใน แท็บเหตุการณ์ของคอนโซล Analytics แล้วกรองเหตุการณ์ตามองค์ประกอบ app_type เส้นโครงข้อมูลที่ได้จะบอกจำนวน เหตุการณ์ที่ระบุใน Instant App หรือแอปที่ติดตั้งแล้ว

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

การตีความเหตุการณ์ Analytics

Analytics ช่วยให้คุณติดตาม เมตริกหลายอย่างที่มีค่า ไปยัง Instant App ตารางต่อไปนี้อธิบายเมตริกที่เกี่ยวข้องสำหรับ Instant App รวมถึงชื่อหรือพร็อพเพอร์ตี้ของเหตุการณ์ที่เกี่ยวข้อง Analytics

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับค่าคงที่สำหรับเหตุการณ์ที่คุณรวบรวมได้ Analytics โปรดดู FirebaseAnalytics.Event