เพิ่ม 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 และ "ติดตั้งแล้ว" สำหรับแอปที่ติดตั้งแล้ว

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

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

Kotlin

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)
    }
}

Java

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	คำจำกัดความ
การเข้าชม	session_start	เริ่มต้นเซสชันแล้ว กิจกรรมนี้จะได้รับการติดตามโดยอัตโนมัติ
การซื้อที่จับต้องได้	Firebase.Event.ECOMMERCE_PURCHASE	การซื้อที่จับต้องได้ คุณต้องติดตามกิจกรรมนี้อย่างชัดแจ้ง ในโค้ดของคุณ
การซื้อแบบดิจิทัล	in_app_purchase	การซื้อในแอปแบบดิจิทัล กิจกรรมนี้จะได้รับการติดตามโดยอัตโนมัติ
เวลาในแอป	user_engagement	ระยะเวลาที่แอปใช้ในการทํางานเบื้องหน้า กิจกรรมนี้จะได้รับการติดตามโดยอัตโนมัติ
บริบทของ Instant App	app_type	เหตุการณ์ที่เกิดจากการที่แอปทำงานทันทีหรือแบบติดตั้ง บริบท คุณต้องติดตามกิจกรรมนี้อย่างชัดแจ้ง ในโค้ดของคุณ ดูการแยกความแตกต่างระหว่าง ข้อมูลที่ติดตั้งไว้และ Instant App ด้านบน
ผู้เข้าชมที่กลับมา	session_start.count และ app_type	กลุ่มเป้าหมายของผู้ใช้ที่เข้าชม 2 ครั้งขึ้นไป คุณต้องแสดงอย่างชัดแจ้งว่า ติดตามกิจกรรม app_type วันที่ session_start สำหรับคุณแล้ว ดูการแยกความแตกต่าง ระหว่างข้อมูลที่ติดตั้งไว้กับ Instant App ด้านบน

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